DeleteStackInstances - : Central de Documentação do Alibaba Cloud

Este tópico apresenta um exemplo de exclusão de stacks de um grupo de stacks. Neste cenário, as stacks implantadas na conta Alibaba Cloud 151266687691**** na região China (Pequim) são removidas do grupo de stacks MyStackGroup. O grupo de stacks está implantado na região China (Hangzhou) e possui permissões autogerenciadas.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DeleteStackInstances	Operação a ser executada. Defina o valor como DeleteStackInstances.
RegionId	String	Sim	cn-hangzhou	ID da região à qual o grupo de stacks pertence. Chame a operação DescribeRegions para consultar a lista mais recente de regiões.
StackGroupName	String	Sim	MyStackGroup	Nome do grupo de stacks. O nome deve ser único na região. O nome pode ter até 255 caracteres e conter dígitos, letras, hifens (-) e sublinhados (_). Deve começar com um dígito ou letra.
AccountIds	Array of String	Não	["151266687691**","141261387191**"]	IDs das contas usadas para implantar stacks no modelo de permissão autogerenciada. Você pode especificar até 20 IDs de conta.
RegionIds	Array of String	Sim	["cn-hangzhou","cn-beijing"]	IDs das regiões das quais você deseja excluir as stacks. Você pode especificar até 20 IDs de região.
RetainStacks	Boolean	Sim	false	Define se as stacks devem ser retidas. Valores válidos: true: retém as stacks. false: exclua as stacks.
ClientToken	String	Não	123e4567-e89b-12d3-a456-42665544****	Token de cliente usado para garantir a idempotência da solicitação. Gere esse valor no cliente e garanta que seja exclusivo entre diferentes solicitações. O token aceita até 64 caracteres, incluindo letras, dígitos, hifens (-) e sublinhados (_). Para mais informações, consulte Garantir idempotência.
OperationDescription	String	Não	Delete stack instances in hangzhou and beijing	Descrição da operação de exclusão das stacks. A descrição deve ter de 1 a 256 caracteres.
OperationPreferences	Map	Não	{"FailureToleranceCount": 1, "MaxConcurrentCount": 2}	Configurações aplicadas durante a exclusão das stacks. Inclui os seguintes parâmetros: {"FailureToleranceCount": N} Número de contas por região onde falhas na operação de stack são toleradas. Se esse limite for ultrapassado em uma região, o Resource Orchestration Service (ROS) interrompe a operação nessa região. A interrupção em uma região impede a execução nas demais. Valores válidos para N: 0 a 20. Se você não especificar o parâmetro FailureToleranceCount, o valor padrão 0 será usado. {"FailureTolerancePercentage": N} Percentual de contas por região onde falhas são aceitáveis em relação ao total de contas na região. Se esse valor for ultrapassado em uma região, o ROS interrompe a operação nessa região. Valores válidos para N: 0 a 100. Se o valor numérico da porcentagem não for um número inteiro, o ROS arredonda o valor para baixo. Se você não especificar o parâmetro FailureTolerancePercentage, o valor padrão 0 será usado. {"MaxConcurrentCount": N} Número máximo de contas nas quais as stacks são implantadas simultaneamente em cada região. Valores válidos para N: 1 a 20. Se você não especificar o parâmetro MaxConcurrentCount, o valor padrão 1 será usado. {"MaxConcurrentPercentage": N} Percentual do número máximo de contas nas quais as stacks são implantadas simultaneamente em relação ao total de contas em cada região. Valores válidos para N: 1 a 100. Se o valor numérico da porcentagem não for um número inteiro, o ROS arredonda o valor para baixo. Se você não especificar o parâmetro MaxConcurrentPercentage, o valor padrão 1 será usado. {"RegionConcurrencyType": N} Modo de implantação das stacks entre regiões. Valor padrão: SEQUENTIAL. Valores válidos: SEQUENTIAL: implanta stacks em cada região especificada com base na sequência definida. O ROS implanta stacks em uma região por vez. PARALLEL: implanta stacks em paralelo em todas as regiões especificadas. Separe vários parâmetros com vírgulas (,). Nota Você pode especificar apenas um dos parâmetros MaxConcurrentCount e MaxConcurrentPercentage. Você pode especificar apenas um dos parâmetros FailureToleranceCount e FailureTolerancePercentage.
DeploymentTargets	Object	Não		Pastas nas quais o modelo de permissão gerenciada pelo serviço é usado para implantar stacks.
RdFolderIds	Array of String	Sim	["fd-4PvlVLOL8v"]	IDs das pastas no diretório de recursos. Você pode especificar até cinco IDs de pasta. Você pode criar stacks em todos os membros das pastas especificadas. Se você criar stacks na pasta Root, elas serão criadas em todos os membros do diretório de recursos. Nota Para visualizar os IDs das pastas, acesse a página Overview no console de Resource Management. Para mais informações, consulte Visualizar informações básicas de uma pasta.

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

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	14A07460-EBE7-47CA-9757-12CC4761D47A	ID da solicitação.
OperationId	String	6da106ca-1784-4a6f-a7e1-e723863d****	ID da operação.

Exemplos

Exemplos de solicitações

http(s)://ros.aliyuncs.com/?Action=DeleteStackInstances
&AccountIds=["151266687691****"]
&RegionId=cn-hangzhou
&RegionIds=["cn-beijing"]
&StackGroupName=MyStackGroup
&RetainStacks=false
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DeleteStackInstancesResponse>
    <RequestId>14A07460-EBE7-47CA-9757-12CC4761D47A</RequestId>
    <OperationId>6da106ca-1784-4a6f-a7e1-e723863d****</OperationId>
</DeleteStackInstancesResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "14A07460-EBE7-47CA-9757-12CC4761D47A",
  "OperationId" : "6da106ca-1784-4a6f-a7e1-e723863d****"
}

Códigos de erro

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.

Código de erro	Mensagem de erro	Código de status HTTP	Descrição
InvalidParameter	The specified parameter {name} is invalid, {reason}.	400	Erro retornado porque o parâmetro é inválido. name indica o nome do parâmetro. reason indica a causa do erro.
StackGroupNotFound	The StackGroup ({name}) could not be found.	404	Erro retornado porque o grupo de stacks não existe. name indica o nome do grupo de stacks.
StackGroupOperationInProgress	Another Operation on StackGroup ({name}) is in progress.	409	Erro retornado porque uma operação está sendo realizada no grupo de stacks. name indica o nome do grupo de stacks.