ListStackInstances - Resource Orchestration Service: Central de Documentação do Alibaba Cloud

Consulta os detalhes das instâncias de pilha associadas a um grupo de pilhas especificado em uma região do Alibaba Cloud.

Descrição da operação

Este tópico fornece um exemplo de como consultar as instâncias de pilha no grupo de pilhas MyStackGroup que usa o modo de permissões autogerenciadas na região da China (Hangzhou).

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

ros:ListStackInstances

get

*StackInstance.

acs:ros:{#regionId}:{#accountId}:stackinstance/{#StackGroupName}/{#StackInstanceAccountId}/{#StackInstanceRegionId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região do grupo de pilhas. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
StackGroupName	string	Sim	O nome do grupo de pilhas. O nome deve ser exclusivo dentro de uma região.\nO nome pode ter até 255 caracteres e deve começar com um dígito ou uma letra. Pode conter dígitos, letras, hifens (-) e sublinhados (_).	MyStackGroup
StackInstanceAccountId	string	Não	O ID da conta de execução à qual a pilha pertence.\n\n- No padrão de permissões autogerenciadas, a conta é uma conta do Alibaba Cloud.\n\n- No padrão de permissões gerenciadas por serviço, a conta é uma das contas membro de uma pasta de recursos.\n>Para obter mais informações sobre contas de execução, consulte Visão geral.	156552876021****
StackInstanceRegionId	string	Não	A região à qual a pilha pertence.	cn-beijing
PageSize	integer	Não	Configurações para o número de entradas por página durante a paginação em uma consulta paginada.\n\n- Valores válidos: 1 a 50.\n\n- Valor padrão: 10.	10
PageNumber	integer	Não	Configurações para o número da página durante a paginação em uma consulta paginada.\n\n- Valor inicial: 1.\n\n- Valor padrão: 1.	1

Para obter mais informações sobre parâmetros de solicitação comuns, consulte Parâmetros comuns.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
TotalCount	integer	O número total de instâncias de pilha.	1
RequestId	string	O ID da solicitação.	85DE34BD-7FF9-480F-8C21-556E9DA93ACD
PageSize	integer	Configurações para o número de entradas por página durante a paginação em uma consulta paginada.	1
PageNumber	integer	Configurações para o número da página durante a paginação em uma consulta paginada.	1
StackInstances	array<object>	As instâncias de pilha.
	object
Status	string	O status da instância de pilha.\n\nValores válidos:\n\n- CURRENT: A instância de pilha está atualizada.\n\n- OUTDATED: A instância de pilha não está atualizada em relação ao grupo de pilhas. Isso pode ocorrer devido aos seguintes motivos:\n - A instância de pilha falhou ao ser criada durante a operação CreateStackInstances.\n - A instância de pilha falhou ao ser atualizada ou foi apenas parcialmente atualizada durante a operação UpdateStackInstances ou UpdateStackGroup.\n - A operação de criação ou atualização não foi concluída.	CURRENT
StackGroupId	string	O ID do grupo de pilhas.	fd0ddef9-9540-4b42-a464-94f77835****
StackId	string	O ID da pilha.\n\n>Este parâmetro é retornado apenas quando o status da instância de pilha é CURRENT.	35ad60e3-6a92-42d8-8812-f0700d45****
DriftDetectionTime	string	A hora em que a última detecção de desvio bem-sucedida foi realizada na instância de pilha. A hora é exibida no formato YYYY-MM-DDThh:mm:ss.\n\n>Este parâmetro é retornado apenas quando a detecção de desvio foi realizada no grupo de pilhas.	2020-02-27T07:47:47
StackDriftStatus	string	O status de desvio da instância de pilha após a última detecção de desvio bem-sucedida.\n\nValores válidos:\n\n- DRIFTED: A instância de pilha apresentou desvio.\n\n- NOT_CHECKED: Nenhuma detecção de desvio bem-sucedida foi realizada na instância de pilha.\n\n- IN_SYNC: A instância de pilha está sincronizada.\n\n>Este parâmetro é retornado apenas quando a detecção de desvio foi realizada no grupo de pilhas.	IN_SYNC
StatusReason	string	O motivo do status da instância.\n\n>Este parâmetro é retornado apenas quando o status da instância de pilha é OUTDATED.	User initiated stop
StackGroupName	string	O nome do grupo de pilhas.	MyStackGroup
AccountId	string	O ID da conta de execução à qual a instância de pilha pertence.	156552876021****
RegionId	string	A região à qual a pilha pertence.	cn-beijing
RdFolderId	string	O ID da pasta no diretório de recursos.\n\n>Este parâmetro é retornado apenas para grupos de pilhas que usam o modo de permissões gerenciadas por serviço.	fd-4PvlVLOL8v

Exemplos

Resposta de sucesso

JSON formato

{
  "TotalCount": 1,
  "RequestId": "85DE34BD-7FF9-480F-8C21-556E9DA93ACD",
  "PageSize": 1,
  "PageNumber": 1,
  "StackInstances": [
    {
      "Status": "CURRENT",
      "StackGroupId": "fd0ddef9-9540-4b42-a464-94f77835****",
      "StackId": "35ad60e3-6a92-42d8-8812-f0700d45****",
      "DriftDetectionTime": "2020-02-27T07:47:47",
      "StackDriftStatus": "IN_SYNC",
      "StatusReason": "User initiated stop",
      "StackGroupName": "MyStackGroup",
      "AccountId": "156552876021****",
      "RegionId": "cn-beijing",
      "RdFolderId": "fd-4PvlVLOL8v"
    }
  ]
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.