Estructuras de datos - Resource Orchestration Service - Centro de documentación de Alibaba Cloud

Los conjuntos de cambios contienen modificaciones en formato JSON que describen cómo ROS modifica una pila. Use los conjuntos de cambios para previsualizar el impacto antes de aplicar las modificaciones.

Elementos en los cambios JSON

Los cambios JSON de un conjunto de cambios constan de los siguientes elementos, detallados en la sección de estructuras de datos a continuación.

Change: la operación de cambio, incluido el tipo de cambio y la entidad destino.
ResourceChange: el recurso por modificar, incluidos su nombre, tipo y operación.
ResourceChangeDetail: detalles del cambio de recurso, incluidas las propiedades y el estado del recurso antes y después del cambio.
ResourceTargetDefinition: definición del recurso destino, incluidas sus propiedades y configuraciones.
ResourcePropertyChange: detalles del cambio de propiedad, incluidos los valores antes y después de la modificación.
ModuleInfo: información del módulo para recursos creados a partir de módulos.

Estructuras de datos de los cambios JSON

Change

Parámetro

Tipo

Descripción

ResourceChange

Structure

El recurso por modificar y la operación por ejecutar.

Type

String

El tipo de entidad.

Establezca este valor en Resource, lo cual indica que la entidad es un recurso.

ResourceChange

Parámetro	Tipo	Descripción
Action	String	La operación por ejecutar en el recurso. Valores válidos: `Add`: crea el recurso. `Modify`: modifique el recurso. `Remove`: eliminar/quitar el recurso.
Details	Array	Los detalles del cambio. Solo surte efecto cuando `Action` se establece en `Modify`. Nota Disponible solo para pilas de tipo ROS.
LogicalResourceId	String	El ID lógico del recurso, que corresponde al nombre definido en la plantilla.
PhysicalResourceId	String	El ID físico del recurso. Solo surte efecto cuando `Action` se establece en `Modify` o `Remove`.
Replacement	String	Indica si ROS reemplaza el recurso mediante la creación de uno nuevo y la eliminación del existente. Solo surte efecto cuando `Action` se establece en `Modify`. Valores válidos para pilas de tipo ROS: `True`: ROS reemplaza el recurso. Obligatorio cuando `RequiresRecreation` es `Always` y `Evaluation` es `Static`. `False`: ROS no reemplaza el recurso. Obligatorio cuando RequiresRecreation es Never y Evaluation es Static. `Conditional`: ROS podría reemplazar el recurso. Obligatorio cuando `RequiresRecreation` es `Always` y `Evaluation` es `Dynamic`. Nota Cuando aplican varios valores de `RequiresRecreation`, `Replacement` se determina según el valor de mayor impacto. Orden de impacto: `Always` > `Conditional` > `Never`. Valores válidos para pilas de tipo Terraform: `True`: Terraform reemplaza el recurso. `False`: Terraform no reemplaza el recurso.
ResourceType	String	El tipo de recurso.
Scope	Arreglo de cadenas	El atributo que desencadena una actualización. Solo surte efecto cuando `Action` se establece en `Modify`. Valores válidos: `Properties`: el parámetro Properties del recurso. `Metadata`: el parámetro Metadata del recurso. `DeletionPolicy`: el parámetro DeletionPolicy del recurso. Nota Disponible solo para pilas de tipo ROS.
PropertyChanges	Arreglo de estructuras ResourcePropertyChange	Cambios de propiedad. Solo surte efecto cuando `Action` se establece en `Modify`. ResourcePropertyChange. Nota Disponible solo para pilas de tipo Terraform.
ModuleInfo	Arreglo de estructuras ModuleInfo	Información del módulo correspondiente al recurso. Se devuelve únicamente si el recurso se creó a partir de módulos. ModuleInfo. Nota Disponible solo para pilas de tipo ROS.

ResourceChangeDetail

Parámetro	Tipo	Descripción
ChangeSource	String	El desencadenante de la actualización. Valores válidos: `ResourceReference`: el ID físico del recurso referenciado podría cambiar. `ParameterReference`: un parámetro de plantilla referenciado podría cambiar. `ResourceAttribute`: una propiedad de salida del recurso referenciado podría cambiar. `DirectModification`: la plantilla se modificó directamente. `Automatic`: para pilas anidadas sin modificaciones (`ALIYUN::ROS::Stack`), ROS establece `ChangeSource` en `Automatic` porque la plantilla anidada podría haber cambiado. ROS no actualice la plantilla anidada hasta que se actualice la pila principal. `System`: mecanismos internos (como `ALIYUN::ROS::WaitConditionHandle`) desencadenan una actualización independientemente de los cambios en los datos de entrada.
CausingEntity	String	La entidad asociada con `ChangeSource`. La asignación entre los valores de ChangeSource y CausingEntity es la siguiente: `ResourceReference`: el nombre del recurso. `ParameterReference`: el nombre del parámetro. `ResourceAttribute`: en el formato `Nombre del recurso.Nombre del parámetro`. `DirectModification`: null. `Automatic`: el nombre del recurso. `System`: el nombre del recurso.
Evaluation	String	Indica si ROS puede determinar el valor destino antes de ejecutar el conjunto de cambios. Valores válidos: `Static`: ROS puede determinar el valor destino antes de la ejecución. `Dynamic`: ROS no puede determinar el valor destino. El valor podría depender de funciones intrínsecas como `Ref` o `Fn::GetAtt`.
Target	Structure	La entidad que desencadena la actualización.

ResourceTargetDefinition

Parámetro	Tipo	Descripción
Attribute	String	El atributo que desencadena la actualización. Valores válidos: `Properties`: el parámetro Properties del recurso. `Metadata`: el parámetro Metadata del recurso. `DeletionPolicy`: el parámetro DeletionPolicy del recurso.
Name	String	Cuando `Attribute` es `Properties`, Name corresponde al nombre de la propiedad. En caso contrario, Name es `null`.
RequiresRecreation	String	Indica si el cambio de esta propiedad recrea el recurso. Solo surte efecto cuando `Attribute` es `Properties`. Valores válidos: `Never`: el cambio de propiedad no requiere recreación. `Conditionally`: el cambio de propiedad podría requerir recreación. `Always`: el cambio de propiedad siempre requiere recreación.

ResourcePropertyChange

Parámetro	Tipo	Descripción
Name	String.	El nombre de la propiedad.
BeforeValue	El tipo de datos varía según la propiedad.	El valor de la propiedad antes de la actualización.
AfterValue	El tipo de datos varía según la propiedad.	El valor de la propiedad después de la actualización. Nota Si el valor es `<known_after_apply>` (tipo String), el valor estará disponible solo después de la creación o actualización. Si el valor es `<sensitive>` (tipo String), el valor contiene datos confidenciales.

ModuleInfo

Parámetro

Tipo

Descripción

LogicalIdHierarchy

String

Los ID lógicos de los módulos que contienen el recurso, concatenados desde el más externo al más interno y separados por barras diagonales (/).

Ejemplo: un recurso creado desde el Módulo B anidado en el Módulo A:

moduleA/moduleB

TypeHierarchy

String

Los tipos de los módulos que contienen el recurso, concatenados desde el más externo al más interno y separados por barras diagonales (/).

Ejemplo: un recurso de MODULE::ROS::Child::Example anidado en MODULE::ROS::Parent::Example:

MODULE::ROS::Parent::Example/MODULE::ROS::Child::Example

Referencias

Para consultar los cambios JSON en un conjunto de cambios, siga View a change set.