Job Agents - Create Or Update

Referência

Service:: SQL Database

API Version:: 2021-11-01

Cria ou atualiza um agente de trabalho.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
jobAgentName	path	True	string	O nome do agente de trabalho a ser criado ou atualizado.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	A ID de assinatura que identifica uma assinatura do Azure.
api-version	query	True	string	A versão da API a ser usada para a solicitação.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
location	True	string	Local do recurso.
properties.databaseId	True	string	ID do recurso do banco de dados no qual armazenar metadados de trabalho.
sku		Sku	O nome e a camada do SKU.
tags		object	Marcas de recurso.

Respostas

Nome	Tipo	Description
200 OK	JobAgent	Atualizado com êxito o agente de trabalho.
201 Created	JobAgent	O agente de trabalho foi criado com êxito.
202 Accepted		Aceito
Other Status Codes		Respostas de erro: *** 400 InvalidResourceRequestBody - O recurso ou as propriedades do recurso no corpo da solicitação são vazios ou inválidos. 400 MissingSkuName – O nome do SKU é necessário. 400 InvalidDatabaseResourceId – Identificador de recurso de banco de dados inválido. 400 MismatchingSubscriptionWithUrl – A assinatura fornecida não correspondeu à assinatura na URL. 400 MismatchingResourceGroupNameWithUrl - O nome do grupo de recursos fornecido não correspondeu ao nome na URL. 400 MismatchingServerNameWithUrl – O nome do servidor fornecido não correspondeu ao nome na URL. 400 JobAgentDatabaseEditionUnsupported – O objetivo de nível de serviço do banco de dados especificado não tem suporte para uso como um banco de dados do agente de trabalho. 400 JobAgentDatabaseSecondary – Um agente de trabalho não pode ser vinculado a um banco de dados geográfico secundário. 400 JobAgentDatabaseAlreadyLinked – O banco de dados especificado já está vinculado a outro agente de trabalho. 400 DatabaseDoesNotExist - O banco de dados solicitado não foi encontrado 400 CannotUseReservedDatabaseName – Não é possível usar o nome do banco de dados reservado nesta operação. 400 JobAgentExceededQuota – não foi possível criar um agente de trabalho porque ele excederia a cota. 400 JobAgentAlreadyExists – o agente de trabalho já existe no servidor. 404 SubscriptionDoesNotHaveServer – O servidor solicitado não foi encontrado 404 ServerNotInSubscriptionResourceGroup – O servidor especificado não existe no grupo de recursos e na assinatura especificados. 404 PropertyChangeUnsupported – A propriedade não pode ser modificada. 404 SubscriptionNotFound - A assinatura solicitada não foi encontrada. 404 OperationIdNotFound – A operação com id não existe. 409 Servidor Desabilitado – o servidor está desabilitado. 409 OperationCancelled – A operação foi cancelada pelo usuário. 409 OperationInterrupted – A operação no recurso não pôde ser concluída porque foi interrompida por outra operação no mesmo recurso. 429 SubscriptionTooManyCreateUpdateRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis. 429 SubscriptionTooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis. 500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Tente executar a operação novamente. 503 TooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

Exemplos

Create or update a job agent

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


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.JobAgentInner;

/** Samples for JobAgents CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/CreateOrUpdateJobAgent.json
     */
    /**
     * Sample code: Create or update a job agent.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createOrUpdateAJobAgent(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getJobAgents().createOrUpdate("group1", "server1", "agent1",
            new JobAgentInner().withLocation("southeastasia").withDatabaseId(
                "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/databases/db1"),
            Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

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

Status code:: 201

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

Status code:: 202

Definições

Nome	Description
JobAgent	Um agente de trabalho SQL do Azure.
JobAgentState	O estado do agente de trabalho.
Sku	Um SKU de recurso do ARM.

JobAgent

Um agente de trabalho SQL do Azure.

Nome	Tipo	Description
id	string	ID do recurso.
location	string	Local do recurso.
name	string	Nome do recurso.
properties.databaseId	string	ID do recurso do banco de dados no qual armazenar metadados de trabalho.
properties.state	JobAgentState	O estado do agente de trabalho.
sku	Sku	O nome e a camada do SKU.
tags	object	Marcas de recurso.
type	string	Tipo de recurso.

JobAgentState

O estado do agente de trabalho.

Nome	Tipo	Description
Creating	string
Deleting	string
Disabled	string
Ready	string
Updating	string

Sku

Um SKU de recurso do ARM.

Nome	Tipo	Description
capacity	integer	Capacidade do SKU específico.
family	string	Se o serviço tiver diferentes gerações de hardware, para a mesma SKU, isso poderá ser capturado aqui.
name	string	O nome do SKU, normalmente, uma letra + Código de número, por exemplo, P3.
size	string	Tamanho do SKU específico
tier	string	A camada ou edição do SKU específico, por exemplo, Básico, Premium.

Share via