Job Agents - Create Or Update

Referentie

Service:: SQL Database

API Version:: 2021-11-01

Hiermee wordt een taakagent gemaakt of bijgewerkt.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/jobAgents/{jobAgentName}?api-version=2021-11-01

URI-parameters

Name	In	Vereist	Type	Description
jobAgentName	path	True	string	De naam van de taakagent die moet worden gemaakt of bijgewerkt.
resourceGroupName	path	True	string	De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
serverName	path	True	string	De naam van de server.
subscriptionId	path	True	string	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
api-version	query	True	string	De API-versie die moet worden gebruikt voor de aanvraag.

Aanvraagbody

Name	Vereist	Type	Description
location	True	string	Resourcelocatie.
properties.databaseId	True	string	Resource-id van de database waarin taakmetagegevens moeten worden opgeslagen.
sku		Sku	De naam en laag van de SKU.
tags		object	Resourcetags.

Antwoorden

Name	Type	Description
200 OK	JobAgent	De taakagent is bijgewerkt.
201 Created	JobAgent	De taakagent is gemaakt.
202 Accepted		Geaccepteerd
Other Status Codes		Foutreacties: *** 400 InvalidResourceRequestBody : de resource of resource-eigenschappen in de aanvraagtekst zijn leeg of ongeldig. 400 MissingSkuName - SKU-naam is vereist. 400 InvalidDatabaseResourceId - Ongeldige databaseresource-id. 400 Komt niet overeenSubscriptionWithUrl: het opgegeven abonnement komt niet overeen met het abonnement in de URL. 400 Komt niet overeenResourceGroupNameWithUrl - De opgegeven naam van de resourcegroep komt niet overeen met de naam in de URL. 400 MismatchingServerNameWithUrl - De opgegeven servernaam komt niet overeen met de naam in de URL. 400 JobAgentDatabaseEditionUnsupported: de serviceniveaudoelstelling van de opgegeven database wordt niet ondersteund voor gebruik als een taakagentdatabase. 400 JobAgentDatabaseSecondary: een taakagent kan niet worden gekoppeld aan een geo-secundaire database. 400 JobAgentDatabaseAlreadyLinked: de opgegeven database is al gekoppeld aan een andere taakagent. 400 DatabaseDoesNotExist - De aangevraagde database is niet gevonden 400 CannotUseReservedDatabaseName : kan de gereserveerde databasenaam niet gebruiken in deze bewerking. 400 JobAgentExceededQuota : kan geen taakagent maken omdat deze het quotum overschrijdt. 400 JobAgentAlreadyExists - De taakagent bestaat al op de server. 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 ServerNotInSubscriptionResourceGroup : de opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement. 404 PropertyChangeUnsupported - Eigenschap kan niet worden gewijzigd. 404 SubscriptionNotFound - Het aangevraagde abonnement is niet gevonden. 404 OperationIdNotFound - De bewerking met id bestaat niet. 409 ServerDisabled - Server is uitgeschakeld. 409 OperationCancelled : de bewerking is geannuleerd door de gebruiker. 409 Bewerking onderbroken: de bewerking op de resource kan niet worden voltooid omdat deze is onderbroken door een andere bewerking op dezelfde resource. 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources. 429 SubscriptionTooManyRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources. 500 OperationTimedOut: er is een time-out opgetreden voor de bewerking en deze is automatisch teruggedraaid. Probeer de bewerking opnieuw uit te voeren. 503 TooManyRequests: aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

Voorbeelden

Create or update a job agent

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1?api-version=2021-11-01

{
  "location": "southeastasia",
  "properties": {
    "databaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/databases/db1"
  }
}


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.JobAgentInner;

/** Samples for JobAgents CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/CreateOrUpdateJobAgent.json
     */
    /**
     * Sample code: Create or update a job agent.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createOrUpdateAJobAgent(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getJobAgents().createOrUpdate("group1", "server1", "agent1",
            new JobAgentInner().withLocation("southeastasia").withDatabaseId(
                "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/databases/db1"),
            Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1",
  "name": "agent1",
  "type": "Microsoft.Sql/servers/jobAgents",
  "location": "southeastasia",
  "sku": {
    "name": "Agent",
    "capacity": 100
  },
  "properties": {
    "databaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/databases/db1"
  }
}

Status code:: 201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1",
  "name": "agent1",
  "type": "Microsoft.Sql/servers/jobAgents",
  "location": "southeastasia",
  "sku": {
    "name": "Agent",
    "capacity": 100
  },
  "properties": {
    "databaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/databases/db1"
  }
}

Status code:: 202

Definities

Name	Description
JobAgent	Een Azure SQL-taakagent.
JobAgentState	De status van de taakagent.
Sku	Een ARM-resource-SKU.

JobAgent

Een Azure SQL-taakagent.

Name	Type	Description
id	string	Resource-id.
location	string	Resourcelocatie.
name	string	Resourcenaam.
properties.databaseId	string	Resource-id van de database waarin taakmetagegevens moeten worden opgeslagen.
properties.state	JobAgentState	De status van de taakagent.
sku	Sku	De naam en laag van de SKU.
tags	object	Resourcetags.
type	string	Resourcetype.

JobAgentState

De status van de taakagent.

Name	Type	Description
Creating	string
Deleting	string
Disabled	string
Ready	string
Updating	string

Sku

Een ARM-resource-SKU.

Name	Type	Description
capacity	integer	Capaciteit van de specifieke SKU.
family	string	Als de service verschillende generaties hardware voor dezelfde SKU heeft, kan die hier worden vastgelegd.
name	string	De naam van de SKU, meestal een letter + cijfercode, bijvoorbeeld P3.
size	string	Grootte van de specifieke SKU
tier	string	De laag of editie van de specifieke SKU, bijvoorbeeld Basic, Premium.

Share via