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

Consulta os detalhes de um conjunto de alterações especificado, incluindo opcionalmente os detalhes do modelo associado.

Descrição da operação

Este tópico demonstra como consultar um conjunto de alterações com o ID 4c11658d-bd47-4dd0-ba64-727edc62**** 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:GetChangeSet

get

*stack

acs:ros:{#regionId}:{#accountId}:stack/{#stackId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ShowTemplate	boolean	Não	Especifica se o modelo deve ser retornado. Valores válidos: true: O modelo é retornado. false: O modelo não é retornado. Valor padrão: false.	false
RegionId	string	Sim	O ID da região à qual o conjunto de alterações pertence. Você pode chamar a operação DescribeRegions para consultar a lista mais recente de regiões da Alibaba Cloud. DescribeRegions	cn-hangzhou
ChangeSetId	string	Sim	O ID do conjunto de alterações.	4c11658d-bd47-4dd0-ba64-727edc62****

Para obter detalhes sobre os parâmetros de solicitação comuns, consulte Parâmetros comuns.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os dados retornados.
Status	string	O status do conjunto de alterações.	CREATE_COMPLETE
Changes	array<object>	As alterações no conjunto de alterações.	See examples.
	object	Uma alteração no conjunto de alterações. Para mais informações, consulte estrutura de dados do conjunto de alterações. estrutura de dados do conjunto de alterações	See examples.
Description	string	A descrição do conjunto de alterações.	It is a demo.
Parameters	array<object>	Os parâmetros da pilha.
	object	Um parâmetro da pilha.
ParameterKey	string	O nome do parâmetro.	ALIYUN::Region
ParameterValue	string	O valor do parâmetro.	cn-hangzhou
RequestId	string	O ID da solicitação.	3766EE04-76DD-50F9-9C23-3AF136CD5708
StatusReason	string	O motivo do status anormal do conjunto de alterações.	too many changes.
CreateTime	string	A hora em que o conjunto de alterações foi criado. A hora está em UTC e usa o formato YYYY-MM-DDThh:mm:ss.	2021-12-01T02:20:56
TemplateBody	string	O corpo do modelo do conjunto de alterações. Nota Este parâmetro é retornado apenas quando ShowTemplate é definido como true.	{"ROSTemplateFormatVersion": "2015-09-01"}
ChangeSetName	string	O nome do conjunto de alterações.	ChangeSet_template
ChangeSetId	string	O ID do conjunto de alterações.	4c11658d-bd47-4dd0-ba64-727edc62****
ExecutionStatus	string	O status de execução do conjunto de alterações.	AVAILABLE
ChangeSetType	string	O tipo do conjunto de alterações.	UPDATE
RegionId	string	O ID da região.	cn-hangzhou
DisableRollback	boolean	Indica se a reversão deve ser desativada quando a criação ou atualização de uma pilha falhar.	false
StackName	string	O nome da pilha à qual o conjunto de alterações pertence.	stack_2021-10-13
TimeoutInMinutes	integer	O período de tempo limite para criar ou atualizar a pilha.	60
StackId	string	O ID da pilha à qual o conjunto de alterações pertence.	a486fc19-ebb7-4ce9-a70b-554a7c3d****
Log	object	Logs do conjunto de alterações.
TerraformLogs	array<object>	Os logs de saída do Terraform. Este parâmetro é retornado apenas para conjuntos de alterações de pilhas baseadas em Terraform. Nota Este parâmetro não está disponível enquanto um conjunto de alterações está sendo criado, pois os logs são gerados apenas após a conclusão da criação.
	object	Uma entrada de log do Terraform.
Command	string	The name of the Terraform command that was executed. Valid values: apply plan destroy version For more information about the commands, see Command.	apply
Stream	string	The output stream. Valid values: `stdout`: standard output `stderr`: standard error	stdout
Content	string	The content that the command wrote to the specified stream.	Apply complete! Resources: 42 added, 0 changed, 0 destroyed.
Tags	array<object>	As tags do conjunto de alterações.
	object	Uma tag aplicada ao conjunto de alterações.
Key	string	A chave da tag.	usage
Value	string	O valor da tag.	test
ResourceGroupId	string	O ID do grupo de recursos. Para mais informações sobre grupos de recursos, consulte O que é um grupo de recursos?. O que é um grupo de recursos?	rg-acfmxazb4ph6aiy****

Exemplos

Resposta de sucesso

JSON formato

{
  "Status": "CREATE_COMPLETE",
  "Changes": [
    {
      "test": "test",
      "test2": 1
    }
  ],
  "Description": "It is a demo.",
  "Parameters": [
    {
      "ParameterKey": "ALIYUN::Region",
      "ParameterValue": "cn-hangzhou"
    }
  ],
  "RequestId": "3766EE04-76DD-50F9-9C23-3AF136CD5708",
  "StatusReason": "too many changes.",
  "CreateTime": "2021-12-01T02:20:56",
  "TemplateBody": "{\"ROSTemplateFormatVersion\": \"2015-09-01\"}",
  "ChangeSetName": "ChangeSet_template",
  "ChangeSetId": "4c11658d-bd47-4dd0-ba64-727edc62****",
  "ExecutionStatus": "AVAILABLE",
  "ChangeSetType": "UPDATE",
  "RegionId": "cn-hangzhou",
  "DisableRollback": false,
  "StackName": "stack_2021-10-13",
  "TimeoutInMinutes": 60,
  "StackId": "a486fc19-ebb7-4ce9-a70b-554a7c3d****",
  "Log": {
    "TerraformLogs": [
      {
        "Command": "apply",
        "Stream": "stdout",
        "Content": "Apply complete! Resources: 42 added, 0 changed, 0 destroyed."
      }
    ]
  },
  "Tags": [
    {
      "Key": "usage",
      "Value": "test"
    }
  ],
  "ResourceGroupId": "rg-acfmxazb4ph6aiy****"
}

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.