:CreateChangeSet

Operasi yang ingin Anda lakukan. Tetapkan nilainya ke CreateChangeSet.

ID stack tempat Anda ingin membuat change set. ROS membandingkan informasi stack dengan informasi yang Anda tentukan, seperti template yang dimodifikasi atau nilai parameter yang diubah, untuk menghasilkan change set.

URL file yang berisi kebijakan stack. URL harus mengarah ke kebijakan yang berada di server web HTTP atau HTTPS atau di bucket Object Storage Service (OSS), seperti oss://ros/stack-policy/demo atau oss://ros/stack-policy/demo?RegionId=cn-hangzhou. File kebijakan dapat memiliki panjang maksimal 16.384 byte.

Anda dapat menentukan parameter StackPolicyBody atau StackPolicyURL.

Panjang URL dapat mencapai 1.350 byte.

Jika Anda mengatur parameter ChangeSetType ke CREATE, Anda dapat menentukan parameter StackPolicyBody atau StackPolicyURL. Jika Anda mengatur parameter ChangeSetType ke UPDATE, Anda hanya dapat menentukan salah satu dari parameter berikut:

• StackPolicyBody
• StackPolicyURL
• StackPolicyDuringUpdateBody
• StackPolicyDuringUpdateURL

Struktur yang berisi isi kebijakan stack. Isi kebijakan harus memiliki panjang 1 hingga 16.384 byte. Jika Anda mengatur parameter ChangeSetType ke CREATE, Anda dapat menentukan parameter StackPolicyBody atau StackPolicyURL. Jika Anda mengatur parameter ChangeSetType ke UPDATE, Anda hanya dapat menentukan salah satu dari parameter berikut:

• StackPolicyBody
• StackPolicyURL
• StackPolicyDuringUpdateBody
• StackPolicyDuringUpdateURL

Nama stack tempat Anda ingin membuat change set.

Nama dapat memiliki panjang hingga 255 karakter, dan dapat berisi angka, huruf, tanda hubung (-), dan garis bawah (_). Nama harus diawali dengan angka atau huruf.

Menentukan apakah akan menggunakan nilai yang ditentukan dalam permintaan sebelumnya untuk parameter yang tidak Anda tentukan dalam permintaan saat ini. Nilai default: false. Nilai yang valid:

• true
• false

Tipe change set. Nilai default: UPDATE. Nilai yang valid:

• CREATE: membuat change set untuk stack baru.
• UPDATE: membuat change set untuk stack yang sudah ada.
• IMPORT: membuat change set untuk stack baru atau stack yang sudah ada untuk mengimpor resource yang tidak dikelola oleh ROS.

Jika Anda membuat change set untuk stack baru, ROS akan menghasilkan ID stack unik untuk stack tersebut. Stack tetap berada dalam status REVIEW_IN_PROGRESS hingga Anda mengeksekusi change set tersebut.

Anda tidak dapat menggunakan tipe UPDATE untuk membuat change set untuk stack baru atau tipe CREATE untuk membuat change set untuk stack yang sudah ada.

Deskripsi change set. Deskripsi dapat memiliki panjang hingga 1.024 byte.

ID wilayah untuk change set. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.

Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menghasilkan nilai ini di sisi klien, tetapi Anda harus memastikan bahwa nilainya unik di antara permintaan yang berbeda.

Token dapat memiliki panjang hingga 64 karakter, dan dapat berisi huruf, angka, tanda hubung (-), dan garis bawah (_).

Untuk informasi selengkapnya, lihat Ensure idempotence.

URL file yang berisi isi template. URL harus mengarah ke template yang berada di server web HTTP atau HTTPS atau di bucket OSS, seperti oss://ros/template/demo atau oss://ros/template/demo?RegionId=cn-hangzhou. Isi template dapat memiliki panjang maksimal 524.288 byte.

Anda hanya dapat menentukan salah satu dari parameter berikut: TemplateBody, TemplateURL, dan TemplateId.

Panjang URL dapat mencapai 1.024 byte.

URL file yang berisi kebijakan stack pengganti sementara. URL harus mengarah ke kebijakan yang berada di server web HTTP atau HTTPS atau di bucket OSS, seperti oss://ros/stack-policy/demo atau oss://ros/stack-policy/demo?RegionId=cn-hangzhou. File kebijakan dapat memiliki panjang maksimal 16.384 byte.

