Job Agents - Create Or Update

Tworzy lub aktualizuje agenta zadania.

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

Parametry identyfikatora URI

Name In Required Type Description
jobAgentName
path True
  • string

Nazwa agenta zadania, który ma zostać utworzony lub zaktualizowany.

resourceGroupName
path True
  • string

Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager 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

Name Required Type Description
location True
  • string

Lokalizacja zasobu.

properties.databaseId True
  • string

Identyfikator zasobu bazy danych do przechowywania metadanych zadania.

sku

Nazwa i warstwa jednostki SKU.

tags
  • object

Tagi zasobów.

Odpowiedzi

Name Type Description
200 OK

Pomyślnie zaktualizowano agenta zadania.

201 Created

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 DatabaseDoesNotExist — żądana baza danych nie została znaleziona

  • 400 JobAgentExceededQuota — nie można utworzyć agenta zadania, ponieważ spowodowałoby to przekroczenie limitu przydziału.

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

  • 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 pomocniczą bazą danych z replikacją geograficzną.

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

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

  • 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera

  • 404 SubscriptionNotFound — nie można odnaleźć żądanej subskrypcji.

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

Przykłady

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

Definicje

JobAgent

Agent zadań Azure SQL.

JobAgentState

Stan agenta zadania.

Sku

Jednostka SKU zasobu usługi ARM.

JobAgent

Agent zadań Azure SQL.

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

Stan agenta zadania.

sku

Nazwa i warstwa jednostki SKU.

tags
  • object

Tagi zasobów.

type
  • string

Typ zasobu.

JobAgentState

Stan agenta zadania.

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

Sku

Jednostka SKU zasobu usługi ARM.

Name Type Description
capacity
  • integer

Pojemność konkretnej 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 numeryczny, np. P3.

size
  • string

Rozmiar konkretnej jednostki SKU

tier
  • string

Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium.