Job Target Groups - List By Agent

Serviço:

SQL Database

Versão da API:

2021-11-01

Obtém todos os grupos-alvo em um agente.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
jobAgentName	path	True	string	O nome do agente de trabalho.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Você pode obter esse valor da API do Azure Resource Manager ou 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

Name	Tipo	Description
200 OK	JobTargetGroupListResult	Recuperada com êxito a lista de grupos-alvo.
Other Status Codes		Respostas de erro: *** 404 JobAgentNotFound - O agente de trabalho especificado não existe no servidor lógico especificado. 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.

Exemplos

Get all target groups in an agent.

Pedido de amostra

HTTP

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

Java

/**
 * Samples for JobTargetGroups ListByAgent.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ListJobTargetGroups.json
     */
    /**
     * Sample code: Get all target groups in an agent.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAllTargetGroupsInAnAgent(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getJobTargetGroups().listByAgent("group1", "server1", "agent1",
            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

{
  "value": [
    {
      "properties": {
        "members": [
          {
            "membershipType": "Exclude",
            "type": "SqlDatabase",
            "serverName": "server1",
            "databaseName": "database1"
          },
          {
            "membershipType": "Include",
            "type": "SqlServer",
            "serverName": "server1",
            "refreshCredential": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/credentials/testCredential"
          },
          {
            "membershipType": "Include",
            "type": "SqlElasticPool",
            "serverName": "server2",
            "elasticPoolName": "pool1",
            "refreshCredential": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/credentials/testCredential"
          },
          {
            "membershipType": "Include",
            "type": "SqlShardMap",
            "serverName": "server3",
            "shardMapName": "shardMap1",
            "refreshCredential": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/credentials/testCredential"
          }
        ]
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/targetGroups/targetGroup1",
      "name": "targetGroup1",
      "type": "Microsoft.Sql/servers/jobAgents/targetGroups"
    }
  ]
}

Definições

Name	Description
JobTarget	Um destino de trabalho, por exemplo, um banco de dados específico ou um contêiner de bancos de dados que é avaliado durante a execução do trabalho.
JobTargetGroup	Um grupo de metas de emprego.
JobTargetGroupListResult	Uma lista de grupos-alvo.
JobTargetGroupMembershipType	Se o alvo está incluído ou excluído do grupo.
JobTargetType	O tipo de destino.

JobTarget

Object

Um destino de trabalho, por exemplo, um banco de dados específico ou um contêiner de bancos de dados que é avaliado durante a execução do trabalho.

Name	Tipo	Default value	Description
databaseName	string		O nome do banco de dados de destino.
elasticPoolName	string		O nome do pool elástico de destino.
membershipType	JobTargetGroupMembershipType	Include	Se o alvo está incluído ou excluído do grupo.
refreshCredential	string		A ID de recurso da credencial usada durante a execução do trabalho para se conectar ao destino e determinar a lista de bancos de dados dentro do destino.
serverName	string		O nome do servidor de destino.
shardMapName	string		O mapa de estilhaços de destino.
type	JobTargetType		O tipo de destino.

JobTargetGroup

Object

Um grupo de metas de emprego.

Name	Tipo	Description
id	string	ID do recurso.
name	string	Nome do recurso.
properties.members	JobTarget[]	Membros do grupo-alvo.
type	string	Tipo de recurso.

JobTargetGroupListResult

Object

Uma lista de grupos-alvo.

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

JobTargetGroupMembershipType

Enumeração

Se o alvo está incluído ou excluído do grupo.

Valor	Description
Exclude
Include

JobTargetType

Enumeração

O tipo de destino.

Valor	Description
SqlDatabase
SqlElasticPool
SqlServer
SqlShardMap
TargetGroup