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

Este tópico apresenta um exemplo de atualização de stacks em um grupo de stacks. Neste cenário, as stacks implantadas no grupo de stacks MyStackGroup são atualizadas. A implantação ocorre nas contas da Alibaba Cloud 151266687691**** e 141261387191****, nas regiões China (Hangzhou) e China (Pequim). O grupo de stacks possui permissões autogerenciadas e está implantado na região China (Hangzhou).

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 da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	UpdateStackInstances	Operação a ser executada. Defina o valor como UpdateStackInstances.
RegionId	String	Sim	cn-hangzhou	ID da região à qual o grupo de stacks pertence. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
StackGroupName	String	Sim	MyStackGroup	Nome do grupo de stacks. Deve ser único na região. Pode ter até 255 caracteres e conter dígitos, letras, hifens (-) e sublinhados (_). Deve iniciar com um dígito ou letra.
AccountIds	Array of String	Não	["151266687691**","141261387191**"]	IDs das contas que utilizam o modelo de permissão autogerenciada para implantar stacks. É possível especificar até 20 IDs de conta. Nota Este parâmetro é obrigatório ao utilizar o modelo de permissão autogerenciada para atualizar as stacks.
RegionIds	Array of String	Sim	["cn-hangzhou","cn-beijing"]	IDs das regiões onde as stacks serão atualizadas. É possível especificar até 20 IDs de região.
ClientToken	String	Não	123e4567-e89b-12d3-a456-42665544****	Token de cliente usado para garantir a idempotência da solicitação. Gere o valor usando o cliente, mas assegure que seja único entre solicitações diferentes. O token aceita até 64 caracteres, incluindo letras, dígitos, hifens (-) e sublinhados (_). Para mais detalhes, consulte Garantir idempotência.
OperationDescription	String	Não	Update stack instances in hangzhou and beijing	Descrição da operação de atualização das stacks. Deve conter entre 1 e 256 caracteres.
OperationPreferences	Map	Não	{"FailureToleranceCount": 1,"MaxConcurrentCount": 2}	Preferências personalizadas sobre como o Resource Orchestration Service (ROS) atualiza as stacks. Inclui os seguintes parâmetros: {"FailureToleranceCount": N} Quantidade de contas por região onde falhas na operação de stack são toleradas. Se esse limite for excedido em uma região, o ROS interrompe a operação nela. Caso a operação pare em uma região, ela não será executada nas demais. Valores válidos para N: 0 a 20. Se o parâmetro FailureToleranceCount não for especificado, o valor padrão 0 será aplicado. {"FailureTolerancePercentage": N} Percentual de contas por região onde falhas na operação de stack são permitidas em relação ao total de contas. O ROS encerra a operação na região caso esse percentual seja ultrapassado. Valores válidos para N: 0 a 100. Se o valor numérico do percentual não for inteiro, o ROS arredonda para baixo. Na ausência do parâmetro FailureTolerancePercentage, o sistema assume o valor padrão 0. {"MaxConcurrentCount": N} Número máximo de contas onde as stacks são implantadas simultaneamente em cada região. Valores válidos para N: 1 a 20. Caso MaxConcurrentCount não seja definido, o valor padrão é 1. {"MaxConcurrentPercentage": N} Percentual máximo de contas com implantações simultâneas em relação ao total de contas por região. Intervalo válido: 1 a 100. Valores decimais são arredondados para baixo pelo ROS. Sem a definição de MaxConcurrentPercentage, o valor padrão utilizado é 1. {"RegionConcurrencyType": N} Modo de implantação de stacks entre regiões. Valor padrão: SEQUENTIAL. Opções disponíveis: SEQUENTIAL: implanta stacks em cada região conforme a sequência definida. O ROS processa uma região por vez. PARALLEL: executa a implantação em todas as regiões especificadas simultaneamente. Separe múltiplos parâmetros com vírgulas (,). Nota Especifique apenas um dos parâmetros: MaxConcurrentCount ou MaxConcurrentPercentage. Escolha entre FailureToleranceCount ou FailureTolerancePercentage.
TimeoutInMinutes	Long	Não	10	Tempo limite para a operação de atualização da stack. Valor padrão: 60. Unidade: minutos.
ParameterOverrides.N.ParameterKey	String	Sim	Amount	Nome do parâmetro N usado para substituir um parâmetro específico. Sem essa especificação, o ROS utiliza o nome definido durante a criação do grupo de stacks. Valor máximo de N: 200. Nota O parâmetro ParameterOverrides é opcional. Ao usar ParameterOverrides, é obrigatório definir ParameterOverrides.N.ParameterKey e ParameterOverrides.N.ParameterValue.
ParameterOverrides.N.ParameterValue	String	Sim	1	Valor do parâmetro N destinado à substituição. Se nome e valor não forem informados, o ROS aplica os valores configurados na criação do grupo de stacks. Valor máximo de N: 200. Nota ParameterOverrides é um parâmetro opcional. A inclusão de ParameterOverrides exige a definição de ParameterOverrides.N.ParameterKey e ParameterOverrides.N.ParameterValue.
DeploymentTargets	Object	Não		Pastas onde o modelo de permissão gerenciada por serviço é aplicado para implantar stacks. Nota Parâmetro obrigatório quando se utiliza o modelo de permissão gerenciada por serviço para atualizar stacks.
RdFolderIds	Array of String	Não	["fd-4PvlVLOL8v"]	IDs das pastas no diretório de recursos. Limite de cinco IDs. Informe pelo menos RdFolderIds ou AccountIds, obedecendo às regras abaixo: Com apenas RdFolderIds, a implantação atinge todos os membros das pastas indicadas. Selecione a pasta Root abrange todo o diretório de recursos. Usando somente AccountIds, as stacks vão apenas para os membros listados. Ao combinar ambos, as contas de AccountIds devem pertencer às pastas de RdFolderIds. A implantação ocorre nos membros especificados contidos nessas pastas. Nota Para verificar os IDs das pastas, acesse a página Overview no console de Resource Management. Consulte também Visualize informações básicas de uma pasta.
AccountIds	Array of String	Não	["151266687691**","141261387191**"]	IDs dos membros no diretório de recursos. Aceita até 20 IDs. Nota Os IDs dos membros podem ser visualizados na página Overview do console Resource Management. Veja mais em Visualize informações detalhadas de um membro.

Para detalhes 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=UpdateStackInstances
&AccountIds=["151266687691****","141261387191****"]
&RegionId=cn-hangzhou
&RegionIds=["cn-hangzhou","cn-beijing"]
&StackGroupName=MyStackGroup
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

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

Formato JSON

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

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

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	Retornado quando um parâmetro é inválido. name indica o nome do parâmetro; reason descreve a causa do erro.
StackGroupNotFound	The StackGroup ({name}) could not be found.	404	Indica que o grupo de stacks não existe. name corresponde ao nome do grupo.
StackGroupOperationInProgress	Another Operation on StackGroup ({name}) is in progress.	409	Sinaliza que outra operação já está em andamento no grupo de stacks. name refere-se ao nome do grupo.