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

Cria instâncias de pilha para uma ou mais contas em regiões especificadas.

Descrição da operação

Antes de começar

Certifique-se de ter criado um grupo de pilhas. Para mais informações, consulte CreateStackGroup.

Cenários comuns

Criar pilhas em várias contas

Quando uma empresa precisa criar recursos idênticos em várias contas, a conta de administrador pode adicionar várias contas de execução e implantar em uma única região ao criar um grupo de pilhas. Isso cria várias pilhas em contas diferentes na mesma região, melhorando a eficiência da implantação.

Criar pilhas em várias regiões

Quando uma empresa precisa criar recursos idênticos em várias regiões, a conta de administrador pode adicionar uma única conta de execução e implantar em várias regiões ao criar um grupo de pilhas. Isso cria várias pilhas em regiões diferentes na mesma conta, melhorando a eficiência da implantação.

Criar pilhas em várias contas e regiões

Quando uma empresa precisa criar recursos idênticos em várias contas e regiões, a conta de administrador pode adicionar várias contas de execução e implantar em várias regiões ao criar um grupo de pilhas. Isso cria várias pilhas em regiões diferentes em contas diferentes, melhorando a eficiência da implantação.

Este tópico fornece um exemplo de criação de pilhas para um grupo de pilhas existente chamado MyStackGroup com permissões autogerenciadas na região China (Hangzhou). As pilhas são criadas nas regiões China (Hangzhou) e China (Pequim) para as contas da Alibaba Cloud 151266687691**** e 141261387191****.

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

create

*StackInstance.

