:CreateChangeSet

La operación que desea ejecutar. Establezca el valor en CreateChangeSet.

El ID de la pila para la cual desea crear el conjunto de cambios. ROS compara la información de la pila con los datos que usted especifique, como una plantilla modificada o un valor de parámetro cambiado, para generar el conjunto de cambios.

La URL del archivo que contiene la política de la pila. La URL debe apuntar a una política ubicada en un servidor web HTTP o HTTPS, o en un bucket de Object Storage Service (OSS), por ejemplo, oss://ros/stack-policy/demo u oss://ros/stack-policy/demo?RegionId=cn-hangzhou. El archivo de política puede tener una longitud máxima de 16,384 bytes.

Puede especificar el parámetro StackPolicyBody o StackPolicyURL.

La URL puede tener una longitud máxima de 1,350 bytes.

Si establece el parámetro ChangeSetType en CREATE, puede especificar el parámetro StackPolicyBody o StackPolicyURL. Si establece el parámetro ChangeSetType en UPDATE, solo puede especificar uno de a continuación parámetros:

• StackPolicyBody
• StackPolicyURL
• StackPolicyDuringUpdateBody
• StackPolicyDuringUpdateURL

La estructura que contiene el cuerpo de la política de la pila. El cuerpo de la política debe tener una longitud de 1 a 16,384 bytes. Si establece el parámetro ChangeSetType en CREATE, puede especificar el parámetro StackPolicyBody o StackPolicyURL. Si establece el parámetro ChangeSetType en UPDATE, solo puede especificar uno de a continuación parámetros:

• StackPolicyBody
• StackPolicyURL
• StackPolicyDuringUpdateBody
• StackPolicyDuringUpdateURL

El nombre de la pila para la cual desea crear el conjunto de cambios.

El nombre puede tener una longitud máxima de 255 caracteres y contener dígitos, letras, guiones (-) y guiones bajos (_). Debe comenzar con un dígito o una letra.

Especifica si se deben usar los valores indicados en la solicitud anterior para los parámetros que no se especifiquen en la solicitud actual. Valor predeterminado: false. Valores válidos:

• true
• false

El tipo de conjunto de cambios. Valor predeterminado: UPDATE. Valores válidos:

• CREATE: cree un conjunto de cambios para una nueva pila.
• UPDATE: cree un conjunto de cambios para una pila existente.
• IMPORT: cree un conjunto de cambios para una pila nueva o existente con el fin de importar recursos que no administra ROS.

Si cree un conjunto de cambios para una nueva pila, ROS genera un ID único para dicha pila. La pila permanece en el estado REVIEW_IN_PROGRESS hasta que ejecute el conjunto de cambios.

No puede usar el tipo UPDATE para crear un conjunto de cambios para una pila nueva, ni el tipo CREATE para una pila existente.

La descripción del conjunto de cambios. Puede tener una longitud máxima de 1,024 bytes.

El ID de región del conjunto de cambios. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.

El token de cliente que se usa para garantizar la idempotencia de la solicitud. Puede usar el cliente para generar el valor, pero debe asegurarse de que sea único entre distintas solicitudes.

El token puede tener una longitud máxima de 64 caracteres y contener letras, dígitos, guiones (-) y guiones bajos (_).

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

La URL del archivo que contiene el cuerpo de la plantilla. La URL debe apuntar a una plantilla ubicada en un servidor web HTTP o HTTPS, o en un bucket de OSS, por ejemplo, oss://ros/template/demo u oss://ros/template/demo?RegionId=cn-hangzhou. El cuerpo de la plantilla puede tener una longitud máxima de 524,288 bytes.

Solo puede especificar uno de a continuación parámetros: TemplateBody, TemplateURL y TemplateId.

La URL puede tener una longitud máxima de 1,024 bytes.

