Todos los productos
Search
Centro de documentos

Resource Orchestration Service:ALIYUN::ROS::StackGroup

Última actualización: Sep 05, 2026

Crea un grupo de pilas.

Sintaxis

{
  "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 Obligatorio Editable Descripción Restricción
Description String No No Descripción del grupo de pilas. De 1 a 256 caracteres.
Parameters Map No No Detalles de los parámetros. Ninguna
ResourceGroupId String No No ID del resource group. El valor predeterminado es el resource group predeterminado.
DynamicTemplateBody Map No No Estructura que contiene el cuerpo de la plantilla. Use expresiones de función de ROS para obtener el contenido de la plantilla.
StackGroupName String Sí No Nombre del grupo de pilas. Debe ser único dentro de una región.

Máximo de 255 caracteres. Puede contener dígitos, letras, guiones (-) y guiones bajos (_). Debe comenzar con un dígito o una letra.

TemplateVersion String No No Versión de la plantilla. El valor predeterminado es la versión más reciente.
AdministrationRoleName String No No Nombre del rol de RAM para la cuenta de administrador al crear un grupo de pilas autogestionado. Obligatorio para grupos de pilas autogestionados.

Valor predeterminado: AliyunROSStackGroupAdministrationRole. Este rol asume AliyunROSStackGroupExecutionRole para gestionar las pilas de las instancias de pila en el grupo de pilas.

De 1 a 64 caracteres. Puede contener letras, dígitos y guiones (-).

TemplateBody Map No No Estructura que contiene el cuerpo de la plantilla. De 1 a 524,288 bytes.

Si el cuerpo de la plantilla supera este límite, agregue parámetros al cuerpo de la solicitud HTTP POST para evitar fallos en la solicitud por URL excesivamente largas.

Nota Especifique solo uno de los parámetros TemplateBody, TemplateURL y TemplateId.
TemplateURL String No No URL del archivo que contiene el cuerpo de la plantilla.

La URL debe apuntar a una plantilla en un servidor web o en un bucket de Object Storage Service (OSS). El cuerpo de la plantilla debe tener de 1 a 524,288 bytes.

Ejemplos de URL de OSS: oss://ros/template/demo y oss://ros/template/demo?RegionId=cn-hangzhou.

Si no se especifica la región del bucket de OSS, se usa el valor del parámetro RegionId.
Nota Especifique solo uno de los parámetros TemplateBody, TemplateURL y TemplateId.
AutoDeployment Map No No Configuración de despliegue automático. Parámetros de AutoDeployment.
PermissionModel String No No Modelo de permisos. Valores válidos:
  • SELF_MANAGED: modelo de permisos autogestionado.

    Requiere crear roles de RAM para las cuentas de administrador y de ejecución con una relación de confianza para desplegar pilas dentro de la cuenta de ejecución.

  • SERVICE_MANAGED: modelo de permisos gestionado por el servicio.

    ROS crea roles vinculados al servicio para las cuentas de administrador y de ejecución. La cuenta de administrador usa su rol para desplegar pilas dentro de la cuenta de ejecución.

Nota Para usar el modelo de permisos gestionado por el servicio, su cuenta debe ser una cuenta de administración o una cuenta de administrador delegado en el directorio de recursos con acceso de confianza habilitado. Para obtener más información, consulte Paso 1: (Opcional) Crear una cuenta de administrador delegado y Paso 2: Habilitar el acceso de confianza.
ExecutionRoleName String No No Nombre del rol de RAM para la cuenta de ejecución al crear un grupo de pilas autogestionado. Obligatorio para grupos de pilas autogestionados.

Valor predeterminado: AliyunROSStackGroupExecutionRole. Este rol gestiona las pilas de las instancias de pila en el grupo de pilas.

De 1 a 64 caracteres. Puede contener letras, dígitos y guiones (-).

TemplateId String No No ID de la plantilla. Aplica a plantillas compartidas y privadas.
Nota Especifique solo uno de los parámetros TemplateBody, TemplateURL y TemplateId.

Sintaxis de AutoDeployment

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

Parámetros de AutoDeployment

Parámetro Tipo Obligatorio Editable Descripción Restricción
Enabled Boolean Sí No Indica si se habilita el despliegue automático. Valores válidos:
  • true: habilita el despliegue automático.

    Cuando se agrega un miembro a la carpeta, ROS despliega las instancias de pila del grupo de pilas dentro de ese miembro.

    Cuando se elimina un miembro de la carpeta, se eliminan las instancias de pila dentro de ese miembro.

  • false: deshabilita el despliegue automático.

    Las instancias de pila permanecen sin cambios cuando cambia la membresía de la carpeta.

RetainStacksOnAccountRemoval Boolean No No Indica si se conservan las pilas en un miembro cuando este se elimina de la carpeta. Valores válidos:
  • true: conserva las pilas.
  • false: elimina las pilas.
Nota Obligatorio cuando Enabled se establece en true.

Parámetros de respuesta

Fn::GetAtt

StackGroupId: ID del grupo de pilas.

Ejemplos

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"
        ]
      }
    }
  }
}