Todos os produtos
Search
Central de documentação

Resource Orchestration Service:Estruturas de dados

Última atualização: Jun 27, 2026

Os conjuntos de alterações contêm mudanças em JSON que descrevem como o ROS modifica uma pilha. Use esses conjuntos para visualizar o impacto antes de aplicar as modificações.

Elementos nas alterações JSON

As alterações JSON de um conjunto de mudanças incluem os elementos a seguir, detalhados na seção de estruturas de dados abaixo.

  • Change: a operação de alteração, incluindo o tipo de mudança e a entidade de destino.

  • ResourceChange: o recurso a alterar, abrangendo nome, tipo e operação do recurso.

  • ResourceChangeDetail: detalhes da alteração do recurso, incluindo propriedades e status do recurso antes e depois da mudança.

  • ResourceTargetDefinition: a definição do recurso alvo, contendo propriedades e configurações.

  • ResourcePropertyChange: detalhes das alterações no nível da propriedade, com os valores anteriores e posteriores à mudança.

  • ModuleInfo: informações do módulo para recursos criados a partir de módulos.

Estruturas de dados das alterações JSON

Change

Parâmetro

Tipo

Descrição

ResourceChange

Structure

O recurso a alterar e a operação a executar.

Type

String

O tipo da entidade.

Defina como Resource, o que indica que a entidade é um recurso.

ResourceChange

Parâmetro

Tipo

Descrição

Action

String

A operação a executar no recurso. Valores válidos:

  • Add: cria o recurso.

  • Modify: modifique o recurso.

  • Remove: libera o recurso.

Details

Array

Os detalhes da alteração. Tem efeito apenas quando Action está definido como Modify.

Nota

Disponível somente para pilhas do tipo ROS.

LogicalResourceId

String

O ID lógico do recurso, correspondente ao nome do recurso definido no modelo.

PhysicalResourceId

String

O ID físico do recurso. Tem efeito apenas quando Action está definido como Modify ou Remove.

Replacement

String

Indica se o ROS substitui o recurso criando um novo e excluindo o existente. Tem efeito apenas quando Action está definido como Modify.

  • Valores válidos para pilhas do tipo ROS:

    • True: o ROS substitui o recurso. Obrigatório quando RequiresRecreation é Always e Evaluation é Static.

    • False: o ROS não substitui o recurso. Obrigatório quando RequiresRecreation é Never e Evaluation é Static.

    • Conditional: o ROS pode substituir o recurso. Obrigatório quando RequiresRecreation é Always e Evaluation é Dynamic.

    Nota

    Quando vários valores de RequiresRecreation se aplicam, o Replacement é determinado pelo valor de maior impacto. Ordem de impacto: Always > Conditional > Never.

  • Valores válidos para pilhas do tipo Terraform:

    • True: o Terraform substitui o recurso.

    • False: o Terraform não substitui o recurso.

ResourceType

String

O tipo do recurso.

Scope

Array de strings

O atributo que aciona uma atualização. Tem efeito apenas quando Action está definido como Modify. Valores válidos:

  • Properties: o parâmetro Properties do recurso

  • Metadata: o parâmetro Metadata do recurso

  • DeletionPolicy: o parâmetro DeletionPolicy do recurso

Nota

Disponível somente para pilhas do tipo ROS.

PropertyChanges

Array de estruturas ResourcePropertyChange

Alterações no nível da propriedade. Tem efeito apenas quando Action está definido como Modify. ResourcePropertyChange.

Nota

Disponível somente para pilhas do tipo Terraform.

ModuleInfo

Array de estruturas ModuleInfo

Informações do módulo para o recurso. Retornado apenas se o recurso for criado a partir de módulos. ModuleInfo.

Nota

Disponível somente para pilhas do tipo ROS.

ResourceChangeDetail

Parâmetro

Tipo

Descrição

ChangeSource

String

O gatilho da atualização. Valores válidos:

  • ResourceReference: o ID físico do recurso referenciado pode mudar.

  • ParameterReference: um parâmetro de modelo referenciado pode mudar.

  • ResourceAttribute: uma propriedade de saída de recurso referenciada pode mudar.

  • DirectModification: o modelo foi modificado diretamente.

  • Automatic: para pilhas aninhadas não modificadas (ALIYUN::ROS::Stack), o ROS define ChangeSource como Automatic porque o modelo aninhado pode ter mudado. O ROS não atualiza o modelo aninhado até que a pilha pai seja atualizada.

  • System: mecanismos internos (como ALIYUN::ROS::WaitConditionHandle) acionam uma atualização independentemente de mudanças na entrada.

CausingEntity

String

A entidade associada a ChangeSource. O mapeamento entre os valores de ChangeSource e CausingEntity:

  • ResourceReference: o nome do recurso.

  • ParameterReference: o nome do parâmetro.

  • ResourceAttribute: no formato Nome do recurso.Nome do parâmetro.

  • DirectModification: nulo.

  • Automatic: o nome do recurso.

  • System: o nome do recurso.

Evaluation

String

Indica se o ROS consegue determinar o valor alvo antes da execução do conjunto de alterações. Valores válidos:

  • Static: o ROS consegue determinar o valor alvo antes da execução.

  • Dynamic: o ROS não consegue determinar o valor alvo. O valor pode depender de funções intrínsecas como Ref ou Fn::GetAtt.

Target

Structure

A entidade que aciona a atualização.

ResourceTargetDefinition

Parâmetro

Tipo

Descrição

Attribute

String

O atributo que aciona a atualização. Valores válidos:

  • Properties: o parâmetro Properties do recurso

  • Metadata: o parâmetro Metadata do recurso

  • DeletionPolicy: o parâmetro DeletionPolicy do recurso

Name

String

Quando Attribute é Properties, Name corresponde ao nome da propriedade. Caso contrário, Name é null.

RequiresRecreation

String

Indica se a alteração desta propriedade recria o recurso. Tem efeito apenas quando Attribute é Properties. Valores válidos:

  • Never: a alteração da propriedade não exige recriação.

  • Conditionally: a alteração da propriedade pode exigir recriação.

  • Always: a alteração da propriedade sempre exige recriação.

ResourcePropertyChange

Parâmetro

Tipo

Descrição

Name

String.

O nome da propriedade.

BeforeValue

O tipo de dados varia conforme a propriedade.

O valor da propriedade antes da atualização.

AfterValue

O tipo de dados varia conforme a propriedade.

O valor da propriedade após a atualização.

Nota
  • Se o valor for <known_after_apply> (tipo String), ele estará disponível somente após a criação ou atualização.

  • Se o valor for <sensitive> (tipo String), ele contém dados sensíveis.

ModuleInfo

Parâmetro

Tipo

Descrição

LogicalIdHierarchy

String

Os IDs lógicos dos módulos que contêm o recurso, concatenados do mais externo para o mais interno e separados por barras (/).

Exemplo: um recurso criado a partir do Módulo B aninhado no Módulo A:

moduleA/moduleB

TypeHierarchy

String

Os tipos dos módulos que contêm o recurso, concatenados do mais externo para o mais interno e separados por barras (/).

Exemplo: um recurso de MODULE::ROS::Child::Example aninhado em MODULE::ROS::Parent::Example:

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

Referências

Para visualizar as alterações JSON em um conjunto de mudanças, consulte Visualizar um conjunto de alterações.