全部产品
Search
文档中心

Resource Orchestration Service:Struktur Data

更新时间:Jun 26, 2025

Anda dapat melihat set perubahan dari sebuah tumpukan untuk memahami dampak perubahan yang akan diterapkan oleh Resource Orchestration Service (ROS) ke tumpukan dengan mengeksekusi set perubahan. Topik ini menjelaskan perubahan JSON yang terkandung dalam set perubahan.

Elemen dalam perubahan JSON

Perubahan JSON dari set perubahan terdiri dari elemen-elemen berikut. Untuk informasi lebih lanjut tentang elemen-elemen tersebut, lihat bagian "Struktur data dari perubahan JSON" dalam topik ini.

  • Change: Detail operasi perubahan yang diminta ROS lakukan, termasuk jenis dan entitas perubahan.

  • ResourceChange: Detail sumber daya yang diminta ROS ubah serta operasi perubahan, mencakup nama sumber daya, jenis sumber daya, dan operasi perubahan.

  • ResourceChangeDetail: Detail perubahan sumber daya, termasuk properti dan status sumber daya sebelum serta sesudah operasi perubahan.

  • ResourceTargetDefinition: Definisi sumber daya yang diminta ROS ubah, mencakup properti dan konfigurasi sumber daya.

  • ResourcePropertyChange: Detail perubahan pada properti sumber daya, termasuk nilai dan nama properti sebelum serta sesudah perubahan.

  • ModuleInfo: Informasi tentang modul.

Struktur data dari perubahan JSON

Change

Parameter

Tipe

Deskripsi

ResourceChange

Struktur

Sumber daya yang ingin Anda minta ROS ubah dan operasi yang ingin Anda minta ROS lakukan pada sumber daya tersebut.

Type

String

Jenis entitas yang ingin Anda minta ROS ubah.

Atur nilainya menjadi Resource. Nilai Resource menentukan bahwa entitas adalah sumber daya.

ResourceChange

Parameter

Tipe

Deskripsi

Action

String

Operasi yang ingin Anda minta ROS lakukan pada sumber daya. Nilai valid:

  • Add: membuat sumber daya.

  • Modify: memodifikasi sumber daya.

  • Remove: melepaskan sumber daya.

Details

Array

Detail perubahan pada sumber daya. Parameter ini hanya berlaku ketika parameter Action diatur ke Modify.

Catatan

Parameter ini hanya tersedia untuk tumpukan bertipe ROS.

LogicalResourceId

String

ID logis dari sumber daya. ID logis adalah nama sumber daya yang didefinisikan dalam template.

PhysicalResourceId

String

ID fisik dari sumber daya. Parameter ini hanya berlaku ketika parameter Action diatur ke Modify atau Remove.

Replacement

String

Menentukan apakah mengubah sumber daya dengan membuat sumber daya baru dan menghapus sumber daya yang ada. Parameter ini hanya berlaku ketika parameter Action diatur ke Modify.

  • Nilai valid untuk tumpukan bertipe ROS:

    • True: ROS mengubah sumber daya dengan membuat sumber daya baru dan menghapus sumber daya yang ada. Jika Anda mengatur parameter RequiresRecreation ke Always dan parameter Evaluation ke Static, Anda harus mengatur parameter Replacement ke True.

    • False: ROS tidak mengubah sumber daya dengan membuat sumber daya baru dan menghapus sumber daya yang ada. Jika Anda mengatur parameter RequiresRecreation ke Never dan parameter Evaluation ke Static, Anda harus mengatur parameter Replacement ke False.

    • Conditional: ROS mungkin mengubah sumber daya dengan membuat sumber daya baru dan menghapus sumber daya yang ada. Jika Anda mengatur parameter RequiresRecreation ke Always dan parameter Evaluation ke Dynamic, Anda harus mengatur parameter Replacement ke Conditional.

    Catatan

    Jika Anda menentukan beberapa nilai untuk parameter RequiresRecreation, nilai parameter Replacement bervariasi berdasarkan nilai RequiresRecreation yang memiliki dampak terbesar. Dampak dari nilai-nilai RequiresRecreation berkurang dalam urutan berikut: Always, Conditional, dan Never.

  • Nilai valid untuk tumpukan bertipe Terraform:

    • True: Terraform mengubah sumber daya dengan membuat sumber daya baru dan menghapus sumber daya yang ada.

    • False: Terraform tidak mengubah sumber daya dengan membuat sumber daya baru dan menghapus sumber daya yang ada.

ResourceType

String

Jenis sumber daya.

Scope

Array of strings

Parameter yang memicu pembaruan oleh ROS. Parameter ini hanya berlaku ketika parameter Action diatur ke Modify. Nilai valid:

  • Properties: parameter Properties dari sumber daya

  • Metadata: parameter Metadata dari sumber daya

  • DeletionPolicy: parameter DeletionPolicy dari sumber daya

Catatan

Parameter ini hanya tersedia untuk tumpukan bertipe ROS.

PropertyChanges

Structure array of ResourcePropertyChange

Perubahan pada properti sumber daya. Parameter ini hanya berlaku ketika parameter Action diatur ke Modify. Untuk informasi lebih lanjut, lihat ResourcePropertyChange.

Catatan

Parameter ini hanya tersedia untuk tumpukan bertipe Terraform.

ModuleInfo

Structure array of ModuleInfo

Informasi tentang modul tempat sumber daya dibuat. Parameter ini dikembalikan hanya jika sumber daya dibuat dari modul. Untuk informasi lebih lanjut, lihat ModuleInfo.

