Todos los productos
Search
Centro de documentos

:UpdateStackGroup

Última actualización: Sep 05, 2026

Actualice un grupo de pilas.

En este ejemplo, se especifica el contenido de plantilla {"ROSTemplateFormatVersion": "2015-09-01"} para actualizar un grupo de pilas llamado MyStackGroup. Al grupo de pilas se le otorgan permisos autogestionados y se despliega en la región China (Hangzhou).

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, se recomienda invocar esta operación desde OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para distintos SDK.

Parámetros de solicitud

Parámetro Tipo Obligatorio Ejemplo Descripción
Action String Sí UpdateStackGroup

Operación que se desea ejecutar. Establezca el valor en UpdateStackGroup.

RegionId String Sí cn-hangzhou

Identificador de la región del grupo de pilas. Llame a la operación DescribeRegions para consultar la lista más reciente de regiones de Alibaba Cloud.

StackGroupName String Sí MyStackGroup

Nombre del grupo de pilas. Debe ser único dentro de una región.

El nombre puede tener hasta 255 caracteres e incluir dígitos, letras, guiones (-) y guiones bajos (_). Debe comenzar con un dígito o una letra.

Description String No My Stack Group

Descripción del grupo de pilas.

La descripción debe tener entre 1 y 256 caracteres.

AccountIds Array of String No ["151266687691****","141261387191****"]

Identificadores de las cuentas donde desea usar permisos autogestionados para desplegar pilas. Especifique como máximo 20 identificadores de cuenta.

RegionIds Array of String No ["cn-hangzhou","cn-beijing"]

Identificadores de región de las instancias de pila. Especifique como máximo 20 identificadores de región.

TemplateBody String No {"ROSTemplateFormatVersion": "2015-09-01"}

Estructura que contiene el cuerpo de la plantilla. Este debe tener entre 1 y 524,288 bytes. Si supera el límite superior, agregue los parámetros al cuerpo de la solicitud HTTP POST para evitar fallos por URL demasiado largas.

Nota Especifique únicamente uno de los parámetros TemplateBody, TemplateURL o TemplateId.
TemplateURL String No oss://ros-template/demo

URL del archivo que contiene el cuerpo de la plantilla. Debe apuntar a una plantilla alojada en un servidor web HTTP o HTTPS, o bien en un bucket de Object Storage Service (OSS) de Alibaba Cloud. El cuerpo de la plantilla debe tener entre 1 y 524,288 bytes. Ejemplos: oss://ros/template/demo y oss://ros/template/demo?RegionId=cn-hangzhou. Si no especifica el identificador de región del bucket de OSS, se utiliza el valor del parámetro RegionId.

Nota Especifique únicamente uno de los parámetros TemplateBody, TemplateURL o TemplateId.
ClientToken String No 123e4567-e89b-12d3-a456-42665544****

Token de cliente que se usa para garantizar la idempotencia de la solicitud. Genere el valor desde el cliente, pero asegúrese de que el token sea único entre distintas solicitudes.

El token puede tener hasta 64 caracteres e incluir letras, dígitos, guiones (-) y guiones bajos (_).

Para obtener más información, consulte Garantizar la idempotencia.

OperationDescription String No Update stack instances in hangzhou

Descripción de la operación para actualizar el grupo de pilas.

OperationPreferences Map No {"FailureToleranceCount": 1,"MaxConcurrentCount": 2}

Preferencias de la operación para actualizar el grupo de pilas.

A continuación se muestran los parámetros disponibles:

  • {"FailureToleranceCount": N}

    Número máximo de cuentas donde se permiten fallos en la operación de pila por cada región. Si se supera este valor en una región, ROS detiene la operación en dicha región. Cuando ROS detiene la operación en una región, no la ejecuta en las demás.

    Valores válidos de N: de 0 a 20.

    Si no especifica un valor para FailureToleranceCount, se aplica el valor predeterminado 0.

  • {"FailureTolerancePercentage": N}

    Porcentaje de cuentas donde se permiten fallos en la operación de pila por cada región. Si se supera este valor en una región, ROS detiene la operación en dicha región.

    Valores válidos de N: de 0 a 100. Si el número de cuentas indicado por el porcentaje no es entero, ROS lo redondea hacia abajo.

    Si no especifica un valor para FailureTolerancePercentage, se aplica el valor predeterminado 0.

  • {"MaxConcurrentCount": N}

    Número máximo de cuentas donde se pueden desplegar pilas simultáneamente en cada región.

    Valores válidos de N: de 1 a 20.

    Si no especifica un valor para MaxConcurrentCount, se aplica el valor predeterminado 1.

  • {"MaxConcurrentPercentage": N}

    Porcentaje de cuentas donde se pueden desplegar pilas simultáneamente en cada región.

    Valores válidos de N: de 1 a 100. Si el número de cuentas indicado por el porcentaje no es entero, ROS lo redondea hacia abajo.

    Si no especifica un valor para MaxConcurrentPercentage, se aplica el valor predeterminado 1.

  • {"RegionConcurrencyType": N}

    Indica si las pilas se pueden desplegar en paralelo en varias regiones. Valores válidos:

    • SEQUENTIAL: despliega las pilas en las regiones especificadas de forma secuencial, una por una. Así, solo se despliegan pilas en una región a la vez. Este es el valor predeterminado.
    • PARALLEL: despliega las pilas en todas las regiones especificadas de forma paralela.