La URL del archivo que contiene la política de anulación temporal de la pila. La URL debe apuntar a una política ubicada en un servidor web HTTP o HTTPS, o en un bucket de OSS, por ejemplo, oss://ros/stack-policy/demo u oss://ros/stack-policy/demo?RegionId=cn-hangzhou. El archivo de política puede tener una longitud máxima de 16,384 bytes.

La URL puede tener una longitud máxima de 1,350 bytes.

Si desea actualizar recursos protegidos, especifique una política de anulación temporal para dichos recursos durante la actualización. Si no especifica la política, se usa la política existente asociada a la pila. Este parámetro solo surte efecto cuando el parámetro ChangeSetType se establece en UPDATE. Solo puede especificar uno de a continuación parámetros:

• StackPolicyBody
• StackPolicyURL
• StackPolicyDuringUpdateBody
• StackPolicyDuringUpdateURL

La estructura que contiene el cuerpo de la plantilla. El cuerpo de la plantilla debe tener una longitud de 1 a 524,288 bytes.

Si la longitud del cuerpo de la plantilla excede el límite máximo, le recomendamos agregar parámetros al cuerpo de la solicitud HTTP POST para evitar fallos causados por URL excesivamente largas.

Solo puede especificar uno de a continuación parámetros: TemplateBody, TemplateURL y TemplateId.

El tiempo que puede transcurrir antes de que la pila entre en el estado CREATE_FAILED o UPDATE_FAILED.

Si establece el parámetro ChangeSetType en CREATE, este parámetro es obligatorio. Si lo establece en UPDATE, el parámetro es opcional.

• Unidad: minutos.
• Valores válidos: de 10 a 1440.
• Valor predeterminado: 60.

Especifica si se debe deshabilitar la reversión cuando falla la creación de la pila.

Valor predeterminado: false. Valores válidos:

• true
• false

El nombre del conjunto de cambios.

El nombre puede tener una longitud máxima de 255 caracteres y contener dígitos, letras, guiones (-) y guiones bajos (_). Debe comenzar con un dígito o una letra.

La estructura que contiene el cuerpo de la política de anulación temporal de la pila. El cuerpo de la política debe tener una longitud de 1 a 16,384 bytes.

Si desea actualizar recursos protegidos, especifique una política de anulación temporal para dichos recursos durante la actualización. Si no especifica la política, se usa la política de pila existente asociada a la pila.

Este parámetro solo surte efecto cuando el parámetro ChangeSetType se establece en UPDATE. Solo puede especificar uno de a continuación parámetros:

• StackPolicyBody
• StackPolicyURL
• StackPolicyDuringUpdateBody
• StackPolicyDuringUpdateURL

El nombre del rol de RAM. ROS asume el rol de RAM para crear la pila y usa las credenciales del rol para llamar a las API de los servicios de Alibaba Cloud.

ROS asume el rol de RAM para realizar operaciones en la pila. Si tiene permisos para operar en la pila pero no para usar el rol de RAM, ROS asumirá el rol de todos modos. Debe asegurarse de otorgar al rol de RAM únicamente los privilegios mínimos necesarios.

Si no especifica este parámetro, ROS asume el rol de RAM existente asociado a la pila. Si no hay roles de RAM disponibles, ROS usa una credencial temporal generada a partir de las credenciales de su cuenta.

El nombre del rol de RAM puede tener una longitud máxima de 64 bytes.

Especifica si se debe habilitar la actualización por reemplazo si se modifica una propiedad de recurso que no admite cambios directos. En una modificación simple, el ID físico del recurso permanece sin cambios. En una actualización por reemplazo, se elimina el recurso existente, se crea uno nuevo y cambia el ID físico del recurso. Valor predeterminado: Disabled. Valores válidos:

• Enabled
• Disabled

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

Solo puede especificar uno de a continuación parámetros: TemplateBody, TemplateURL y TemplateId.

La versión de la plantilla.

