Job Agents - Create Or Update

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=2017-03-01-preview

Parametri dell'URI

Name In Required Type Description
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

Name Required Type Description
location True
  • string

Percorso della risorsa.

properties.databaseId True
  • string

ID risorsa del database in cui archiviare i metadati del processo.

sku

Nome e livello dello SKU.

tags
  • object

Tag di risorse.

Risposte

Name Type Description
200 OK

Aggiornato correttamente l'agente del processo.

201 Created

È 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 DatabaseDoesNotExist - Il database richiesto non è stato trovato

  • 400 JobAgentExceededQuota - Impossibile creare l'agente di processo perché supera la quota.

  • 400 JobAgentAlreadyExists : l'agente di processo esiste già nel server.

  • 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 CannotUseReservedDatabaseName - Impossibile usare il nome del database riservato in questa operazione.

  • 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato

  • 404 SubscriptionNotFound : la sottoscrizione richiesta non è stata trovata.

  • 404 PropertyChangeUnsupported - Impossibile modificare la proprietà.

Esempio

Create or update a job agent with all properties
Create or update a job agent with minimum properties

Create or update a job agent with all properties

Sample Request

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

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

Sample Response

{
  "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"
  },
  "tags": {
    "octopus": "agent"
  }
}
{
  "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"
  },
  "tags": {
    "octopus": "agent"
  }
}

Create or update a job agent with minimum properties

Sample Request

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

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

Sample Response

{
  "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"
  }
}
{
  "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"
  }
}

Definizioni

JobAgent

Agente di processo Azure SQL.

JobAgentState

Stato dell'agente del processo.

Sku

SKU di risorsa arm.

JobAgent

Agente di processo Azure SQL.

Name Type Description
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

Stato dell'agente del processo.

sku

Nome e livello dello SKU.

tags
  • object

Tag di risorse.

type
  • string

Tipo di risorsa.

JobAgentState

Stato dell'agente del processo.

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

Sku

SKU di risorsa arm.

Name Type Description
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.