Separe varios parámetros con comas (,).

Nota
  • Especifique únicamente uno de los parámetros MaxConcurrentCount o MaxConcurrentPercentage.
  • Especifique únicamente uno de los parámetros FailureToleranceCount o FailureTolerancePercentage.
AdministrationRoleName String No AliyunROSStackGroupAdministrationRole

Nombre del rol de RAM que asumirá la cuenta administradora en ROS. Este parámetro es obligatorio si desea otorgar permisos autogestionados al grupo de pilas. Si no especifica un valor, se utiliza el valor predeterminado AliyunROSStackGroupAdministrationRole. Con el rol de administrador en ROS, asuma el rol de ejecución AliyunROSStackGroupExecutionRole para operar las pilas correspondientes a las instancias de pila del grupo.

El nombre debe tener entre 1 y 64 caracteres e incluir letras, dígitos y guiones (-).

ExecutionRoleName String No AliyunROSStackGroupExecutionRole

Nombre del rol de RAM que asumirá el rol de administrador AliyunROSStackGroupAdministrationRole. Este parámetro es obligatorio si desea otorgar permisos autogestionados al grupo de pilas. Si no especifica un valor, se utiliza el valor predeterminado AliyunROSStackGroupExecutionRole. Con este rol en ROS, opere las pilas correspondientes a las instancias de pila del grupo.

El nombre debe tener entre 1 y 64 caracteres e incluir letras, dígitos y guiones (-).

TemplateId String No 5ecd1e10-b0e9-4389-a565-e4c15efc****

Identificador de la plantilla. Este parámetro aplica tanto a plantillas compartidas como privadas.

Nota Especifique únicamente uno de los parámetros TemplateBody, TemplateURL o TemplateId.
TemplateVersion String No v1

Versión de la plantilla. Si no especifica una versión, se utiliza la más reciente.

Nota Este parámetro solo surte efecto cuando se establece el parámetro TemplateId.
PermissionModel String No SELF_MANAGED

Modelo de permisos.

Valores válidos:

  • SELF_MANAGED: modelo de permisos autogestionados. Este es el valor predeterminado. Si utiliza este modelo para el grupo de pilas, cree roles de RAM para las cuentas administradora y de ejecución, además de establecer una relación de confianza entre ambas para desplegar pilas dentro de la cuenta de ejecución.
  • SERVICE_MANAGED: modelo de permisos gestionados por el servicio. Si utiliza este modelo para el grupo de pilas, ROS crea roles vinculados al servicio para las cuentas administradora y de ejecución. La cuenta administradora usa su rol para desplegar pilas dentro de la cuenta de ejecución.
Nota
  • Si ya se crearon instancias de pila en el grupo de pilas, no es posible cambiar el modo de permisos del grupo.
  • Si desea usar el modelo de permisos gestionados por el servicio para desplegar pilas, su cuenta debe ser la cuenta administradora o una cuenta administradora delegada de su directorio de recursos, y la función de acceso de confianza debe estar habilitada para dicha cuenta. Para obtener más información, consulte Paso 1: (Opcional) Crear una cuenta administradora delegada y Paso 2: Habilitar el acceso de confianza.
AutoDeployment Object No

Información sobre la configuración de despliegue automático.

Nota Este parámetro es obligatorio únicamente cuando el parámetro PermissionModel se establece en SERVICE_MANAGED.
Enabled Boolean Sí true

Indica si se habilita el despliegue automático.

Valores válidos:

  • true: habilita el despliegue automático. Si agrega un miembro a la carpeta a la que pertenece el grupo de pilas después de habilitar esta opción, el grupo despliega sus instancias de pila dentro de dicho miembro. Si quita un miembro de la carpeta, el grupo elimina las instancias de pila desplegadas en ese miembro.
  • false: deshabilita el despliegue automático. Una vez deshabilitado, las instancias de pila permanecen sin cambios aunque los miembros de la carpeta cambien.
RetainStacksOnAccountRemoval Boolean No true

Indica si se conservan las pilas de un miembro cuando se quita dicho miembro de la carpeta.

Valores válidos:

  • true: conserva las pilas.
  • false: elimina las pilas.
Nota Este parámetro es obligatorio cuando el parámetro Enabled se establece en true.
DeploymentTargets Object No

Carpetas donde desea usar permisos gestionados por el servicio para actualizar pilas.

RdFolderIds Array of String No ["fd-4PvlVLOL8v"]

Identificadores de carpeta en el directorio de recursos. Especifique como máximo cinco identificadores de carpeta.

