Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::ROS::StackGroup

Última atualização: Jun 27, 2026

Cria um grupo de stacks.

Sintaxe

{
  "Type": "ALIYUN::ROS::StackGroup",
  "Properties": {
    "Description": String,
    "Parameters": Map,
    "ResourceGroupId": String,
    "DynamicTemplateBody": Map,
    "StackGroupName": String,
    "TemplateVersion": String,
    "AdministrationRoleName": String,
    "TemplateBody": Map,
    "TemplateURL": String,
    "AutoDeployment": Map,
    "PermissionModel": String,
    "ExecutionRoleName": String,
    "TemplateId": String
  }
}

Parâmetros

Parâmetro Tipo Obrigatório Editável Descrição Restrição
Description String Não Não Descrição do grupo de stacks. De 1 a 256 caracteres.
Parameters Map Não Não Detalhes dos parâmetros. Nenhuma
ResourceGroupId String Não Não ID do grupo de recursos. O valor padrão é o grupo de recursos padrão.
DynamicTemplateBody Map Não Não Estrutura que contém o corpo do modelo. Use expressões de função do ROS para obter o conteúdo do modelo.
StackGroupName String Sim Não Nome do grupo de stacks. Deve ser único na região.

Máximo de 255 caracteres. Pode conter dígitos, letras, hifens (-) e sublinhados (_). Deve começar com um dígito ou letra.

TemplateVersion String Não Não Versão do modelo. O valor padrão é a versão mais recente.
AdministrationRoleName String Não Não Nome da função do RAM da conta administradora para criação de grupo de stacks autogerenciado. Obrigatório para grupos de stacks autogerenciados.

Padrão: AliyunROSStackGroupAdministrationRole. Essa função assume a AliyunROSStackGroupExecutionRole para gerenciar as stacks das instâncias de stack no grupo de stacks.

De 1 a 64 caracteres. Pode conter letras, dígitos e hifens (-).

TemplateBody Map Não Não Estrutura que contém o corpo do modelo. De 1 a 524.288 bytes.

Se o corpo do modelo exceder esse limite, adicione parâmetros ao corpo da solicitação HTTP POST para evitar falhas causadas por URLs excessivamente longas.

Nota Especifique apenas um dos parâmetros TemplateBody, TemplateURL ou TemplateId.
TemplateURL String Não Não URL do arquivo que contém o corpo do modelo.

A URL deve apontar para um modelo em um servidor web ou em um bucket do Object Storage Service (OSS). O corpo do modelo deve ter de 1 a 524.288 bytes.

Exemplos de URLs do OSS: oss://ros/template/demo e oss://ros/template/demo?RegionId=cn-hangzhou.

Caso a região do bucket do OSS não seja especificada, o sistema usa o valor do parâmetro RegionId.
Nota Especifique apenas um dos parâmetros TemplateBody, TemplateURL ou TemplateId.
AutoDeployment Map Não Não Configurações de implantação automática. Parâmetros de AutoDeployment.
PermissionModel String Não Não Modelo de permissão. Valores válidos:
  • SELF_MANAGED: modelo de permissão autogerenciado.

    Exige a criação de funções do RAM para as contas administradora e de execução, com relação de confiança, para implantar stacks na conta de execução.

  • SERVICE_MANAGED: modelo de permissão gerenciado pelo serviço.

    O ROS cria funções vinculadas ao serviço para as contas administradora e de execução. A conta administradora usa sua função para implantar stacks na conta de execução.

Nota Para usar o modelo de permissão gerenciado pelo serviço, sua conta deve ser uma conta de gerenciamento ou uma conta de administrador delegado no diretório de recursos com acesso confiável ativado. Para mais informações, consulte Etapa 1: (Opcional) Criar uma conta de administrador delegado e Etapa 2: Ative o acesso confiável.
ExecutionRoleName String Não Não Nome da função do RAM da conta de execução para criação de grupo de stacks autogerenciado. Obrigatório para grupos de stacks autogerenciados.

Padrão: AliyunROSStackGroupExecutionRole. Essa função gerencia as stacks das instâncias de stack no grupo de stacks.

De 1 a 64 caracteres. Pode conter letras, dígitos e hifens (-).

TemplateId String Não Não ID do modelo. Aplica-se a modelos compartilhados e privados.
Nota Especifique apenas um dos parâmetros TemplateBody, TemplateURL ou TemplateId.

Sintaxe de AutoDeployment

"AutoDeployment": {
  "Enabled": Boolean,
  "RetainStacksOnAccountRemoval": Boolean
}

Parâmetros de AutoDeployment

Parâmetro Tipo Obrigatório Editável Descrição Restrição
Enabled Boolean Sim Não Indica se a implantação automática está ativada. Valores válidos:
  • true: ative a implantação automática.

    Ao adicionar um membro à pasta, o ROS implanta as instâncias de stack do grupo de stacks nesse membro.

    Ao remover um membro da pasta, o sistema exclui as instâncias de stack desse membro.

  • false: desativa a implantação automática.

    As instâncias de stack permanecem inalteradas quando há mudanças na associação da pasta.

RetainStacksOnAccountRemoval Boolean Não Não Indica se as stacks devem ser mantidas em um membro após sua remoção da pasta. Valores válidos:
  • true: retém as stacks.
  • false: exclui as stacks.
Nota Obrigatório quando Enabled estiver definido como true.

Parâmetros de resposta

Fn::GetAtt

StackGroupId: ID do grupo de stacks.

Exemplos

Formato JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "StackGroupName": {
      "Type": "String"
    },
    "TemplateId": {
      "Type": "String"
    }
  },
  "Resources": {
    "ExtensionResource": {
      "Type": "ALIYUN::ROS::StackGroup",
      "Properties": {
        "StackGroupName": {
          "Ref": "StackGroupName"
        },
        "TemplateId": {
          "Ref": "TemplateId"
        }
      }
    }
  },
  "Outputs": {
    "StackGroupId": {
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "StackGroupId"
        ]
      }
    }
  }
}