Catatan

Parameter ini hanya tersedia untuk tumpukan bertipe ROS.

ResourceChangeDetail

Parameter

Tipe

Deskripsi

ChangeSource

String

Alasan mengapa ROS memicu pembaruan. Nilai valid:

  • ResourceReference: ID fisik dari sumber daya yang dirujuk mungkin berubah.

  • ParameterReference: parameter yang dirujuk dalam template mungkin berubah.

  • ResourceAttribute: properti keluaran yang dirujuk dari sumber daya mungkin berubah.

  • DirectModification: template dimodifikasi.

  • Automatic: Jika tumpukan bersarang yang dibuat menggunakan tipe sumber daya ALIYUN::ROS::Stack tidak dimodifikasi, ROS mengatur parameter ChangeSource ke Automatic. Ini karena template dari tumpukan bersarang mungkin telah berubah. ROS tidak mengubah template dari tumpukan bersarang sebelum Anda memperbarui tumpukan induk.

  • System: Bahkan jika nilai input dari sumber daya tetap tidak berubah, kondisi tertentu atau mekanisme internal, seperti ALIYUN::ROS::WaitConditionHandle, memicu pembaruan.

CausingEntity

String

Entitas yang terkait dengan parameter ChangeSource. Informasi berikut menjelaskan hubungan antara nilai-nilai parameter ChangeSource dan CausingEntity:

  • Jika Anda mengatur parameter ChangeSource ke ResourceReference, nilai parameter CausingEntity adalah nama sumber daya.

  • Jika Anda mengatur parameter ChangeSource ke ParameterReference, nilai parameter CausingEntity adalah nama parameter.

  • Jika Anda mengatur parameter ChangeSource ke ResourceAttribute, nilai parameter CausingEntity berada dalam format berikut: Nama Sumber Daya.Nama Parameter.

  • Jika Anda mengatur parameter ChangeSource ke DirectModification, nilai parameter CausingEntity adalah null.

  • Jika Anda mengatur parameter ChangeSource ke Automatic, nilai parameter CausingEntity adalah nama sumber daya.

  • Jika Anda mengatur parameter ChangeSource ke System, nilai parameter CausingEntity adalah nama sumber daya.

Evaluation

String

Menentukan apakah ROS dapat menentukan nilai yang diinginkan, dan apakah nilai yang diinginkan berubah sebelum Anda mengeksekusi set perubahan. Nilai valid:

  • Static: ROS dapat menentukan nilai yang diinginkan, dan bahwa nilai yang diinginkan berubah sebelum Anda mengeksekusi set perubahan.

  • Dynamic: ROS tidak dapat menentukan nilai yang diinginkan. Ketika ROS memperbarui tumpukan, nilai yang diinginkan mungkin bervariasi berdasarkan hasil fungsi internal, seperti Ref atau Fn::GetAtt.

Target

Struktur

Detail entitas yang memicu pembaruan oleh ROS.

ResourceTargetDefinition

Parameter

Tipe

Deskripsi

Attribute

String

Parameter yang memicu pembaruan oleh ROS. Nilai valid:

  • Properties: parameter Properties dari sumber daya

  • Metadata: parameter Metadata dari sumber daya

  • DeletionPolicy: parameter DeletionPolicy dari sumber daya

Name

String

Jika Anda mengatur parameter Attribute ke Properties, nilai parameter Name adalah nama properti. Dalam kasus lain, nilai parameter Name adalah null.

RequiresRecreation

String

Menentukan apakah perubahan pada properti menyebabkan sumber daya direkreasi. Parameter ini hanya berlaku ketika parameter Attribute diatur ke Properties. Nilai valid:

  • Never: Perubahan pada properti tidak menyebabkan sumber daya direkreasi.

  • Conditionally: Perubahan pada properti mungkin menyebabkan sumber daya direkreasi.

  • Always: Perubahan pada properti menyebabkan sumber daya direkreasi.

ResourcePropertyChange

Parameter

Tipe

Deskripsi

Name

String.

Nama properti.

BeforeValue

Tipe data bervariasi berdasarkan properti.

Nilai properti sebelum ROS memperbarui properti.

AfterValue

Tipe data bervariasi berdasarkan properti.

Nilai properti setelah properti diperbarui.

Catatan
  • Jika Anda mengatur nilainya ke <known_after_apply> dan nilainya bertipe String, Anda hanya dapat menanyakan nilai tersebut setelah properti dibuat atau diperbarui.

  • Jika Anda mengatur nilainya ke <sensitive> dan nilainya bertipe String, nilai tersebut adalah data sensitif.

ModuleInfo

Parameter

Tipe

Deskripsi

LogicalIdHierarchy

String

ID logis gabungan dari satu atau lebih modul yang berisi sumber daya. Modul-modul tersebut terdaftar mulai dari lapisan terluar dan dipisahkan oleh garis miring (/).

Dalam contoh berikut, sumber daya dibuat dari Modul B yang bersarang dalam Parent Modul A:

moduleA/moduleB

TypeHierarchy

String

Tipe gabungan dari satu atau lebih modul yang berisi sumber daya. Tipe-tipe modul tersebut terdaftar mulai dari lapisan terluar dan dipisahkan oleh garis miring (/).

Dalam contoh berikut, sumber daya dibuat dari modul bertipe MODULE::ROS::Child::Example yang bersarang dalam modul induk bertipe MODULE::ROS::Parent::Example:

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

Referensi

Untuk informasi lebih lanjut tentang cara melihat perubahan JSON, lihat Lihat set perubahan.