All Products
Search

This Product

    Resource Orchestration Service:CreateChangeSet

    Document Center

    Resource Orchestration Service:CreateChangeSet

    Last Updated:Jun 10, 2026

    Membuat change set untuk stack sehingga Anda dapat melihat pratinjau perubahan sebelum eksekusi.

    Deskripsi operasi

    Skenario

    Membuat stack menggunakan change set

    Untuk mengelola sumber daya cloud dan melihat pratinjau hasil pembuatan sebelum stack dibuat, setel ChangeSetType ke CREATE. Change set.

    Memperbarui stack menggunakan change set

    Untuk melihat pratinjau dampak pembaruan sebelum menerapkan perubahan, setel ChangeSetType ke UPDATE. Change set.

    Membuat stack dari sumber daya yang sudah ada

    Untuk mengimpor sumber daya cloud yang sudah ada ke dalam stack baru, setel ChangeSetType ke IMPORT. Ikhtisar.

    Mengimpor sumber daya yang sudah ada ke stack

    Untuk mengimpor sumber daya yang sudah ada ke dalam stack yang sudah ada, setel ChangeSetType ke IMPORT. Ikhtisar.

    Batasan

    • Hanya stack dalam status tertentu yang dapat diperbarui menggunakan change set. Memperbarui stack menggunakan change set.

    • Sebuah stack dapat memiliki maksimum 20 change set sekaligus.

    • Change set hanya menampilkan perubahan pada stack. Ini tidak menunjukkan apakah stack akan berhasil diperbarui.

    • Change set tidak memeriksa masalah seperti kuota akun yang terlampaui, sumber daya yang tidak dapat diperbarui, atau izin yang tidak memadai. Masalah ini dapat menyebabkan pembaruan stack gagal. Jika pembaruan gagal, ROS akan mencoba me-rollback sumber daya ke status sebelumnya.

    Dalam contoh ini, change set bernama MyChangeSet dibuat di region China (Hangzhou) (cn-hangzhou) untuk memperbarui template stack 4a6c9851-3b0f-4f5f-b4ca-a14bf691**** menjadi {"ROSTemplateFormatVersion":"2015-09-01"}.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    ros:CreateChangeSet

    create

    *Stack

    acs:ros:{#regionId}:{#accountId}:stack/{#StackId}

    Template

    acs:ros:{#regionId}:{#accountId}:template/{#TemplateId}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    StackId

    string

    No

    ID stack. ROS membandingkan informasi stack dengan perubahan yang dikirimkan, seperti template yang dimodifikasi atau nilai parameter yang berbeda, untuk menghasilkan change set. Panggil ListStacks untuk menanyakan ID stack.

    Catatan

    Parameter ini hanya berlaku ketika ChangeSetType disetel ke UPDATE atau IMPORT.

    4a6c9851-3b0f-4f5f-b4ca-a14bf691****
    StackPolicyURL

    string

    No

    URL file kebijakan stack. URL harus mengarah ke kebijakan pada server web (HTTP atau HTTPS) atau di bucket OSS, seperti oss://ros/stack-policy/demo atau oss://ros/stack-policy/demo?RegionId=cn-hangzhou. Ukuran maksimum file kebijakan: 16.384 byte.

    Panjang URL maksimum: 1.350 byte.

    Catatan

    Jika Anda tidak menentukan region bucket OSS, nilai RegionId akan digunakan.

    Ketika ChangeSetType disetel ke CREATE, Anda hanya dapat menentukan salah satu dari parameter StackPolicyBody dan StackPolicyURL.

    Ketika ChangeSetType disetel ke UPDATE, Anda hanya dapat menentukan salah satu dari parameter berikut:

    • StackPolicyBody

    • StackPolicyURL

    • StackPolicyDuringUpdateBody

    • StackPolicyDuringUpdateURL

    oss://ros/stack-policy/demo
    StackPolicyBody

    string

    No

    Struktur kebijakan stack. Body kebijakan harus memiliki panjang 1 hingga 16.384 byte.

    Ketika ChangeSetType disetel ke CREATE, Anda hanya dapat menentukan salah satu dari parameter StackPolicyBody dan StackPolicyURL.

    Ketika ChangeSetType disetel ke UPDATE, Anda hanya dapat menentukan salah satu dari parameter berikut:

    • StackPolicyBody

    • StackPolicyURL

    • StackPolicyDuringUpdateBody

    • StackPolicyDuringUpdateURL

    {"Statement":[{"Effect":"Allow","Action":"Update:*","Principal":"*","Resource":"*"}]}
    StackName

    string

    No

    Nama stack. Panjang maksimum: 255 karakter. Nama dapat berisi angka, huruf, tanda hubung (-), dan garis bawah (_), serta harus diawali dengan angka atau huruf.

    Catatan

    Parameter ini hanya berlaku ketika ChangeSetType disetel ke CREATE atau IMPORT.

    MyStack
    UsePreviousParameters

    boolean

    No

    Menentukan apakah akan menggunakan nilai parameter yang terakhir kali digunakan. Nilai yang valid:

    • true

    • false (default)

    Catatan

    Parameter ini hanya berlaku ketika ChangeSetType disetel ke UPDATE atau IMPORT.

    true
    ChangeSetType

    string

    No

    Tipe change set. Nilai yang valid:

    • CREATE: membuat change set untuk stack baru.

    • UPDATE (default): membuat change set untuk stack yang sudah ada.

    • IMPORT: membuat change set untuk stack baru atau stack yang sudah ada untuk mengimpor sumber daya yang tidak dikelola oleh ROS.

    Jika Anda menyetel nilai ChangeSetType ke CREATE, ROS akan membuat stack baru. Stack berada dalam status REVIEW_IN_PROGRESS hingga Anda mengeksekusi change set.

    Catatan

    • 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.

    • Anda tidak dapat menyetel kebijakan stack untuk change set tipe IMPORT. Anda dapat menyetel kebijakan stack saat membuat atau memperbarui stack.

    UPDATE
    Description

    string

    No

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

    It is a demo.
    RegionId

    string

    Yes

    ID region change set.

    Panggil DescribeRegions untuk menanyakan region yang tersedia.

    cn-hangzhou
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan. Token harus unik di antara permintaan dan dapat memiliki panjang hingga 64 karakter, berisi huruf, angka, tanda hubung (-), dan garis bawah (_). Cara memastikan idempotensi.

    123e4567-e89b-12d3-a456-42665544****
    TemplateURL

    string

    No

    URL file template. URL harus mengarah ke template pada server web (HTTP atau HTTPS) atau di bucket OSS, seperti oss://ros/template/demo atau oss://ros/template/demo?RegionId=cn-hangzhou. Ukuran maksimum body template: 524.288 byte.

    Catatan

    Jika Anda tidak menentukan region bucket OSS, nilai RegionId akan digunakan.

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

    URL dapat memiliki panjang hingga 1.024 byte.

    oss://ros/template/demo
    StackPolicyDuringUpdateURL

    string

    No

    URL file kebijakan stack penggantian sementara. URL harus mengarah ke kebijakan pada server web (HTTP atau HTTPS) atau di bucket OSS, seperti oss://ros/stack-policy/demo atau oss://ros/stack-policy/demo?RegionId=cn-hangzhou. Ukuran maksimum file kebijakan: 16.384 byte.

    Catatan

    Jika Anda tidak menentukan region bucket OSS, nilai RegionId akan digunakan.

    Panjang URL maksimum: 1.350 byte. Untuk memperbarui sumber daya yang dilindungi, tentukan kebijakan stack penggantian sementara. Jika tidak ditentukan, kebijakan stack saat ini akan berlaku. Parameter ini hanya berlaku ketika ChangeSetType disetel ke UPDATE. Anda hanya dapat menentukan salah satu dari parameter berikut:

    • StackPolicyBody

    • StackPolicyURL

    • StackPolicyDuringUpdateBody

    • StackPolicyDuringUpdateURL

    oss://ros/stack-policy/demo
    TemplateBody

    string

    No

    Body template. Panjang: 1 hingga 524.288 byte. Untuk template besar, gunakan HTTP POST dengan parameter body untuk menghindari batas panjang URL.

    Catatan

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

    {"ROSTemplateFormatVersion":"2015-09-01"}
    TimeoutInMinutes

    integer

    No

    Periode batas waktu sebelum stack memasuki status CREATE_FAILED atau UPDATE_FAILED. Wajib ketika ChangeSetType adalah CREATE. Opsional ketika ChangeSetType adalah UPDATE.

    • Satuan: menit.

    • Nilai yang valid: 10 hingga 1440.

    • Nilai default: 60.

    12
    DisableRollback

    boolean

    No

    Menentukan apakah akan menonaktifkan rollback pada kegagalan pembuatan stack. Nilai yang valid:

    • true: menonaktifkan rollback pada kegagalan pembuatan.

    • false (default): mengaktifkan rollback pada kegagalan pembuatan.

    Catatan

    Parameter ini hanya berlaku ketika ChangeSetType disetel ke CREATE atau IMPORT.

    false
    ChangeSetName

    string

    Yes

    Nama change set. Panjang maksimum: 255 karakter. Nama dapat berisi angka, huruf, tanda hubung (-), dan garis bawah (_), serta harus diawali dengan angka atau huruf.

    Catatan

    Nama change set harus unik dalam stack.

    MyChangeSet
    StackPolicyDuringUpdateBody

    string

    No

    Body kebijakan stack penggantian sementara. Panjang: 1 hingga 16.384 byte. Untuk memperbarui sumber daya yang dilindungi, tentukan kebijakan penggantian sementara. Jika tidak ditentukan, kebijakan stack saat ini akan berlaku. Parameter ini hanya berlaku ketika ChangeSetType disetel ke UPDATE. Anda hanya dapat menentukan salah satu dari parameter berikut:

    • StackPolicyBody

    • StackPolicyURL

    • StackPolicyDuringUpdateBody

    • StackPolicyDuringUpdateURL

    {"Statement":[{"Effect":"Allow","Action":"Update:*","Principal":"*","Resource":"*"}]}
    RamRoleName

    string

    No

    Nama peran RAM. ROS mengasumsikan peran ini untuk memanggil API layanan Alibaba Cloud dan selalu menggunakannya untuk semua operasi stack. Jika Anda tidak memiliki izin yang diperlukan, ROS akan mengasumsikan peran yang ditentukan oleh RamRoleName. Jika tidak ditentukan, ROS akan menggunakan peran stack yang sudah ada. Jika tidak ada peran yang tersedia, ROS akan menggunakan kredensial sementara dari akun Anda. Panjang maksimum: 64 byte.

    Peran stack.

    test-role
    ReplacementOption

    string

    No

    Menentukan apakah akan mengaktifkan pembaruan penggantian ketika perubahan properti sumber daya tidak mendukung pembaruan modifikasi. Pembaruan penggantian akan menghapus sumber daya yang ada dan membuat yang baru dengan ID fisik baru. Nilai yang valid:

    • Enabled: mengaktifkan pembaruan penggantian.

    • Disabled (default): menonaktifkan pembaruan penggantian.

    Catatan

    Pembaruan modifikasi digunakan secara prioritas. Parameter ini hanya berlaku ketika ChangeSetType disetel ke UPDATE.

    Disabled
    TemplateId

    string

    No

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

    Panggil ListTemplates untuk menanyakan ID template.

    Catatan

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

    5ecd1e10-b0e9-4389-a565-e4c15efc****
    TemplateVersion

    string

    No

    Versi template.

    Catatan

    Parameter ini hanya berlaku ketika TemplateId ditentukan.

    v1
    Parameters

    array<object>

    No

    Parameter yang didefinisikan dalam template.

    object

    No

    ParameterKey

    string

    Yes

    Nama parameter yang didefinisikan dalam template. Jika Anda tidak menentukan nama dan nilai parameter, ROS akan menggunakan nama dan nilai default yang ditentukan dalam template. Nilai N dapat mencapai hingga 200.

    Catatan

    Parameter Parameters bersifat opsional. Jika Anda menentukan Parameters, Anda juga harus menentukan Parameters.N.ParameterKey.

    Amount
    ParameterValue

    string

    Yes

    Nilai parameter yang didefinisikan dalam template. Nilai N dapat mencapai hingga 200.

    Catatan

    Parameter Parameters bersifat opsional. Jika Anda menentukan Parameters, Anda juga harus menentukan Parameters.N.ParameterValue.

    12
    NotificationURLs

    array

    No

    Daftar alamat webhook untuk menerima notifikasi event stack.

    http://my-site.com/ros-notify

    string

    No

    Alamat webhook untuk menerima notifikasi event stack. Nilai yang valid:

    • URL HTTP POST Setiap URL dapat memiliki panjang hingga 1.024 byte.

    • eventbridge Perubahan status stack dikirim ke layanan EventBridge. Anda dapat masuk ke konsol EventBridge dan klik Event Buses di panel navigasi di sebelah kiri untuk melihat informasi event.

    Catatan

    Fitur ini didukung di region China (Hangzhou), China (Shanghai), China (Beijing), China (Hong Kong), dan China (Zhangjiakou).

    Maksimum: 5 URL. Notifikasi dikirim saat perubahan status stack. Dengan rollback diaktifkan, CREATE_FAILED dan UPDATE_FAILED akan digantikan oleh notifikasi CREATE_ROLLBACK dan ROLLBACK. IN_PROGRESS tidak dilaporkan. Notifikasi dikirim terlepas dari parameter Outputs. Contoh notifikasi:

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

    http://example.com/ros-notify
    ResourcesToImport

    array<object>

    No

    Daftar sumber daya yang akan diimpor.

    object

    No

    ResourceIdentifier

    string

    No

    Pemetaan key-value antar string. Nilainya adalah string JSON yang digunakan untuk mengidentifikasi sumber daya yang akan diimpor. Key adalah properti pengenal sumber daya, seperti VpcId dari sumber daya ALIYUN::ECS::VPC. Value adalah nilai properti, seperti vpc-2zevx9ios****.

    Panggil GetTemplateSummary untuk menanyakan properti pengenal sumber daya.

    Catatan

    Parameter ini hanya berlaku ketika ChangeSetType disetel ke IMPORT. Parameter ResourcesToImport bersifat opsional. Jika Anda menentukan ResourcesToImport, Anda juga harus menentukan ResourcesToImport.N.ResourceIdentifier.

    {"VpcId": "vpc-2zevx9ios******"}
    LogicalResourceId

    string

    No

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

    Catatan

    Parameter ini hanya berlaku ketika ChangeSetType disetel ke IMPORT. Parameter ResourcesToImport bersifat opsional. Jika Anda menentukan ResourcesToImport, Anda juga harus menentukan ResourcesToImport.N.LogicalResourceId.

    Vpc
    ResourceType

    string

    No

    Tipe sumber daya. Tipe sumber daya harus sama dengan tipe sumber daya yang didefinisikan dalam template.

    Catatan

    Parameter ini hanya berlaku ketika ChangeSetType disetel ke IMPORT. Parameter ResourcesToImport bersifat opsional. Jika Anda menentukan ResourcesToImport, Anda juga harus menentukan ResourcesToImport.N.ResourceType.

    ALIYUN::ECS::VPC
    TemplateScratchId

    string

    No

    ID skenario sumber daya, yang merupakan ID skenario manajemen sumber daya.

    Parameter ini hanya berlaku ketika ChangeSetType disetel ke IMPORT. Parameter ini hanya mendukung pembuatan stack baru untuk impor sumber daya.

    Jika Anda ingin mengimpor sumber daya dalam skenario manajemen sumber daya, tentukan hanya parameter ini. Jangan tentukan parameter yang terkait dengan template.

    Panggil ListTemplateScratches untuk menanyakan ID skenario.

    4a6c9851-3b0f-4f5f-b4ca-a14bf691****
    Parallelism

    integer

    No

    Jumlah maksimum operasi sumber daya bersamaan. Secara default, nilai ini kosong. Setelah disetel, nilai akan dikaitkan dengan stack dan memengaruhi operasi berikutnya.

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

    • Jika ChangeSetType disetel ke CREATE

      • Jika Anda menyetel parameter ini ke bilangan bulat yang lebih besar dari 0, bilangan bulat tersebut akan digunakan.

      • Jika Anda menyetel parameter ini ke 0 atau tidak menyetel parameter ini, tidak ada batas yang diberlakukan pada stack ROS. Untuk stack Terraform, nilai default Terraform digunakan, yaitu 10.

    • Jika ChangeSetType disetel ke UPDATE

      • Jika Anda menyetel parameter ini ke bilangan bulat yang lebih besar dari 0, bilangan bulat tersebut akan digunakan.

      • Jika Anda menyetel parameter ini ke 0, tidak ada batas yang diberlakukan pada stack ROS. Untuk stack Terraform, nilai default Terraform digunakan, yaitu 10.

      • Jika Anda tidak menyetel parameter ini, nilai yang Anda tentukan pada operasi sebelumnya akan digunakan. Jika Anda tidak menyetel parameter ini pada operasi sebelumnya, tidak ada batas yang diberlakukan pada stack ROS. Untuk stack Terraform, nilai default Terraform digunakan, yaitu 10.

    1
    Tags

    array<object>

    No

    Tag change set.

    object

    No

    Tag change set.

    Key

    string

    No

    Kunci tag stack.

    Nilai N dapat dari 1 hingga 20.

    Catatan

    • Parameter Tags bersifat opsional. Jika Anda menentukan Tags, Anda juga harus menentukan Tags.N.Key.

    • Tag akan dipropagasi ke setiap sumber daya stack yang mendukung tag. Propagasi tag.

    usage
    Value

    string

    No

    Nilai tag stack.

    Nilai N dapat dari 1 hingga 20.

    Catatan

    Tag akan dipropagasi ke setiap sumber daya stack yang mendukung tag. Untuk informasi lebih lanjut, lihat Propagasi tag.

    test
    ResourceGroupId

    string

    No

    ID grup sumber daya. Jika tidak ditentukan, stack akan ditambahkan ke grup sumber daya default. Apa itu grup sumber daya?.

    rg-acfmxazb4ph6aiy****
    TaintResources

    array

    No

    Daftar sumber daya yang akan ditandai sebagai dirty.

    string

    No

    • Untuk stack ROS, nilainya adalah nama sumber daya, seperti my_vpc.

    • Untuk stack Terraform, nilainya adalah tipe sumber daya dan nama sumber daya, seperti alicloud_vpc.my_vpc

    my_vpc

    API ini juga menggunakan Parameter umum.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    ChangeSetId

    string

    ID change set.

    e85abe0c-6528-43fb-ae93-fdf8de22****
    RequestId

    string

    ID permintaan.

    B288A0BE-D927-4888-B0F7-B35EF84B6E6F
    StackId

    string

    ID stack.

    4a6c9851-3b0f-4f5f-b4ca-a14bf691****

    Contoh

    Respons sukses

    JSONformat

    {
  "ChangeSetId": "e85abe0c-6528-43fb-ae93-fdf8de22****",
  "RequestId": "B288A0BE-D927-4888-B0F7-B35EF84B6E6F",
  "StackId": "4a6c9851-3b0f-4f5f-b4ca-a14bf691****"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.