Job Agents - Create Or Update

Referência

Serviço:: SQL Database

Versão da API:: 2021-11-01

Cria ou atualiza um agente de tarefas.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
jobAgentName	path	True	string	O nome do agente de tarefas a criar ou atualizar.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	O ID da subscrição que identifica uma subscrição do Azure.
api-version	query	True	string	A versão da API a utilizar para o pedido.

Corpo do Pedido

Name	Necessário	Tipo	Description
location	True	string	Localização do recurso.
properties.databaseId	True	string	ID de recurso da base de dados para armazenar metadados de tarefas.
sku		Sku	O nome e a camada do SKU.
tags		object	Etiquetas de recursos.

Respostas

Name	Tipo	Description
200 OK	JobAgent	O agente da tarefa foi atualizado com êxito.
201 Created	JobAgent	Criou com êxito o agente de tarefas.
202 Accepted		Aceite
Other Status Codes		Respostas de Erro: *** 400 InvalidResourceRequestBody – as propriedades do recurso ou recurso no corpo do pedido estão vazias ou são inválidas. 400 MissingSkuName – é necessário o nome do Sku. 400 InvalidDatabaseResourceId – identificador de recurso de base de dados inválido. 400 MismatchingSubscriptionWithUrl – a subscrição fornecida não corresponde à subscrição no Url. 400 MismatchingResourceGroupNameWithUrl – o nome do grupo de recursos fornecido não corresponde ao nome no Url. 400 MismatchingServerNameWithUrl – o nome do servidor fornecido não corresponde ao nome no Url. 400 JobAgentDatabaseEditionUnsupported – o objetivo de nível de serviço da base de dados especificada não é suportado para utilização como base de dados de agente de tarefas. 400 JobAgentDatabaseSecondary – um agente de trabalho não pode ser ligado a uma base de dados georreplicada secundária. 400 JobAgentDatabaseAlreadyLinked - A base de dados especificada já está ligada a outro agente de tarefas. 400 DatabaseDoesNotExist – A base de dados pedida não foi encontrada 400 CannotUseReservedDatabaseName – Não é possível utilizar o nome da base de dados reservada nesta operação. 400 JobAgentExceededQuota - Não foi possível criar o agente de tarefas porque excederia a quota. 400 JobAgentAlreadyExists – o agente de tarefas já existe no servidor. 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e subscrição especificados. 404 PropertyChangeUnsupported - Não é possível modificar a propriedade. 404 SubscriptionNotFound - A subscrição pedida não foi encontrada. 404 OperationIdNotFound - A operação com o ID não existe. 409 ServerDisabled - O servidor está desativado. 409 OperationCancelled - A operação foi cancelada pelo utilizador. 409 OperationInterrupted - Não foi possível concluir a operação no recurso porque foi interrompida por outra operação no mesmo recurso. 429 SubscriptionTooManyCreateUpdateRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operação. 503 TooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados 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.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"),
            com.azure.core.util.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

Resposta da amostra

Código de estado:: 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"
  }
}

Código de estado:: 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"
  }
}

Código de estado:: 202

Definições

Name	Description
JobAgent	Um agente de trabalho SQL do Azure.
JobAgentState	O estado do agente de tarefas.
Sku	Um SKU de Recurso do ARM.

JobAgent

Um agente de trabalho SQL do Azure.

Name	Tipo	Description
id	string	ID do Recurso.
location	string	Localização do recurso.
name	string	Nome do recurso.
properties.databaseId	string	ID de recurso da base de dados para armazenar metadados de tarefas.
properties.state	JobAgentState	O estado do agente de tarefas.
sku	Sku	O nome e a camada do SKU.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso.

JobAgentState

O estado do agente de tarefas.

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

Sku

Um SKU de Recurso do ARM.

Name	Tipo	Description
capacity	integer	Capacidade do SKU específico.
family	string	Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode 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	O escalão ou edição do SKU específico, por exemplo, Básico, Premium.

Partilhar via