DescribeDeploymentSets - Elastic Compute Service: Central de Documentação do Alibaba Cloud

Consulta os detalhes de um ou mais conjuntos de implantação.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ecs:DescribeDeploymentSets

get

*DeploymentSet.

acs:ecs:{#regionId}:{#accountId}:deploymentset/*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região do conjunto de implantação. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
PageNumber	integer	Não	O número da página da lista de conjuntos de implantação. Valor mínimo: 1. Valor padrão: 1.	1
PageSize	integer	Não	O número de entradas por página para a consulta paginada. Valor máximo: 50. Valor padrão: 10.	10
DeploymentSetIds	string	Não	Os IDs dos conjuntos de implantação. O valor pode ser uma matriz JSON que consiste em vários IDs de conjuntos de implantação no formato `["ds-xxxxxxxxx", "ds-yyyyyyyyy", … "ds-zzzzzzzzz"]`. Há suporte para no máximo 100 IDs. Separe vários IDs com vírgulas (,).	["ds-bp67acfmxazb4ph**", "ds-bp67acfmxazb4pi", … "ds-bp67acfmxazb4pj**"]
NetworkType	string	Não	Nota Este parâmetro foi descontinuado.	null
Strategy	string	Não	A estratégia de implantação. Valores válidos: Availability: estratégia de alta disponibilidade. AvailabilityGroup: estratégia de grupo de alta disponibilidade. LowLatency: estratégia de baixa latência de rede.	Availability
DeploymentSetName	string	Não	O nome do conjunto de implantação. O nome deve ter de 2 a 128 caracteres e pode conter caracteres categorizados como letras no Unicode, incluindo letras do alfabeto inglês, caracteres chineses e dígitos. O nome também pode conter dois-pontos (:), sublinhados (_), pontos (.) ou hifens (-).	testDeploymentSetName
Granularity	string	Não	Nota Este parâmetro foi descontinuado.	null
Domain	string	Não	Nota Este parâmetro foi descontinuado.	null
Type	string	Não	O tipo de implantação. Valores válidos: host: máquina física sw: vSwitch rack: rack Valor padrão: host.	host

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
PageSize	integer	O número de entradas por página.	1
PageNumber	integer	O número da página da lista de conjuntos de implantação.	1
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
TotalCount	integer	O número total de conjuntos de implantação consultados.	5
RegionId	string	O ID da região do conjunto de implantação.	cn-hangzhou
DeploymentSets	object
DeploymentSet	array<object>	Os detalhes dos conjuntos de implantação. O valor é uma matriz que consiste em objetos DeploymentSet.
	array<object>
CreationTime	string	A hora em que o conjunto de implantação foi criado. A hora é exibida no formato ISO 8601 em UTC.	2021-12-07T06:01:46Z
Strategy	string	A estratégia de implantação.	Availability
DeploymentSetId	string	O ID do conjunto de implantação.	ds-bp67acfmxazb4ph****
AccountId	integer	O ID da conta Alibaba Cloud.	1732*******734
DeploymentStrategy	string	A estratégia de implantação. Este parâmetro de resposta corresponde ao valor do parâmetro de solicitação `Strategy`.	Availability
DeploymentSetDescription	string	A descrição do conjunto de implantação.	testDeploymentSetDescription
Domain	string	O domínio de implantação.	default
GroupCount	integer	O número de grupos no conjunto de implantação. Nota Este parâmetro de resposta tem efeito apenas quando a estratégia do conjunto de implantação é a estratégia de grupo de alta disponibilidade (AvailabilityGroup).	3
Granularity	string	A granularidade da implantação.	host
DeploymentSetName	string	O nome do conjunto de implantação.	testDeploymentSetName
InstanceAmount	integer	O número de instâncias no conjunto de implantação.	3
InstanceIds	object
InstanceId	array	Os IDs das instâncias no conjunto de implantação.
	string	O ID da instância.	i-bp67acfmxazb4ph****
Capacities	object
Capacity	array<object>	As informações de capacidade do conjunto de implantação no nível da zona. O valor é uma matriz que consiste em objetos Capacity. Este parâmetro é retornado apenas quando o conjunto de implantação contém instâncias ECS existentes.
	object
ZoneId	string	O ID da zona. Apenas os IDs das zonas das instâncias ECS existentes no conjunto de implantação são retornados.	cn-hangzhou-i
UsedAmount	integer	O número de instâncias ECS no conjunto de implantação que pertencem à zona.	2
AvailableAmount	integer	O número de instâncias ECS que podem ser adicionadas ao conjunto de implantação na zona.	18
Type	string	O tipo de implantação.	host
Affinity	integer	O nível de afinidade do conjunto de implantação.	3

Exemplos

Resposta de sucesso

JSON formato

{
  "PageSize": 1,
  "PageNumber": 1,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "TotalCount": 5,
  "RegionId": "cn-hangzhou",
  "DeploymentSets": {
    "DeploymentSet": [
      {
        "CreationTime": "2021-12-07T06:01:46Z",
        "Strategy": "Availability",
        "DeploymentSetId": "ds-bp67acfmxazb4ph****",
        "AccountId": 0,
        "DeploymentStrategy": "Availability",
        "DeploymentSetDescription": "testDeploymentSetDescription",
        "Domain": "default",
        "GroupCount": 3,
        "Granularity": "host",
        "DeploymentSetName": "testDeploymentSetName",
        "InstanceAmount": 3,
        "InstanceIds": {
          "InstanceId": [
            "i-bp67acfmxazb4ph****"
          ]
        },
        "Capacities": {
          "Capacity": [
            {
              "ZoneId": "cn-hangzhou-i",
              "UsedAmount": 2,
              "AvailableAmount": 18
            }
          ]
        },
        "Type": "host",
        "Affinity": 3
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
403	InvalidDeploymentSetIds.TooManyInput	The parameter DeploymentSets size should less than 100.	O número de DeploymentSets especificados excede 100.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.