acs:ros:{#regionId}:{#accountId}:stackinstance/{#StackGroupName}/{#StackInstanceAccountId}/{#StackInstanceRegionId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região do grupo de pilhas. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
StackGroupName	string	Sim	O nome do grupo de pilhas. O nome deve ser exclusivo dentro de uma região. O nome pode ter até 255 caracteres e deve começar com um dígito ou uma letra. Pode conter dígitos, letras, hifens (-) e sublinhados (_).	MyStackGroup
AccountIds	array	Não	A lista de IDs de contas de execução para implantar pilhas com permissões autogerenciadas. Você pode adicionar até 50 IDs de contas de execução. Nota Você deve especificar um e apenas um entre `AccountIds` e `DeploymentTargets`.	["151266687691**","141261387191**"]
	string	Não	A lista de IDs de contas de execução para implantar pilhas com permissões autogerenciadas. Você pode adicionar até 50 IDs de contas de execução. Nota Você deve especificar um e apenas um entre `AccountIds` e `DeploymentTargets`.	["151266687691**", "141261387191**"]
RegionIds	array	Sim	A lista de regiões de destino. Você pode adicionar até 20 regiões.	["cn-hangzhou", "cn-beijing"]
	string	Não	A lista de regiões de destino. Você pode adicionar até 20 regiões.	["cn-hangzhou","cn-beijing"]
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja exclusivo entre diferentes solicitações. O token pode ter até 64 caracteres e pode conter letras, dígitos, hifens (-) e sublinhados (_). Para mais informações, consulte Como garantir a idempotência.	123e4567-e89b-12d3-a456-42665544****
OperationDescription	string	Não	A descrição da operação para criar pilhas. A descrição deve ter de 1 a 256 caracteres.	Criar instâncias de pilha em Hangzhou e Pequim
OperationPreferences	object	Não	As configurações de operação para criar pilhas. Os seguintes parâmetros estão incluídos: {"FailureToleranceCount": N} A contagem de tolerância a falhas. O número máximo de contas em cada região para as quais as operações de pilha podem falhar antes que a operação pare nessa região. Se a operação parar em uma região, ela não continuará em outras regiões. Valores válidos de N: 0 a 20. Se você não especificar FailureToleranceCount, o valor padrão 0 será usado. {"FailureTolerancePercentage": N} A porcentagem de tolerância a falhas. A porcentagem do número total de contas em cada região para as quais as operações de pilha podem falhar antes que a operação pare nessa região. Valores válidos de N: 0 a 100. Se a porcentagem não for um número inteiro, o Resource Orchestration Service (ROS) arredonda o valor para baixo. Se você não especificar FailureTolerancePercentage, o valor padrão 0 será usado. {"MaxConcurrentCount": N} O número máximo de contas simultâneas. O número máximo de contas em cada região para as quais as pilhas podem ser implantadas simultaneamente. Valores válidos de N: 1 a 20. Se você não especificar MaxConcurrentCount, o valor padrão 1 será usado. {"MaxConcurrentPercentage": N} A porcentagem máxima de contas simultâneas. A porcentagem do número total de contas em cada região para as quais as pilhas podem ser implantadas simultaneamente. Valores válidos: 1 a 100. Se a porcentagem não for um número inteiro, o ROS arredonda o valor para baixo. Se você não especificar MaxConcurrentPercentage, o valor padrão 1 será usado. {"RegionConcurrencyType": N} O tipo de simultaneidade no nível de região para implantar pilhas. Valores válidos: SEQUENTIAL (padrão): Implanta pilhas em cada região especificada sequencialmente, em ordem. Apenas uma região é implantada por vez. PARALLEL: Implanta pilhas em todas as regiões especificadas em paralelo. Separe vários parâmetros com vírgulas (,). Nota Você não pode especificar MaxConcurrentCount e MaxConcurrentPercentage ao mesmo tempo. Você não pode especificar FailureToleranceCount e FailureTolerancePercentage ao mesmo tempo.	{"FailureToleranceCount": 1, "MaxConcurrentCount": 2}
TimeoutInMinutes	integer	Não	O período de tempo limite para criar pilhas. Valor padrão: 60. Unidade: minutos.	10
DisableRollback	boolean	Não	Especifica se deve desativar a reversão quando a criação da pilha falhar. Valores válidos: true: desativa a reversão. Nenhuma reversão é realizada quando a criação da pilha falha. false (padrão): ativa a reversão. A reversão é realizada quando a criação da pilha falha.	false
ParameterOverrides	array<object>	Não	A lista de parâmetros a serem substituídos.
	object	Não
ParameterKey	string	Sim	O nome do parâmetro a ser substituído. Se você não especificar um nome de parâmetro, o ROS usará o nome do parâmetro de modelo especificado quando o grupo de pilhas foi criado. Valor máximo de N: 200. Nota ParameterOverrides é opcional. Se você especificar ParameterOverrides, deverá especificar tanto ParameterOverrides.N.ParameterKey quanto ParameterOverrides.N.ParameterValue.	Amount
ParameterValue	string	Sim	O valor do parâmetro a ser substituído. Se você não especificar um valor de parâmetro, o ROS usará o valor do parâmetro de modelo especificado quando o grupo de pilhas foi criado. Valor máximo de N: 200. Nota ParameterOverrides é opcional. Se você especificar ParameterOverrides, deverá especificar tanto ParameterOverrides.N.ParameterKey quanto ParameterOverrides.N.ParameterValue.	1
DeploymentTargets	object	Não	Os destinos de implantação para implantar pilhas com permissões gerenciadas pelo serviço. Nota Você deve especificar um e apenas um entre `AccountIds` e `DeploymentTargets`.	{"RdFolderId": "fd-4PvlVLOL8v"}
RdFolderIds	array	Sim	A lista de IDs de pastas de recursos no diretório de recursos. Você pode adicionar até 20 IDs de pastas de recursos. Você pode criar pilhas em todas as contas de membro dentro das pastas de recursos especificadas. Se você selecionar a pasta de recursos Raiz, as pilhas serão criadas em todas as contas de membro em todo o diretório de recursos. Nota Você pode visualizar os IDs das pastas de recursos na página Visão geral do console Gerenciamento de Recursos. Para mais informações, consulte Visualizar as informações básicas de uma pasta de recursos.
	string	Não	A lista de IDs de pastas de recursos no diretório de recursos. Você pode adicionar até 20 IDs de pastas de recursos. Você pode criar pilhas em todas as contas de membro dentro das pastas de recursos especificadas. Se você selecionar a pasta de recursos Raiz, as pilhas serão criadas em todas as contas de membro em todo o diretório de recursos. Nota Você pode visualizar os IDs das pastas de recursos na página Visão geral do console Gerenciamento de Recursos. Para mais informações, consulte Visualizar as informações básicas de uma pasta de recursos.	["fd-4PvlVLOL8v"]
AccountIds	array	Não	A lista de IDs de contas de membro no diretório de recursos. Você pode adicionar até 30 IDs de contas de membro. Nota Você pode visualizar os IDs das contas de membro na página Visão geral do console Gerenciamento de Recursos. Para mais informações, consulte Visualizar detalhes do membro.
	string	Não	A lista de IDs de contas de membro no diretório de recursos. Você pode adicionar até 30 IDs de contas de membro. Nota Você pode visualizar os IDs das contas de membro na página Visão geral do console Gerenciamento de Recursos. Para mais informações, consulte Visualizar detalhes do membro.	["151266687691**","141261387191**"]
DeploymentOptions	array	Não	A lista de opções de implantação para implantar pilhas com permissões gerenciadas pelo serviço. Você pode especificar até uma opção de implantação.
	string	Não	Valores válidos: IgnoreExisting: ignora o erro se a instância de pilha a ser criada já existir.	IgnoreExisting

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

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	14A07460-EBE7-47CA-9757-12CC4761D47A
OperationId	string	O ID da operação.	6da106ca-1784-4a6f-a7e1-e723863d****

Exemplos

Resposta de sucesso

JSON formato

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

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.