Job Agents - Create Or Update

Riferimento

Service:: SQL Database

API Version:: 2021-11-01

Crea o aggiorna un agente del processo.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
jobAgentName	path	True	string	Nome dell'agente di processo da creare o aggiornare.
resourceGroupName	path	True	string	Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale.
serverName	path	True	string	Nome del server.
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
api-version	query	True	string	Versione dell'API da usare per la richiesta.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
location	True	string	Percorso della risorsa.
properties.databaseId	True	string	ID risorsa del database in cui archiviare i metadati del processo.
sku		Sku	Nome e livello dello SKU.
tags		object	Tag di risorse.

Risposte

Nome	Tipo	Descrizione
200 OK	JobAgent	Aggiornato correttamente l'agente del processo.
201 Created	JobAgent	È stato creato correttamente l'agente di processo.
202 Accepted		Accettato
Other Status Codes		Risposte agli errori: ** 400 InvalidResourceRequestBody: le proprietà della risorsa o della risorsa nel corpo della richiesta sono vuote o non valide. 400 MissingSkuName : è necessario il nome sku. 400 InvalidDatabaseResourceId - Identificatore di risorsa del database non valido. 400 Mancata corrispondenzaSubscriptionWithUrl: la sottoscrizione specificata non corrispondeva alla sottoscrizione nell'URL. 400 MismatchingResourceGroupNameWithUrl: il nome del gruppo di risorse specificato non corrisponde al nome nell'URL. 400 MismatchingServerNameWithUrl: il nome del server specificato non corrisponde al nome nell'URL. 400 JobAgentDatabaseEditionUnsupported: l'obiettivo del livello di servizio del database specificato non è supportato per l'uso come database dell'agente del processo. 400 JobAgentDatabaseSecondary: non è possibile collegare un agente di processo a un database geo-secondario. 400 JobAgentDatabaseAlreadyLinked: il database specificato è già collegato a un altro agente del processo. 400 DatabaseDoesNotExist - Il database richiesto non è stato trovato 400 CannotUseReservedDatabaseName - Impossibile usare il nome del database riservato in questa operazione. 400 JobAgentExceededQuota - Impossibile creare l'agente di processo perché supera la quota. 400 JobAgentAlreadyExists : l'agente di processo esiste già nel server. 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati. 404 PropertyChangeUnsupported - Impossibile modificare la proprietà. 404 SubscriptionNotFound : la sottoscrizione richiesta non è stata trovata. 404 OperationIdNotFound: l'operazione con ID non esiste. 409 ServerDisabled - Il server è disabilitato. 409 OperationCancelled: l'operazione è stata annullata dall'utente. 409 Operazione interrotta: impossibile completare l'operazione sulla risorsa perché è stata interrotta da un'altra operazione sulla stessa risorsa. 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili. 429 SubscriptionTooManyRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili. 500 OperationTimedOut: l'operazione viene timeout e viene eseguito automaticamente il rollback. Ripetere l'operazione. 503 TooManyRequests : richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

Esempio

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

Definizioni

Nome	Descrizione
JobAgent	Agente di processo Azure SQL.
JobAgentState	Stato dell'agente del processo.
Sku	SKU di risorsa arm.

JobAgent

Agente di processo Azure SQL.

Nome	Tipo	Descrizione
id	string	ID risorsa.
location	string	Percorso della risorsa.
name	string	Nome risorsa.
properties.databaseId	string	ID risorsa del database in cui archiviare i metadati del processo.
properties.state	JobAgentState	Stato dell'agente del processo.
sku	Sku	Nome e livello dello SKU.
tags	object	Tag di risorse.
type	string	Tipo di risorsa.

JobAgentState

Stato dell'agente del processo.

Nome	Tipo	Descrizione
Creating	string
Deleting	string
Disabled	string
Ready	string
Updating	string

Sku

SKU di risorsa arm.

Nome	Tipo	Descrizione
capacity	integer	Capacità dello SKU specifico.
family	string	Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui.
name	string	Il nome dello SKU, in genere, una lettera + Codice Numero, ad esempio P3.
size	string	Dimensioni dello SKU specifico
tier	string	Livello o edizione dello SKU specifico, ad esempio Basic, Premium.