Panjang URL dapat mencapai 1.350 byte.

Jika Anda ingin memperbarui resource yang dilindungi, tentukan kebijakan stack pengganti sementara untuk resource tersebut selama pembaruan. Jika Anda tidak menentukan kebijakan tersebut, kebijakan yang sudah ada dan terkait dengan stack akan digunakan. Parameter ini hanya berlaku ketika parameter ChangeSetType diatur ke UPDATE. Anda hanya dapat menentukan salah satu dari parameter berikut:

• StackPolicyBody
• StackPolicyURL
• StackPolicyDuringUpdateBody
• StackPolicyDuringUpdateURL

Struktur yang berisi isi template. Isi template harus memiliki panjang 1 hingga 524.288 byte.

Jika panjang isi template melebihi batas atas, kami menyarankan agar Anda menambahkan parameter ke badan permintaan HTTP POST untuk mencegah kegagalan permintaan akibat URL yang terlalu panjang.

Anda hanya dapat menentukan salah satu dari parameter berikut: TemplateBody, TemplateURL, dan TemplateId.

Jumlah waktu yang dapat berlalu sebelum stack masuk ke status CREATE_FAILED atau UPDATE_FAILED.

Jika Anda mengatur parameter ChangeSetType ke CREATE, parameter ini wajib diisi. Jika Anda mengatur parameter ChangeSetType ke UPDATE, parameter ini opsional.

• Unit: menit.
• Nilai yang valid: 10 hingga 1440.
• Nilai default: 60.

Menentukan apakah akan menonaktifkan rollback ketika pembuatan stack gagal.

Nilai default: false. Nilai yang valid:

• true
• false

Nama change set.

Nama dapat memiliki panjang hingga 255 karakter, dan dapat berisi angka, huruf, tanda hubung (-), dan garis bawah (_). Nama harus diawali dengan angka atau huruf.

Struktur yang berisi isi kebijakan stack pengganti sementara. Isi kebijakan harus memiliki panjang 1 hingga 16.384 byte.

Jika Anda ingin memperbarui resource yang dilindungi, tentukan kebijakan stack pengganti sementara untuk resource tersebut selama pembaruan. Jika Anda tidak menentukan kebijakan tersebut, kebijakan stack yang sudah ada dan terkait dengan stack akan digunakan.

Parameter ini hanya berlaku ketika parameter ChangeSetType diatur ke UPDATE. Anda hanya dapat menentukan salah satu dari parameter berikut:

• StackPolicyBody
• StackPolicyURL
• StackPolicyDuringUpdateBody
• StackPolicyDuringUpdateURL

Nama peran RAM. ROS mengasumsikan peran RAM untuk membuat stack dan menggunakan kredensial peran tersebut untuk memanggil API layanan Alibaba Cloud.

ROS mengasumsikan peran RAM untuk melakukan operasi pada stack. Jika Anda memiliki izin untuk melakukan operasi pada stack tetapi tidak memiliki izin untuk menggunakan peran RAM, ROS tetap akan mengasumsikan peran RAM tersebut. Anda harus memastikan bahwa peran RAM tersebut diberikan hak istimewa minimal.

Jika Anda tidak menentukan parameter ini, ROS akan mengasumsikan peran RAM yang sudah ada dan terkait dengan stack. Jika tidak tersedia peran RAM, ROS akan menggunakan kredensial temporary yang dihasilkan dari kredensial akun Anda.

Nama peran RAM dapat memiliki panjang hingga 64 byte.

Menentukan apakah akan mengaktifkan pembaruan penggantian jika properti resource diubah tetapi Anda tidak dapat mengubah properti resource tersebut. Untuk perubahan biasa, ID fisik resource tetap tidak berubah. Untuk pembaruan penggantian, resource yang ada dihapus, resource baru dibuat, dan ID fisik resource berubah. Nilai default: Disabled. Nilai yang valid:

• Enabled
• Disabled

ID template. Parameter ini berlaku untuk template bersama dan template pribadi.

Anda hanya dapat menentukan salah satu dari parameter berikut: TemplateBody, TemplateURL, dan TemplateId.

Versi template.

