Job Agents - List By Server

Service:

SQL Database

API Version:

2021-11-01

Obtém uma lista de agentes de trabalho em um servidor.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
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.

Respostas

Nome	Tipo	Description
200 OK	JobAgentListResult	Recuperou com êxito a lista de agentes de trabalho.
Other Status Codes		Respostas de erro: *** 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. 409 Servidor Desabilitado – o servidor está desabilitado.

Exemplos

List job agents in a server

Sample Request

HTTP

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

Java

import com.azure.core.util.Context;

/** Samples for JobAgents ListByServer. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ListJobAgentsByServer.json
     */
    /**
     * Sample code: List job agents in a server.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listJobAgentsInAServer(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getJobAgents().listByServer("group1", "server1", 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

{
  "value": [
    {
      "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": 200
      },
      "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/jobAgent2",
      "name": "jobAgent2",
      "type": "Microsoft.Sql/servers/jobAgents",
      "location": "southeastasia",
      "sku": {
        "name": "Agent",
        "capacity": 400
      },
      "properties": {
        "databaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/databases/db12"
      }
    }
  ]
}

Definições

Nome	Description
JobAgent	Um agente de trabalho SQL do Azure.
JobAgentListResult	Uma lista de agentes 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.

JobAgentListResult

Uma lista de agentes de trabalho SQL do Azure.

Nome	Tipo	Description
nextLink	string	Link para recuperar a próxima página de resultados.
value	JobAgent[]	Matriz de resultados.

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.