Todos os produtos
Search
Central de documentação

:CreateStackInstances

Última atualização: Jun 27, 2026

Cria stacks para contas especificadas em regiões específicas.

Antes de chamar esta operação, verifique se um grupo de stacks já foi criado. Para mais informações, consulte CreateStackGroup.

Este tópico apresenta um exemplo de como criar stacks em um grupo de stacks. Neste cenário, as stacks são criadas no grupo denominado MyStackGroup. A criação ocorre nas contas da Alibaba Cloud 151266687691**** e 141261387191****, localizadas nas regiões China (Hangzhou) e China (Pequim). O grupo de stacks possui permissões autogerenciadas e reside na região China (Hangzhou).

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos que você chame esta operação diretamente no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente exemplos de código para diferentes SDKs.

Parâmetros da solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim CreateStackInstances

A operação a ser executada. Defina o valor como CreateStackInstances.

RegionId String Sim cn-hangzhou

ID da região à qual o grupo de stacks pertence. Chame a operação DescribeRegions para obter a lista atualizada de regiões.

StackGroupName String Sim MyStackGroup

Nome do grupo de stacks, que deve ser exclusivo dentro da região.

O nome pode ter até 255 caracteres e aceitar dígitos, letras, hifens (-) e sublinhados (_). Deve começar com um dígito ou uma letra.

AccountIds Array of String Não ["151266687691****", "141261387191****"]

IDs das contas onde as stacks serão implantadas usando o modelo de permissão autogerenciada. É possível especificar até 20 IDs de conta.

Nota Especifique apenas um dos parâmetros: AccountIds ou DeploymentTargets.
RegionIds Array of String Sim ["cn-hangzhou","cn-beijing"]

IDs das regiões onde as stacks serão criadas. O limite é de 20 IDs de região.

ClientToken String Não 123e4567-e89b-12d3-a456-42665544****

Token do cliente usado para garantir a idempotência da solicitação. Embora o próprio cliente possa gerar esse valor, ele precisa ser único para cada solicitação distinta.

O token aceita até 64 caracteres, incluindo letras, dígitos, hifens (-) e sublinhados (_).

Para mais detalhes, consulte Garantir idempotência.

OperationDescription String Não Create stack instances in hangzhou and beijing

Descrição da operação de criação de 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) cria as stacks.

Inclui os seguintes parâmetros:

  • {"FailureToleranceCount": N}

    Quantidade de contas por região que podem apresentar falha na operação de stack sem interromper o processo. Se esse número for ultrapassado em alguma região, o ROS encerra a operação nela e também nas demais regiões restantes.

    Valores válidos para N: 0 a 20.

    Caso não seja definido, o valor padrão é 0.

  • {"FailureTolerancePercentage": N}

    Percentual de contas com falhas permitidas em relação ao total de contas em cada região. Ao exceder essa porcentagem, o ROS paralisa a operação naquela região específica.

    Valores válidos para N: 0 a 100. Valores decimais são arredondados para baixo pelo ROS.

    Se omitido, assume-se o valor padrão 0.

  • {"MaxConcurrentCount": N}

    Número máximo de contas que recebem implantação simultânea de stacks em cada região.

    Valores válidos para N: 1 a 20.

    Na ausência deste parâmetro, o sistema utiliza o valor padrão 1.

  • {"MaxConcurrentPercentage": N}

    Proporção percentual de contas com implantação simultânea frente ao total de contas disponíveis na região.

    Intervalo válido: 1 a 100. Frações são sempre arredondadas para o inteiro inferior.

    O valor padrão é 1 quando nada é especificado.

  • {"RegionConcurrencyType": N}

    Modo de implantação de stacks entre múltiplas regiões. Valor padrão: SEQUENTIAL. Opções disponíveis:

    • SEQUENTIAL: segue a ordem definida na lista de regiões, processando uma por vez.
    • PARALLEL: executa a implantação em todas as regiões indicadas ao mesmo tempo.

Use vírgulas (,) para separar vários parâmetros.

Nota
  • Escolha entre MaxConcurrentCount ou MaxConcurrentPercentage.
  • Opte por FailureToleranceCount ou FailureTolerancePercentage.
TimeoutInMinutes Long Não 10

Tempo limite permitido para concluir a criação da stack.

  • Valor padrão: 60.
  • Unidade: minutos.
DisableRollback Boolean Não false

Define se o rollback deve ser desativado caso a criação das stacks falhe.

Valor padrão: false. Opções:

  • true
  • false
ParameterOverrides.N.ParameterKey String Sim Amount

Nome do parâmetro N destinado a substituir uma configuração específica. Sem essa definição, o ROS adota o nome configurado originalmente durante a criação do grupo de stacks.

Valor máximo de N: 200.

Nota
  • O uso de ParameterOverrides é opcional.
  • Ao utilizar ParameterOverrides, torna-se obrigatório informar tanto ParameterOverrides.N.ParameterKey quanto ParameterOverrides.N.ParameterValue.
ParameterOverrides.N.ParameterValue String Sim 1

Valor do parâmetro N usado para sobrescrever uma configuração existente. Na ausência de nome e valor para N, o ROS mantém os dados definidos na criação do grupo de stacks.

Limite superior de N: 200.

Nota
  • ParameterOverrides é um campo facultativo.
  • Sua inclusão exige o preenchimento conjunto de ParameterOverrides.N.ParameterKey e ParameterOverrides.N.ParameterValue.
DeploymentTargets Object Não

Pastas alvo para implantação de stacks mediante o modelo de permissão gerenciada por serviço.

Nota Informe exclusivamente AccountIds ou DeploymentTargets, nunca ambos.
RdFolderIds Array of String Sim ["fd-4PvlVLOL8v"]

Identificadores das pastas no diretório de recursos, limitado a cinco entradas.

As stacks abrangem todos os membros das pastas selecionadas. Selecionar a pasta Root implica criar stacks em todos os membros do diretório de recursos.

Nota Para consultar os IDs das pastas, acesse a página Overview no console de Resource Management. Veja mais em Visualizar informações básicas de uma pasta.

Consulte Parâmetros comuns para detalhes adicionais sobre parâmetros de solicitação compartilhados.

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

Exemplos

Exemplo de solicitação

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

Exemplo de resposta de sucesso

Formato XML

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

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

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 completa 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

StackInstanceExists

The StackInstance ({instance}) already exists.

409

Retorna este erro quando a stack já existe na conta e região indicadas. O campo instance refere-se ao nome da stack.

StackGroupOperationInProgress

Another Operation on StackGroup ({name}) is in progress.

409

Indica que outra operação está em andamento no grupo de stacks. O campo name corresponde ao nome desse grupo.