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
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:
Separe varios parámetros con comas (,). Nota
|
| 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:
Nota
|
| 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:
|
| RetainStacksOnAccountRemoval | Boolean | No | true | Indica si se conservan las pilas de un miembro cuando se quita dicho miembro de la carpeta. Valores válidos:
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:
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. |