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

Cria um grupo de stacks a partir de um modelo ROS para criar stacks em várias contas e regiões da Alibaba Cloud.

Descrição da operação

Um grupo de stacks gerencia múltiplos stacks ROS como uma unidade, permitindo criar stacks em diferentes contas e regiões da Alibaba Cloud.

Os grupos de stacks suportam dois modelos de permissão:

Autogerenciado: Tanto a conta de administrador quanto a conta de execução são contas da Alibaba Cloud.
Gerenciado por serviço: A conta de administrador é a conta de gerenciamento ou a conta de administrador delegado de um diretório de recursos. A conta de execução é uma conta membro desse diretório.

Visão geral.

Este exemplo cria um grupo de stacks autogerenciado chamado MyStackGroup na região China (Hangzhou) usando o modelo 5ecd1e10-b0e9-4389-a565-e4c15efc****.

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

create

*StackGroup

acs:ros:{#regionId}:{#accountId}:stackgroup/{#StackGroupName}

Template

acs:ros:{#regionId}:{#accountId}:template/{#TemplateId}

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 stacks. Chame DescribeRegions para consultar as regiões disponíveis.	cn-hangzhou
StackGroupName	string	Sim	O nome do grupo de stacks. Deve ser exclusivo dentro de uma região. De 1 a 255 caracteres. Pode conter letras, dígitos, hifens (-) e underscores (_). Deve começar com uma letra ou dígito.	MyStackGroup
Description	string	Não	A descrição do grupo de stacks. De 1 a 256 caracteres.	StackGroup Description
TemplateBody	string	Não	O corpo do modelo. De 1 a 524.288 bytes. Para modelos grandes, passe o corpo no corpo da solicitação HTTP POST para evitar limites de comprimento de URL. Nota Especifique exatamente um entre TemplateBody, TemplateURL e TemplateId.	{"ROSTemplateFormatVersion":"2015-09-01"}
TemplateURL	string	Não	A URL do arquivo de modelo. Suporta URLs HTTP, HTTPS e OSS. De 1 a 524.288 bytes. Exemplos: oss://ros/template/demo, oss://ros/template/demo?RegionId=cn-hangzhou. Se nenhum ID de região for especificado para o bucket OSS, o valor de RegionId será aplicado. Nota Especifique exatamente um entre TemplateBody, TemplateURL e TemplateId.	oss://ros-template/demo
ClientToken	string	Não	O token do cliente para idempotência. Deve ser exclusivo entre as solicitações. Pode conter letras, dígitos, underscores (_) e hifens (-), com até 64 caracteres. Como garantir a idempotência.	123e4567-e89b-12d3-a456-42665544****
AdministrationRoleName	string	Não	A role RAM para a conta de administrador em um grupo de stacks autogerenciado. O ROS assume essa role para executar operações. Padrão: AliyunROSStackGroupAdministrationRole. De 1 a 64 caracteres. Pode conter letras, dígitos e hifens (-). Nota Este parâmetro é obrigatório quando PermissionModel está definido como SELF_MANAGED.	AliyunROSStackGroupAdministrationRole
ExecutionRoleName	string	Não	A role RAM para a conta de execução em um grupo de stacks autogerenciado. A role de administrador assume essa role para executar operações de stack. Padrão: AliyunROSStackGroupExecutionRole. De 1 a 64 caracteres. Pode conter letras, dígitos e hifens (-). Nota Este parâmetro é obrigatório quando PermissionModel está definido como SELF_MANAGED.	AliyunROSStackGroupExecutionRole
TemplateId	string	Não	O ID do modelo. Aplica-se a modelos compartilhados e privados. Nota Especifique exatamente um entre TemplateBody, TemplateURL e TemplateId.	5ecd1e10-b0e9-4389-a565-e4c15efc****
TemplateVersion	string	Não	A versão do modelo. O padrão é a versão mais recente. Nota TemplateVersion só tem efeito se você especificar TemplateId.	v1
Parameters	array<object>	Não	Os parâmetros do grupo de stacks.
	object	Não
ParameterKey	string	Sim	A chave do parâmetro N. Se não especificado, o ROS usa o nome e o valor padrão definidos no modelo. Valor máximo de N: 200. Nota Parameters é opcional. Se você especificar Parameters, também deverá especificar Parameters.N.ParameterKey.	Amount
ParameterValue	string	Sim	O valor do parâmetro N. Valor máximo de N: 200. Nota Parameters é opcional. Se você especificar Parameters, também deverá especificar Parameters.N.ParameterValue.	12
ResourceGroupId	string	Não	O ID do grupo de recursos. O padrão é o grupo de recursos padrão. Grupos de recursos.	rg-acfmxazb4ph6aiy****
PermissionModel	string	Não	O modelo de permissão do grupo de stacks. Valores válidos: SELF_MANAGED (padrão): Cria roles RAM para as contas de administrador e execução e estabelece uma relação de confiança entre elas. SERVICE_MANAGED: O ROS cria automaticamente roles vinculadas a serviço para as contas de administrador e execução. Nota Para usar SERVICE_MANAGED, sua conta deve ser a conta de gerenciamento ou uma conta de administrador delegado de um diretório de recursos com acesso confiável habilitado. Gerenciar uma conta de administrador delegado e Habilitar acesso confiável.	SELF_MANAGED
Tags	array<object>	Não	As tags do grupo de stacks.
	object	Não	A tag do grupo de stacks.
Key	string	Sim	A chave da tag do grupo de stacks. Nota Tags é opcional. Se você deseja especificar Tags, também deverá especificar Tags.N.Key.	usage
Value	string	Não	O valor da tag do grupo de stacks.	test
AutoDeployment	object	Não	As configurações de implantação automática. Nota Você deve especificar este parâmetro se PermissionModel estiver definido como SERVICE_MANAGED.	{"Enabled": true, "RetainStacksOnAccountRemoval": true}
Enabled	boolean	Não	Se a implantação automática está habilitada. Valores válidos: true: O ROS cria automaticamente stacks para novas contas membro adicionadas à pasta e exclui stacks para contas removidas. false: Os stacks permanecem inalterados quando contas membro são adicionadas ou removidas da pasta.	true
RetainStacksOnAccountRemoval	boolean	Não	Se os stacks devem ser retidos quando uma conta membro é removida da pasta. Valores válidos: true false Nota Você deve especificar RetainStacksOnAccountRemoval se Enabled for true.	true
Capabilities	array	Não	As opções para o grupo de stacks. Máximo: uma opção.
	string	Não	A opção do grupo de stacks. Valor válido: ExpandModules, que expande módulos dentro da conta atual. Nota Este parâmetro só tem efeito quando módulos são usados no modelo. Por padrão, os módulos não são expandidos na conta atual, portanto devem existir em todas as contas de execução de destino. Para expandir módulos na conta atual, certifique-se de que os módulos existam nela. Valores válidos: ExpandModules : ExpandModules.	ExpandModules
StackArn	string	Não	O ARN do stack no formato acs:ros:${RegionId}:${AccountId}:stack/${StackId}. O grupo de stacks usa o modelo e os parâmetros deste stack. Nota Suportado apenas no modo de permissão autogerenciado. Se StackArn for especificado, Parameters não deve ser especificado. Você deve especificar apenas um entre TemplateBody, TemplateURL, TemplateId ou StackArn.	acs:ros:cn-hangzhou:175458000000**:stack/4a65f506-c3cc-43b6-af06-3f000000**

Parâmetros comuns.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	14A07460-EBE7-47CA-9757-12CC4761D47A
StackGroupId	string	O ID do grupo de stacks.	2c036e78-9e82-428e-afd6-177f5d04****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "14A07460-EBE7-47CA-9757-12CC4761D47A",
  "StackGroupId": "2c036e78-9e82-428e-afd6-177f5d04****"
}

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.