Job Agents - Create Or Update

Erstellt oder aktualisiert einen Auftragsagenten.

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

URI-Parameter

Name In Required Type Description
jobAgentName
path True
  • string

Der Name des Auftragsmitarbeiters, der erstellt oder aktualisiert werden soll.

resourceGroupName
path True
  • string

Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.

serverName
path True
  • string

Name des Servers

subscriptionId
path True
  • string

Abonnement-ID für ein Azure-Abonnement.

api-version
query True
  • string

API-Version, die für die Anforderung verwendet werden soll.

Anforderungstext

Name Required Type Description
location True
  • string

Ressourcenspeicherort

properties.databaseId True
  • string

Ressourcen-ID der Datenbank zum Speichern von Auftragsmetadaten

sku

Der Name und die Ebene der SKU.

tags
  • object

Ressourcentags.

Antworten

Name Type Description
200 OK

Der Auftragsagent wurde erfolgreich aktualisiert.

201 Created

Der Auftragsagent wurde erfolgreich erstellt.

202 Accepted

Akzeptiert

Other Status Codes

Fehlerantworten: ***

  • 400 InvalidResourceRequestBody – Die Ressourcen- oder Ressourceneigenschaften im Anforderungstext sind leer oder ungültig.

  • 400 MissingSkuName – Sku-Name ist erforderlich.

  • 400 InvalidDatabaseResourceId – Ungültiger Datenbankressourcenbezeichner.

  • 400 MismatchingSubscriptionWithUrl – Das bereitgestellte Abonnement stimmte nicht mit dem Abonnement in der URL überein.

  • 400 MismatchingResourceGroupNameWithUrl – Der angegebene Ressourcengruppenname stimmt nicht mit dem Namen in der URL überein.

  • 400 MismatchingServerNameWithUrl – Der angegebene Servername stimmt nicht mit dem Namen in der URL überein.

  • 400 DatabaseDoesNotExist – Die angeforderte Datenbank wurde nicht gefunden.

  • 400 JobAgentExceededQuota – Job-Agent konnte nicht erstellt werden, da es das Kontingent überschreitet.

  • 400 JobAgentAlreadyExists – Der Auftrags-Agent ist bereits auf dem Server vorhanden.

  • 400 JobAgentDatabaseEditionUnsupported – Das Ziel der Dienstebene der angegebenen Datenbank wird für die Verwendung als Auftrags-Agent-Datenbank nicht unterstützt.

  • 400 JobAgentDatabaseSecondary – Ein Auftragsagent kann nicht mit einer geo-sekundären Datenbank verknüpft werden.

  • 400 JobAgentDatabaseAlreadyLinked – Die angegebene Datenbank ist bereits mit einem anderen Auftragsagent verknüpft.

  • 400 CannotUseReservedDatabaseName – Der reservierte Datenbankname kann in diesem Vorgang nicht verwendet werden.

  • 404 SubscriptionDoesNotHaveServer – Der angeforderte Server wurde nicht gefunden.

  • 404 SubscriptionNotFound – Das angeforderte Abonnement wurde nicht gefunden.

  • 404 PropertyChangeUnsupported – Eigenschaft kann nicht geändert werden.

Beispiele

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

Definitionen

JobAgent

Ein Azure SQL Job-Agent.

JobAgentState

Der Status des Auftragsmitarbeiters.

Sku

Eine ARM-Ressourcen-SKU.

JobAgent

Ein Azure SQL Job-Agent.

Name Type Description
id
  • string

Ressourcen-ID

location
  • string

Ressourcenspeicherort

name
  • string

Name der Ressource.

properties.databaseId
  • string

Ressourcen-ID der Datenbank zum Speichern von Auftragsmetadaten

properties.state

Der Status des Auftragsmitarbeiters.

sku

Der Name und die Ebene der SKU.

tags
  • object

Ressourcentags.

type
  • string

Der Ressourcentyp.

JobAgentState

Der Status des Auftragsmitarbeiters.

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

Sku

Eine ARM-Ressourcen-SKU.

Name Type Description
capacity
  • integer

Kapazität der jeweiligen SKU.

family
  • string

Wenn der Dienst über unterschiedliche Hardwaregenerationen verfügt, für dieselbe SKU, kann dies hier erfasst werden.

name
  • string

Der Name der SKU, in der Regel ein Buchstaben + Zahlencode, z. B. P3.

size
  • string

Größe der bestimmten SKU

tier
  • string

Die Ebene oder Edition der jeweiligen SKU, z. B. Basic, Premium.