Udostępnij za pośrednictwem


Job Agents - Create Or Update

Tworzy lub aktualizuje agenta zadań.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
jobAgentName
path True

string

Nazwa agenta zadania do utworzenia lub zaktualizowania.

resourceGroupName
path True

string

Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API Resource Manager platformy Azure lub portalu.

serverName
path True

string

Nazwa serwera.

subscriptionId
path True

string

Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.

api-version
query True

string

Wersja interfejsu API do użycia dla żądania.

Treść żądania

Nazwa Wymagane Typ Opis
location True

string

Lokalizacja zasobu.

properties.databaseId True

string

Identyfikator zasobu bazy danych do przechowywania metadanych zadania.

sku

Sku

Nazwa i warstwa jednostki SKU.

tags

object

Tagi zasobów.

Odpowiedzi

Nazwa Typ Opis
200 OK

JobAgent

Pomyślnie zaktualizowano agenta zadania.

201 Created

JobAgent

Pomyślnie utworzono agenta zadania.

202 Accepted

Zaakceptowano

Other Status Codes

Odpowiedzi na błędy: ***

  • 400 InvalidResourceRequestBody — właściwości zasobu lub zasobu w treści żądania są puste lub nieprawidłowe.

  • 400 MissingSkuName — wymagana jest nazwa jednostki SKU.

  • 400 InvalidDatabaseResourceId — nieprawidłowy identyfikator zasobu bazy danych.

  • 400 NiezgodnośćSubscriptionWithUrl — podana subskrypcja nie jest zgodna z subskrypcją w adresie URL.

  • 400 MismatchingResourceGroupNameWithUrl — podana nazwa grupy zasobów nie jest zgodna z nazwą w adresie URL.

  • 400 NiezgodnośćServerNameWithUrl — podana nazwa serwera nie jest zgodna z nazwą w adresie URL.

  • 400 JobAgentDatabaseEditionUnsupported — cel poziomu usługi określonej bazy danych nie jest obsługiwany do użycia jako baza danych agenta zadań.

  • 400 JobAgentDatabaseSecondary — agent zadania nie może być połączony z bazą danych pomocniczej geograficznie.

  • 400 JobAgentDatabaseAlreadyLinked — określona baza danych jest już połączona z innym agentem zadań.

  • 400 DatabaseDoesNotExist — żądana baza danych nie została znaleziona

  • 400 CannotUseReservedDatabaseName — nie można użyć nazwy zarezerwowanej bazy danych w tej operacji.

  • 400 JobAgentExceededQuota — nie można utworzyć agenta zadania, ponieważ przekroczy limit przydziału.

  • 400 JobAgentAlreadyExists — agent zadań już istnieje na serwerze.

  • 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera

  • 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji.

  • 404 PropertyChangeUnsupported — nie można zmodyfikować właściwości.

  • 404 SubscriptionNotFound — nie znaleziono żądanej subskrypcji.

  • 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje.

  • 409 ServerDisabled — serwer jest wyłączony.

  • 409 OperationCancelled — operacja została anulowana przez użytkownika.

  • 409 OperationInterrupted — nie można ukończyć operacji na zasobie, ponieważ została przerwana przez inną operację na tym samym zasobie.

  • 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 500 OperationTimedOut — upłynął limit czasu operacji i został automatycznie wycofany. Ponów próbę wykonania operacji.

  • 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

Przykłady

Create or update a job agent

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
JobAgent

Agent zadań Azure SQL.

JobAgentState

Stan agenta zadania.

Sku

Jednostka SKU zasobu usługi ARM.

JobAgent

Agent zadań Azure SQL.

Nazwa Typ Opis
id

string

Identyfikator zasobu.

location

string

Lokalizacja zasobu.

name

string

Nazwa zasobu.

properties.databaseId

string

Identyfikator zasobu bazy danych do przechowywania metadanych zadania.

properties.state

JobAgentState

Stan agenta zadania.

sku

Sku

Nazwa i warstwa jednostki SKU.

tags

object

Tagi zasobów.

type

string

Typ zasobu.

JobAgentState

Stan agenta zadania.

Nazwa Typ Opis
Creating

string

Deleting

string

Disabled

string

Ready

string

Updating

string

Sku

Jednostka SKU zasobu usługi ARM.

Nazwa Typ Opis
capacity

integer

Pojemność określonej jednostki SKU.

family

string

Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj.

name

string

Nazwa jednostki SKU, zazwyczaj litera + kod liczbowy, np. P3.

size

string

Rozmiar określonej jednostki SKU

tier

string

Warstwa lub wersja określonej jednostki SKU, np. Podstawowa, Premium.