El nombre del parámetro N definido en la plantilla. Si no especifica el nombre y el valor de un parámetro, ROS usa el nombre y el valor predeterminados definidos en la plantilla. Valor máximo de N: 200.

El valor del parámetro N definido en la plantilla. Valor máximo de N: 200.

La URL de devolución de llamada que se usa para recibir el evento de pila N. Valores válidos:

• URL HTTP POST

  Cada URL puede tener una longitud máxima de 1,024 bytes.

• eventbridge

  Cuando cambia el estado de una pila, ROS envía una notificación de evento al servicio EventBridge. Para ver la información del evento, realice a continuación operaciones: Inicie sesión en la consola de EventBridge. En el panel de navegación izquierdo, haga clic en Event Buses.

  Nota ROS admite el servicio EventBridge en a continuación regiones: China (Hangzhou), China (Shanghai), China (Beijing), China (Hong Kong) y China (Zhangjiakou).

Valor máximo de N: 5. Cuando cambia el estado de una pila, ROS envía una notificación de evento a la URL especificada. Si la reversión está habilitada para la pila, se envían notificaciones cuando la pila está en estado CREATE_ROLLBACK o ROLLBACK, pero no se envían si está en estado CREATE_FAILED, UPDATE_FAILED o IN_PROGRESS.

ROS envía notificaciones de eventos independientemente de si configura la sección Outputs. A continuación código de muestra proporciona un ejemplo del contenido de una notificación de evento:

{
    "Outputs": [
        {
            "Description": "No description given",
            "OutputKey": "InstanceId",
            "OutputValue": "i-xxx"
        }
    ],
    "StackId": "80bd6b6c-e888-4573-ae3b-93d29113****",
    "StackName": "test-notification-url",
    "Status": "CREATE_COMPLETE"
}
                                    

La asignación de pares clave-valor entre cadenas. El valor es una cadena JSON que identifica el recurso N que se va a importar.

Una clave es un identificador para un recurso y un valor es una asignación de datos a dicha clave. Por ejemplo, VpcId es una clave que especifica el ID de una nube privada virtual (VPC), y vpc-2zevx9ios**** es un valor asignado a VpcId. Puede llamar a la operación GetTemplateSummary para obtener la clave de un recurso.

El ID lógico del recurso N que desea importar. El ID lógico especifica el nombre de un recurso definido en la plantilla.

El tipo de recurso N que desea importar. El tipo de recurso debe coincidir con el tipo definido en la plantilla.

El ID de la plantilla de escenario.

El número máximo de operaciones simultáneas que se pueden ejecutar en los recursos. De forma predeterminada, este parámetro está vacío. Puede establecerlo en un entero mayor o igual a 0. Si le asigna un valor específico, ROS asocia dicho valor con la pila, lo cual puede afectar a operaciones posteriores.

Este parámetro solo surte efecto cuando el parámetro ChangeSetType se establece en CREATE o UPDATE. Valores válidos:

• Valores válidos para conjuntos de cambios de tipo CREATE:
  • Si establece este parámetro en un entero mayor que 0, se usa dicho entero.
  • Si lo establece en 0 o deja el parámetro vacío, no se impone ningún límite a las pilas de ROS. Sin embargo, para las pilas de Terraform se usa el valor predeterminado de Terraform, que generalmente es 10.
• Valores válidos para conjuntos de cambios de tipo UPDATE:
  • Si establece este parámetro en un entero mayor que 0, se usa dicho entero.
  • Si lo establece en 0, no se impone ningún límite a las pilas de ROS. Sin embargo, para las pilas de Terraform se usa el valor predeterminado de Terraform, que generalmente es 10.
  • Si deja este parámetro vacío, se usa el valor que especificó en la solicitud anterior. Si también lo dejó vacío anteriormente, no se impone ningún límite a las pilas de ROS. Sin embargo, para las pilas de Terraform se usa el valor predeterminado de Terraform, que generalmente es 10.