CreateStackGroup - Resource Orchestration Service - Centro de documentación de Alibaba Cloud

Crea un grupo de pilas a partir de una plantilla de ROS para crear pilas en múltiples cuentas y regiones de Alibaba Cloud.

Descripción de la operación

Un grupo de pilas administra múltiples pilas de ROS como una unidad, lo que permite crear pilas en varias cuentas y regiones de Alibaba Cloud.

Los grupos de pilas admiten dos modelos de permisos:

Autogestionado: Tanto la cuenta de administrador como la de ejecución son cuentas de Alibaba Cloud.
Gestionado por el servicio: La cuenta de administrador es la cuenta de gestión o la cuenta de administrador delegado de un directorio de recursos. La cuenta de ejecución es una cuenta miembro de dicho directorio.

Visión general.

Este ejemplo crea un grupo de pilas autogestionado llamado MyStackGroup en la región China (Hangzhou) mediante la plantilla 5ecd1e10-b0e9-4389-a565-e4c15efc****.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ros:CreateStackGroup

create

*StackGroup

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

Template

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región del grupo de pilas. Llame a DescribeRegions para consultar las regiones disponibles.	cn-hangzhou
StackGroupName	string	Sí	El nombre del grupo de pilas. Debe ser único dentro de una región. De 1 a 255 caracteres. Puede contener letras, dígitos, guiones (-) y guiones bajos (_). Debe comenzar con una letra o un dígito.	MyStackGroup
Description	string	No	La descripción del grupo de pilas. De 1 a 256 caracteres.	Descripción del grupo de pilas
TemplateBody	string	No	El cuerpo de la plantilla. De 1 a 524,288 bytes. Para plantillas grandes, pase el cuerpo en el cuerpo de la solicitud HTTP POST para evitar límites de longitud de URL. Nota Especifique exactamente uno de TemplateBody, TemplateURL y TemplateId.	{"ROSTemplateFormatVersion":"2015-09-01"}
TemplateURL	string	No	La URL del archivo de plantilla. Admite URL de HTTP, HTTPS y OSS. De 1 a 524,288 bytes. Ejemplos: oss://ros/template/demo, oss://ros/template/demo?RegionId=cn-hangzhou. Si no se especifica ningún ID de región para el bucket de OSS, se aplica el valor de RegionId. Nota Especifique exactamente uno de TemplateBody, TemplateURL y TemplateId.	oss://ros-template/demo
ClientToken	string	No	El token de cliente para la idempotencia. Debe ser único en todas las solicitudes. Puede contener letras, dígitos, guiones bajos (_) y guiones (-), hasta 64 caracteres. Cómo garantizar la idempotencia.	123e4567-e89b-12d3-a456-42665544****
AdministrationRoleName	string	No	El rol de RAM para la cuenta de administrador en un grupo de pilas autogestionado. ROS asume este rol para realizar operaciones. Valor predeterminado: AliyunROSStackGroupAdministrationRole. De 1 a 64 caracteres. Puede contener letras, dígitos y guiones (-). Nota Este parámetro es obligatorio cuando PermissionModel se establece en SELF_MANAGED.	AliyunROSStackGroupAdministrationRole
ExecutionRoleName	string	No	El rol de RAM para la cuenta de ejecución en un grupo de pilas autogestionado. El rol de administrador asume este rol para realizar operaciones de pila. Valor predeterminado: AliyunROSStackGroupExecutionRole. De 1 a 64 caracteres. Puede contener letras, dígitos y guiones (-). Nota Este parámetro es obligatorio cuando PermissionModel se establece en SELF_MANAGED.	AliyunROSStackGroupExecutionRole
TemplateId	string	No	El ID de la plantilla. Se aplica a plantillas compartidas y privadas. Nota Especifique exactamente uno de TemplateBody, TemplateURL y TemplateId.	5ecd1e10-b0e9-4389-a565-e4c15efc****
TemplateVersion	string	No	La versión de la plantilla. El valor predeterminado es la versión más reciente. Nota TemplateVersion solo surte efecto si especifica TemplateId.	v1
Parameters	array<object>	No	Los parámetros del grupo de pilas.
	object	No
