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

Consulta os detalhes dos conjuntos de alterações criados.

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:ListChangeSets

get

*stack

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

Nenhuma

Sintaxe da solicitação

POST /V2/ListChangeSets HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
StackId	string	Sim	O ID da pilha.	4a6c9851-3b0f-4f5f-b4ca-a14bf691****
PageSize	integer	Não	O número de entradas por página na consulta paginada. O valor deve ser um número inteiro. Valores válidos: 1 a 50. Valor padrão: 10.	10
RegionId	string	Sim	O ID da região do conjunto de alterações. 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 alterações. Valor mínimo: 1. Valor padrão: 1.	1
ChangeSetId	string	Não	O ID do conjunto de alterações. Se você não precisar de informações detalhadas sobre o conjunto de alterações, poderá usar este parâmetro em vez de chamar a operação GetChangeSet.	1f6521a4-05af-4975-afe9-bc4b45ad****
Status	array	Não	O status do conjunto de alterações. Valor máximo de N: 5. Valores válidos: CREATE_PENDING CREATE_IN_PROGRESS CREATE_COMPLETE CREATE_FAILED DELETE_FAILED DELETE_COMPLETE.	CREATE_COMPLETE
	string	Não	O status do conjunto de alterações.	CREATE_COMPLETE
ChangeSetName	array	Não	O nome do conjunto de alterações. Valor máximo de N: 5. Você pode usar o caractere curinga asterisco (*) para correspondência aproximada.	MyChangeSet
	string	Não	O nome do conjunto de alterações.	MyChangeSet
ExecutionStatus	array	Não	O status de execução do conjunto de alterações. Valor máximo de N: 5. Valores válidos: UNAVAILABLE AVAILABLE EXECUTE_IN_PROGRESS EXECUTE_COMPLETE EXECUTE_FAILED OBSOLETE.	AVAILABLE
	string	Não	O status de execução do conjunto de alterações.	AVAILABLE

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
TotalCount	integer	O número total de conjuntos de alterações retornados.	1
PageSize	integer	O número de entradas por página na consulta paginada.	10
RequestId	string	O ID da solicitação.	B288A0BE-D927-4888-B0F7-B35EF84B6E6F
PageNumber	integer	O número da página na consulta paginada. O valor é um número inteiro com valor mínimo de 1.	1
ChangeSets	array<object>	Os conjuntos de alterações.
	array<object>
Status	string	O status do conjunto de alterações.	CREATE_COMPLETE
StackId	string	O ID da pilha à qual o conjunto de alterações pertence.	4a6c9851-3b0f-4f5f-b4ca-a14bf691****
ChangeSetName	string	O nome do conjunto de alterações.	MyChangeSet
Description	string	A descrição do conjunto de alterações.	It is a demo.
ChangeSetType	string	O tipo do conjunto de alterações. Valores válidos: CREATE, UPDATE e DELETE.	UPDATE
StatusReason	string	O motivo pelo qual o conjunto de alterações está em seu status atual.	too many changes
CreateTime	string	A hora em que o conjunto de alterações foi criado. A hora é exibida em UTC+0 com base no padrão ISO 8601 sem o sufixo Z. Formato: YYYY-MM-DDThh:mm:ss.	2019-08-01T05:16:31
ChangeSetId	string	O ID do conjunto de alterações.	1f6521a4-05af-4975-afe9-bc4b45ad****
StackName	string	O nome da pilha à qual o conjunto de alterações pertence.	MyStack
ExecutionStatus	string	O status de execução do conjunto de alterações.	AVAILABLE
RegionId	string	O ID da região.	cn-hangzhou
ResourceGroupId	string	O ID do grupo de recursos. Para obter mais informações sobre grupos de recursos, consulte O que é um grupo de recursos?.	rg-acfmxazb4ph6aiy****
Tags	array<object>	As tags do conjunto de alterações.
	object	As tags do conjunto de alterações.
Key	string	The tag key.	usage
Value	string	The tag value.	test

Exemplos

Resposta de sucesso

JSON formato

{
  "TotalCount": 1,
  "PageSize": 10,
  "RequestId": "B288A0BE-D927-4888-B0F7-B35EF84B6E6F",
  "PageNumber": 1,
  "ChangeSets": [
    {
      "Status": "CREATE_COMPLETE",
      "StackId": "4a6c9851-3b0f-4f5f-b4ca-a14bf691****",
      "ChangeSetName": "MyChangeSet",
      "Description": "It is a demo.",
      "ChangeSetType": "UPDATE",
      "StatusReason": "too many changes",
      "CreateTime": "2019-08-01T05:16:31",
      "ChangeSetId": "1f6521a4-05af-4975-afe9-bc4b45ad****",
      "StackName": "MyStack",
      "ExecutionStatus": "AVAILABLE",
      "RegionId": "cn-hangzhou",
      "ResourceGroupId": "rg-acfmxazb4ph6aiy****",
      "Tags": [
        {
          "Key": "usage",
          "Value": "test"
        }
      ]
    }
  ]
}

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.