Establezca como mínimo uno de los parámetros RdFolderIds o AccountIds. Estos parámetros están sujetos a las siguientes condiciones:

  • Si solo establece el parámetro RdFolderIds, las pilas se despliegan en todos los miembros de las carpetas especificadas. Si indica la carpeta Root, ROS despliega las pilas en todos los miembros del directorio de recursos.
  • Si solo establece el parámetro AccountIds, las pilas se despliegan en los miembros especificados.
  • Si establece ambos parámetros, las cuentas indicadas en AccountIds deben pertenecer a las carpetas indicadas en RdFolderIds.
Nota Para consultar los identificadores de carpeta, vaya a la página Overview en la consola de Resource Management. Para obtener más información, consulte Consultar la información básica de una carpeta.
AccountIds Array of String No ["151266687691****","141261387191****"]

Identificadores de los miembros en el directorio de recursos. Especifique como máximo 20 identificadores de miembro.

Nota Para consultar los identificadores de miembro, vaya a la página Overview en la consola de Resource Management. Para obtener más información, consulte Consultar la información detallada de un miembro.
Parameters.N.ParameterKey String Sí Amount

Clave del parámetro N. Si no especifica la clave ni el valor del parámetro, ROS utiliza la clave y el valor predeterminados de la plantilla.

Valor máximo de N: 200.

Nota El parámetro Parameters es opcional. Si lo establece, configure el parámetro Parameters.N.ParameterKey.
Parameters.N.ParameterValue String Sí 1

Valor del parámetro N.

Valor máximo de N: 200.

Nota El parámetro Parameters es opcional. Si lo establece, configure el parámetro Parameters.N.ParameterValue.

Para obtener más información sobre los parámetros de solicitud comunes, consulte Parámetros comunes.

Parámetros de respuesta

Parámetro

Tipo

Ejemplo

Descripción

RequestId

String

14A07460-EBE7-47CA-9757-12CC4761D47A

Identificador de la solicitud.

OperationId

String

6da106ca-1784-4a6f-a7e1-e723863d****

Identificador de la operación.

Ejemplos

Solicitudes de ejemplo

http(s)://ros.aliyuncs.com/?Action=UpdateStackGroup
&TemplateBody={"ROSTemplateFormatVersion": "2015-09-01"}
&RegionId=cn-hangzhou
&StackGroupName=MyStackGroup
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<UpdateStackGroupResponse>
    <RequestId>14A07460-EBE7-47CA-9757-12CC4761D47A</RequestId>
    <OperationId>6da106ca-1784-4a6f-a7e1-e723863d****</OperationId>
</UpdateStackGroupResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

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

Códigos de error

Para consultar la lista de códigos de error, visite el centro de errores de API.

Código de error

Mensaje de error

Código de estado HTTP

Descripción

CircularDependency

Circular Dependency Found: {reason}.

400

Error devuelto porque la plantilla contiene dependencias circulares. reason indica la causa específica del error.

InvalidSchema

{reason}.

400

Error devuelto porque el formato de la plantilla no es válido. reason indica la causa específica del error.

InvalidTemplateAttribute

The Referenced Attribute ({resource} {name}) is incorrect.

400

Error devuelto porque el atributo de recurso referenciado en la plantilla no es válido. resource indica el nombre del recurso y name indica el nombre del atributo.

InvalidTemplatePropertyType

The specified value type of ({resource} {section}) is incorrect.

400

Error devuelto porque el tipo de sección de recurso definido en la plantilla no es válido. resource indica el nombre del recurso y section indica el nombre de la sección.

InvalidTemplateReference

The specified reference "{name}" (in {referencer}) is incorrect.

400

Error devuelto porque la plantilla contiene una referencia no válida. name indica el nombre de la referencia y referencer indica el nombre del elemento que hace la referencia.

InvalidTemplateSection

The template section is invalid: {section}.

400

Error devuelto porque la plantilla contiene una sección no válida. section indica el nombre de la sección.

InvalidTemplateVersion

The template version is invalid: {reason}.

400

Error devuelto porque la versión de la plantilla no es válida. reason indica la causa específica del error.

UnknownUserParameter

The Parameter ({name}) was not defined in template.

400

Error devuelto porque el parámetro especificado no está definido en la plantilla. name indica el nombre del parámetro.

UserParameterMissing

The Parameter {name} was not provided.

400

Error devuelto porque no se especificó ningún valor para el parámetro definido en la plantilla. name indica el nombre del parámetro.

StackGroupOperationInProgress

Another Operation on StackGroup ({name})s is in progress.

409

Error devuelto porque hay otra operación en curso sobre el grupo de pilas. name indica el nombre del grupo de pilas.

TemplateNotFound

The Tempalte ({ ID }) could not be found.

404

Error devuelto porque la plantilla especificada no existe. ID indica el identificador de la plantilla.

TemplateNotFound

The Template { ID } with version { version } could not be found.

404

Error devuelto porque la plantilla o la versión de plantilla especificada no existe. ID indica el identificador de la plantilla y version indica la versión de la plantilla.