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
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:
Use vírgulas (,) para separar vários parâmetros. Nota
|
| TimeoutInMinutes | Long | Não | 10 | Tempo limite permitido para concluir a criação da stack.
|
| 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:
|
| 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
|
| 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
|
| 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. |