GetStackInstance - 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.

Descrição da operação

Este tópico fornece um exemplo para consultar os detalhes das instâncias de pilha que pertencem ao grupo de pilhas MyStackGroup na região China (Pequim) e à conta 151266687691**** da Alibaba Cloud. O grupo de pilhas usa o modo de permissões autogerenciadas e reside na região 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:GetStackInstance

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. O 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	Sim	O ID da conta de execução à qual a pilha pertence. No padrão de permissões autogerenciadas, esta conta é uma conta da Alibaba Cloud. No padrão de permissões gerenciadas por serviço, esta conta é uma das contas membro de uma pasta de recursos. Nota Para mais informações sobre contas de execução, consulte Visão geral.	151266687691****
StackInstanceRegionId	string	Sim	A região à qual a pilha pertence.	cn-beijing
OutputOption	string	Não	Especifica se deve retornar o parâmetro Outputs (a lista de saídas da pilha). Valores válidos: Enabled: retorna o parâmetro Outputs. Disabled: não retorna o parâmetro Outputs. Este é o valor padrão. Nota O cálculo de Outputs consome tempo. Se você não precisar das informações de Outputs, defina OutputOption como Disabled para melhorar a velocidade de resposta da API.	Disabled

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

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	B8A6B693-82C8-419D-8796-DE99EC33CFF9
StackInstance	object	Os detalhes da instância de pilha.
Status	string	O status da instância de pilha. Valores válidos: CURRENT: A instância de pilha está atualizada. OUTDATED: A instância de pilha não está atualizada em relação ao grupo de pilhas. Possíveis causas: A instância de pilha falhou ao ser criada durante a operação CreateStackInstances. A instância de pilha falhou ao ser atualizada ou foi apenas parcialmente atualizada durante a operação UpdateStackInstances ou UpdateStackGroup. 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. Nota 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 no grupo de pilhas. A hora é exibida no formato AAAA-MM-DDThh:mm:ss. Nota Este parâmetro é retornado apenas se a detecção de desvio tiver sido realizada no grupo de pilhas.	2020-02-27T07:47:47
StackDriftStatus	string	O status de desvio da instância de pilha com base na última detecção de desvio bem-sucedida. Valores válidos: DRIFTED: A instância de pilha sofreu desvio. NOT_CHECKED: Nenhuma detecção de desvio bem-sucedida foi realizada na instância de pilha. IN_SYNC: A instância de pilha está sincronizada. Nota Este parâmetro é retornado apenas se a detecção de desvio tiver sido realizada no grupo de pilhas.	IN_SYNC
StatusReason	string	O motivo do status da instância. Nota Este parâmetro é retornado apenas quando o status da instância de pilha é OUTDATED.	User initiated stop
ParameterOverrides	array<object>	A lista de substituições de parâmetros.
	object
ParameterKey	string	A chave da substituição de parâmetro.	Amount
ParameterValue	string	O valor da substituição de parâmetro.	1
StackGroupName	string	O nome do grupo de pilhas.	MyStackGroup
AccountId	string	O ID da conta de execução à qual a pilha pertence.	151266687691****
RegionId	string	A região à qual a pilha pertence.	cn-beijing
RdFolderId	string	O ID da pasta no diretório de recursos. Nota Este parâmetro é retornado apenas para grupos de pilhas que usam o modo de permissões gerenciadas por serviço.	fd-4PvlVLOL8v
Outputs	array<object>	A lista de saídas da pilha. Nota Este parâmetro é retornado quando OutputOption é definido como Enabled.
	object	A lista de saídas da pilha. Nota Este parâmetro é retornado quando OutputOption é definido como Enabled.	[{'OutputKey': 'rds_connection_string', 'OutputValue': 'rm-gw868n4lzy0i7kzx3.mysql.germany.rds.aliyuncs.com'}]

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "B8A6B693-82C8-419D-8796-DE99EC33CFF9",
  "StackInstance": {
    "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",
    "ParameterOverrides": [
      {
        "ParameterKey": "Amount",
        "ParameterValue": "1"
      }
    ],
    "StackGroupName": "MyStackGroup",
    "AccountId": "151266687691****",
    "RegionId": "cn-beijing",
    "RdFolderId": "fd-4PvlVLOL8v",
    "Outputs": [
      {
        "test": "test",
        "test2": 1
      }
    ]
  }
}

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.