Freigeben über


Job Agents - Update

Aktualisiert einen Auftragsagenten.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
jobAgentName
path True

string

Der Name des zu aktualisierenden Auftragsagenten.

resourceGroupName
path True

string

Der Name der Ressourcengruppe, die die Ressource enthält. Sie können diesen Wert aus der Azure Resource Manager-API oder dem Portal abrufen.

serverName
path True

string

Der Name des Servers.

subscriptionId
path True

string

Die Abonnement-ID, die ein Azure-Abonnement identifiziert.

api-version
query True

string

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

Anforderungstext

Name Typ Beschreibung
tags

object

Ressourcentags.

Antworten

Name Typ Beschreibung
200 OK

JobAgent

Der Auftragsagent wurde erfolgreich aktualisiert.

202 Accepted

Angenommen

Other Status Codes

Fehlerantworten: ***

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

  • 404 SubscriptionDoesNotHaveServer – Der angeforderte Server wurde nicht gefunden.

  • 404 ServerNotInSubscriptionResourceGroup – Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden.

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

  • 404 JobAgentNotFound – Der angegebene Auftrags-Agent ist nicht auf dem angegebenen logischen Server vorhanden.

  • 404 OperationIdNotFound – Der Vorgang mit der ID ist nicht vorhanden.

  • 409 ServerDisabled – Server ist deaktiviert.

  • 409 OperationCancelled – Der Vorgang wurde vom Benutzer abgebrochen.

  • 409 OperationInterrupted – Der Vorgang für die Ressource konnte nicht abgeschlossen werden, weil er durch einen anderen Vorgang in derselben Ressource unterbrochen wurde.

  • 429 SubscriptionTooManyCreateUpdateRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.

  • 429 SubscriptionTooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.

  • 500 OperationTimedOut – Timeout des Vorgangs und automatisches Zurücksetzen. Versuchen Sie den Vorgang erneut.

  • 503 TooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.

Beispiele

Update a job agent's tags.

Beispielanforderung

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

{
  "tags": {
    "mytag1": "myvalue1"
  }
}

Beispiel für eine Antwort

{
  "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",
  "properties": {
    "databaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/databases/db1"
  },
  "tags": {
    "mytag1": "myvalue1"
  }
}

Definitionen

Name Beschreibung
JobAgent

Ein Azure SQL-Auftrags-Agent.

JobAgentState

Der Status des Auftragsagenten.

JobAgentUpdate

Ein Update für einen Azure SQL-Auftrags-Agent.

Sku

Eine ARM-Ressourcen-SKU.

JobAgent

Ein Azure SQL-Auftrags-Agent.

Name Typ Beschreibung
id

string

Ressourcen-ID.

location

string

Ressourcenspeicherort.

name

string

Ressourcenname.

properties.databaseId

string (arm-id)

Ressourcen-ID der Datenbank zum Speichern von Auftragsmetadaten

properties.state

JobAgentState

Der Status des Auftragsagenten.

sku

Sku

Der Name und die Ebene der SKU.

tags

object

Ressourcentags.

type

string

Ressourcentyp.

JobAgentState

Der Status des Auftragsagenten.

Wert Beschreibung
Creating
Deleting
Disabled
Ready
Updating

JobAgentUpdate

Ein Update für einen Azure SQL-Auftrags-Agent.

Name Typ Beschreibung
tags

object

Ressourcentags.

Sku

Eine ARM-Ressourcen-SKU.

Name Typ Beschreibung
capacity

integer (int32)

Kapazität der jeweiligen SKU.

family

string

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

name

string

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

size

string

Größe der jeweiligen SKU

tier

string

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