Nama parameter N yang didefinisikan dalam template. Jika Anda tidak menentukan nama dan nilai parameter, ROS akan menggunakan nama dan nilai default yang didefinisikan dalam template. Nilai maksimum N: 200.

Nilai parameter N yang didefinisikan dalam template. Nilai maksimum N: 200.

URL callback yang digunakan untuk menerima event stack N. Nilai yang valid:

• URL HTTP POST

  Panjang setiap URL dapat mencapai 1.024 byte.

• eventbridge

  Ketika status stack berubah, ROS mengirim notifikasi event ke layanan EventBridge. Untuk melihat informasi event, lakukan langkah-langkah berikut: Masuk ke Konsol EventBridge. Di panel navigasi sebelah kiri, klik Event Buses.

  Catatan ROS mendukung layanan EventBridge di wilayah berikut: China (Hangzhou), China (Shanghai), China (Beijing), China (Hong Kong), dan China (Zhangjiakou).

Nilai maksimum N: 5. Ketika status stack berubah, ROS mengirim notifikasi event ke URL yang ditentukan. Ketika rollback diaktifkan untuk stack, notifikasi event dikirim jika stack berada dalam status CREATE_ROLLBACK atau ROLLBACK, tetapi tidak dikirim jika stack berada dalam status CREATE_FAILED, UPDATE_FAILED, atau IN_PROGRESS.

ROS mengirim notifikasi event terlepas dari apakah Anda mengonfigurasi bagian Outputs atau tidak. Contoh kode berikut menunjukkan isi notifikasi event:

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

Pemetaan key-value antar string. Nilainya adalah string JSON yang mengidentifikasi resource N yang akan diimpor.

Kunci adalah pengenal untuk sebuah resource dan nilai adalah penugasan data ke kunci tersebut. Misalnya, VpcId adalah kunci yang menentukan ID virtual private cloud (VPC), dan vpc-2zevx9ios**** adalah nilai yang ditugaskan ke VpcId. Anda dapat memanggil operasi GetTemplateSummary untuk mendapatkan kunci resource.

ID logis resource N yang ingin Anda impor. ID logis menentukan nama resource yang didefinisikan dalam template.

Tipe resource N yang ingin Anda impor. Tipe resource harus sama dengan tipe resource yang didefinisikan dalam template.

ID template skenario.

Jumlah maksimum operasi konkuren yang dapat dilakukan pada resource. Secara default, parameter ini kosong. Anda dapat mengatur parameter ini ke bilangan bulat yang lebih besar dari atau sama dengan 0. Jika Anda mengatur parameter ini ke nilai tertentu, ROS akan mengaitkan nilai tersebut dengan stack. Nilai ini dapat memengaruhi operasi selanjutnya pada stack.

Parameter ini hanya berlaku ketika parameter ChangeSetType diatur ke CREATE atau UPDATE. Nilai yang valid:

• Nilai yang valid untuk change set tipe CREATE:
  • Jika Anda mengatur parameter ini ke bilangan bulat yang lebih besar dari 0, bilangan bulat tersebut yang digunakan.
  • Jika Anda mengatur parameter ini ke 0 atau membiarkannya kosong, tidak ada batasan yang diberlakukan pada stack ROS. Namun, nilai default di Terraform akan digunakan untuk stack Terraform. Dalam kebanyakan kasus, nilai default di Terraform adalah 10.
• Nilai yang valid untuk change set tipe UPDATE:
  • Jika Anda mengatur parameter ini ke bilangan bulat yang lebih besar dari 0, bilangan bulat tersebut yang digunakan.
  • Jika Anda mengatur parameter ini ke 0, tidak ada batasan yang diberlakukan pada stack ROS. Namun, nilai default di Terraform akan digunakan untuk stack Terraform. Dalam kebanyakan kasus, nilai default di Terraform adalah 10.
  • Jika Anda membiarkan parameter ini kosong, nilai yang Anda tentukan untuk parameter ini dalam permintaan sebelumnya yang digunakan. Jika Anda membiarkan parameter ini kosong dalam permintaan sebelumnya, tidak ada batasan yang diberlakukan pada stack ROS. Namun, nilai default di Terraform akan digunakan untuk stack Terraform. Dalam kebanyakan kasus, nilai default di Terraform adalah 10.

ID change set.

ID permintaan.

ID stack.