ParameterKey	string	Sí	La clave del parámetro N. Si no se especifica, ROS utiliza el nombre y el valor predeterminados definidos en la plantilla. Valor máximo de N: 200. Nota Parameters es opcional. Si especifica Parameters, también debe especificar Parameters.N.ParameterKey.	Amount
ParameterValue	string	Sí	El valor del parámetro N. Valor máximo de N: 200. Nota Parameters es opcional. Si especifica Parameters, también debe especificar Parameters.N.ParameterValue.	12
ResourceGroupId	string	No	El ID del grupo de recursos. El valor predeterminado es el grupo de recursos predeterminado. Grupos de recursos.	rg-acfmxazb4ph6aiy****
PermissionModel	string	No	El modelo de permisos del grupo de pilas. Valores válidos: SELF_MANAGED (predeterminado): Crea roles de RAM para las cuentas de administrador y de ejecución, y establece una relación de confianza entre ellas. SERVICE_MANAGED: ROS crea automáticamente roles vinculados al servicio para las cuentas de administrador y de ejecución. Nota Para usar SERVICE_MANAGED, su cuenta debe ser la cuenta de gestión o una cuenta de administrador delegado de un directorio de recursos con acceso de confianza habilitado. Administrar una cuenta de administrador delegado y Habilitar acceso de confianza.	SELF_MANAGED
Tags	array<object>	No	Las etiquetas del grupo de pilas.
	object	No	La etiqueta del grupo de pilas.
Key	string	Sí	La clave de etiqueta del grupo de pilas. Nota Tags es opcional. Si desea especificar Tags, también debe especificar Tags.N.Key.	usage
Value	string	No	El valor de etiqueta del grupo de pilas.	test
AutoDeployment	object	No	La configuración de despliegue automático. Nota Debe especificar este parámetro si PermissionModel se establece en SERVICE_MANAGED.	{"Enabled": true, "RetainStacksOnAccountRemoval": true}
Enabled	boolean	No	Indica si el despliegue automático está habilitado. Valores válidos: true: ROS crea automáticamente pilas para las nuevas cuentas miembro agregadas a la carpeta y elimina las pilas de las cuentas eliminadas. false: Las pilas permanecen sin cambios cuando se agregan o eliminan cuentas miembro de la carpeta.	true
RetainStacksOnAccountRemoval	boolean	No	Indica si se deben conservar las pilas cuando se elimina una cuenta miembro de la carpeta. Valores válidos: true false Nota Debe especificar RetainStacksOnAccountRemoval si Enabled es true.	true
Capabilities	array	No	Las opciones para el grupo de pilas. Máximo: una opción.
	string	No	La opción del grupo de pilas. Valor válido: ExpandModules, que expande los módulos dentro de la cuenta actual. Nota Este parámetro solo surte efecto cuando se utilizan módulos en la plantilla. De forma predeterminada, los módulos no se expanden en la cuenta actual, por lo que deben existir en todas las cuentas de ejecución objetivo. Para expandir los módulos en la cuenta actual, asegúrese de que los módulos existan allí. Valores válidos: ExpandModules : ExpandModules.	ExpandModules
StackArn	string	No	El ARN de la pila con el formato acs:ros:${RegionId}:${AccountId}:stack/${StackId}. El grupo de pilas utiliza la plantilla y los parámetros de esta pila. Nota Solo se admite en el modo de permisos autogestionado. Si se especifica StackArn, no se debe especificar Parameters. Debe especificar solo uno de TemplateBody, TemplateURL, TemplateId o StackArn.	acs:ros:cn-hangzhou:175458000000**:stack/4a65f506-c3cc-43b6-af06-3f000000**

Parámetros comunes.

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	14A07460-EBE7-47CA-9757-12CC4761D47A
StackGroupId	string	El ID del grupo de pilas.	2c036e78-9e82-428e-afd6-177f5d04****

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.