All Products
Search

This Product

    Resource Orchestration Service:CreateStack

    Document Center

    Resource Orchestration Service:CreateStack

    Last Updated:Jun 10, 2026

    Membuat stack dari template ROS untuk men-deploy sekelompok sumber daya.

    Deskripsi operasi

    Stack adalah unit manajemen untuk sumber daya ROS (Ikhtisar). Batasan:

    • Setiap akun Alibaba Cloud dapat membuat hingga 200 stack.

    • Setiap stack dapat berisi hingga 200 sumber daya.

    Contoh berikut membuat stack bernama MyStack di region China (Hangzhou) dengan TemplateBody diatur ke {"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:CreateStack

    create

    *Stack

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

    Template

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    DisableRollback

    boolean

    No

    Menentukan apakah akan menonaktifkan rollback saat pembuatan stack gagal.

    Nilai yang valid:

    • true: menonaktifkan rollback.

    • false (default): mengaktifkan rollback.

    false
    TemplateBody

    string

    No

    Isi template. Panjang: 1 hingga 524.288 byte. Gunakan HTTP POST dengan parameter Body untuk konten berukuran besar guna menghindari batas panjang URL.

    Catatan

    Anda harus menentukan hanya salah satu dari parameter berikut: TemplateBody, TemplateURL, TemplateId, atau TemplateScratchId.

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

    string

    No

    URL file kebijakan stack. Mendukung URL HTTP, HTTPS, dan OSS (misalnya, oss://ros/stack-policy/demo atau oss://ros/stack-policy/demo?RegionId=cn-hangzhou). Ukuran file maksimum: 16.384 byte. Jika region OSS tidak ditentukan, nilai RegionId akan digunakan.

    Catatan

    Anda hanya dapat menentukan salah satu dari parameter berikut: StackPolicyBody atau StackPolicyURL.

    Panjang URL maksimum: 1.350 byte.

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

    integer

    No

    Batas waktu pembuatan stack. Satuan: menit.

    • Nilai default: 60.

    • Nilai yang valid: 10 hingga 1440.

    10
    StackPolicyBody

    string

    No

    Isi kebijakan stack. Panjang: 1 hingga 16.384 byte.

    Catatan

    Anda hanya dapat menentukan salah satu dari parameter berikut: StackPolicyBody atau StackPolicyURL.

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

    string

    Yes

    Nama stack. Panjang maksimum: 255 karakter. Harus dimulai dengan huruf dan dapat berisi huruf, digit, tanda hubung (-), dan garis bawah (_).

    MyStack
    RegionId

    string

    Yes

    ID region dari stack. Panggil DescribeRegions untuk meng-query region yang tersedia.

    cn-hangzhou
    ClientToken

    string

    No

    Memastikan idempotensi permintaan. Harus dihasilkan oleh klien dan unik secara global. Panjang maksimum: 64 karakter. Dapat berisi huruf, digit, tanda hubung (-), dan garis bawah (_).

    Cara memastikan idempotensi

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

    string

    No

    URL file template. Mendukung URL HTTP, HTTPS, dan OSS (misalnya, oss://ros/stack-policy/demo atau oss://ros/stack-policy/demo?RegionId=cn-hangzhou). Ukuran template maksimum: 524.288 byte. Jika region OSS tidak ditentukan, nilai RegionId akan digunakan.

    Catatan

    Anda harus menentukan hanya salah satu dari parameter berikut: TemplateBody, TemplateURL, TemplateId, atau TemplateScratchId.

    oss://ros-template/demo
    RamRoleName

    string

    No

    Nama peran RAM. ROS mengasumsikan peran ini untuk semua panggilan API stack, bahkan ketika pengguna memiliki izin langsung, sehingga memastikan akses dengan hak istimewa minimum. Menggunakan peran stack.

    Jika tidak ditentukan, ROS menggunakan peran yang terkait dengan stack, atau kredensial sementara dari akun Anda jika tidak ada peran yang ada.

    Panjang maksimum: 64 karakter.

    test-role
    DeletionProtection

    string

    No

    Menentukan apakah akan mengaktifkan perlindungan penghapusan pada stack. Nilai yang valid:

    • Enabled: mengaktifkan perlindungan penghapusan.

    • Disabled (default): mengizinkan penghapusan stack melalui konsol ROS atau API DeleteStack.

    Catatan

    Perlindungan penghapusan pada nested stack sama dengan root stack-nya.

    Enabled
    CreateOption

    string

    No

    Perilaku pasca-pembuatan untuk stack. Nilai yang valid:

    • KeepStackOnCreationComplete (default): mempertahankan stack dan sumber daya setelah pembuatan. Dihitung terhadap kuota stack.

    • AbandonStackOnCreationComplete: menghapus stack tetapi mempertahankan sumber daya setelah pembuatan. Tidak dihitung terhadap kuota stack. Stack dipertahankan jika pembuatan gagal.

    • AbandonStackOnCreationRollbackComplete: menghapus stack setelah rollback pembuatan. Tidak dihitung terhadap kuota stack. Stack dipertahankan dalam skenario rollback lainnya.

    • ManuallyPay: memerlukan pembayaran manual untuk sumber daya berlangganan selama pembuatan stack. Tipe sumber daya yang didukung: ALIYUN::ECS::InstanceGroup, ALIYUN::RDS::DBInstance, ALIYUN::SLB::LoadBalancer, ALIYUN::VPC::EIP, dan ALIYUN::VPC::VpnGateway.

    • RetryOnNoStock: secara otomatis mencoba kembali pembuatan sumber daya saat inventaris tidak mencukupi. Tipe sumber daya yang didukung: ALIYUN::RDS::DBInstance.

    Catatan

    Anda hanya dapat menentukan salah satu dari parameter berikut: CreateOption atau CreateOptions.

    KeepStackOnCreationComplete
    CreateOptions

    array

    No

    Opsi pembuatan untuk stack.

    string

    No

    Opsi pembuatan ke-N. Nilai yang valid:

    • KeepStackOnCreationComplete (default): mempertahankan stack dan sumber daya setelah pembuatan. Dihitung terhadap kuota stack.

    • AbandonStackOnCreationComplete: menghapus stack tetapi mempertahankan sumber daya setelah pembuatan. Tidak dihitung terhadap kuota stack. Stack dipertahankan jika pembuatan gagal.

    • AbandonStackOnCreationRollbackComplete: menghapus stack setelah rollback pembuatan. Tidak dihitung terhadap kuota stack. Stack dipertahankan dalam skenario rollback lainnya.

    • ManuallyPay: memerlukan pembayaran manual untuk sumber daya berlangganan selama pembuatan stack. Tipe sumber daya yang didukung: ALIYUN::ECS::InstanceGroup, ALIYUN::RDS::DBInstance, ALIYUN::SLB::LoadBalancer, ALIYUN::VPC::EIP, dan ALIYUN::VPC::VpnGateway.

    • RetryOnNoStock: secara otomatis mencoba kembali pembuatan sumber daya saat inventaris tidak mencukupi. Tipe sumber daya yang didukung: ALIYUN::RDS::DBInstance.

    Catatan

    • Anda hanya dapat menentukan salah satu dari parameter berikut: CreateOption atau CreateOptions.

    • Opsi pembuatan tidak boleh diulang. Opsi KeepStackOnCreationComplete saling eksklusif dengan opsi AbandonStackOnCreationComplete dan AbandonStackOnCreationRollbackComplete.

    • Nilai maksimum N adalah 4.

    KeepStackOnCreationComplete
    TemplateId

    string

    No

    ID template. Parameter ini berlaku untuk template yang dibagikan dan privat.

    Catatan

    Anda harus menentukan hanya salah satu dari parameter berikut: TemplateBody, TemplateURL, TemplateId, atau TemplateScratchId.

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

    string

    No

    Versi template. Parameter ini hanya berlaku ketika Anda menentukan TemplateId.

    v1
    Parameters

    array<object>

    No

    Parameter yang didefinisikan dalam template.

    object

    No

    ParameterKey

    string

    Yes

    Nama parameter ke-N yang didefinisikan dalam template. Jika Anda tidak menentukan nama dan nilai parameter, ROS menggunakan nilai default dalam template.

    Nilai maksimum N adalah 200. Nama harus 1 hingga 128 karakter dan tidak boleh dimulai dengan aliyun atau acs:. Nama tidak boleh berisi http:// atau https://.

    Catatan

    Parameters adalah parameter opsional. Untuk menentukan Parameters, Anda harus menentukan Parameters.N.ParameterKey dan Parameters.N.ParameterValue.

    InstanceId
    ParameterValue

    string

    Yes

    Nilai parameter ke-N yang didefinisikan dalam template.

    Nilai maksimum N adalah 200. Nilai harus 0 hingga 128 karakter dan tidak boleh dimulai dengan aliyun atau acs:. Nilai tidak boleh berisi http:// atau https://.

    Catatan

    Parameters adalah parameter opsional. Untuk menentukan Parameters, Anda harus menentukan Parameters.N.ParameterKey dan Parameters.N.ParameterValue.

    i-xxxxxx
    NotificationURLs

    array

    No

    URL callback untuk event stack. Nilai yang valid:

    • URL HTTP POST. Panjang maksimum: 1.024 byte.

    • EventBridge menerima notifikasi perubahan status stack. Lihat event di konsol EventBridge.

    Catatan

    Region yang didukung: China (Hangzhou), China (Shanghai), China (Beijing), China (Hong Kong), dan China (Zhangjiakou).

    Nilai maksimum N: 5. ROS mengirim notifikasi saat perubahan status stack, kecuali untuk event IN_PROGRESS. Dengan rollback diaktifkan, event CREATE_ROLLBACK dan ROLLBACK menggantikan notifikasi CREATE_FAILED dan UPDATE_FAILED. Notifikasi selalu menyertakan 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://my-site.com/ros-event

    string

    No

    URL callback untuk event stack ke-N. Nilai yang valid:

    • URL HTTP POST. Panjang maksimum: 1.024 byte.

    • EventBridge menerima notifikasi perubahan status stack. Lihat event di konsol EventBridge.

    Catatan

    Region yang didukung: China (Hangzhou), China (Shanghai), China (Beijing), China (Hong Kong), dan China (Zhangjiakou).

    Nilai maksimum N: 5. ROS mengirim notifikasi saat perubahan status stack, kecuali untuk event IN_PROGRESS. Dengan rollback diaktifkan, event CREATE_ROLLBACK dan ROLLBACK menggantikan notifikasi CREATE_FAILED dan UPDATE_FAILED. Notifikasi selalu menyertakan 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-event
    Tags

    array<object>

    No

    Tag dari stack.

    object

    No

    Key

    string

    Yes

    Kunci tag ke-N dari stack.

    Nilai yang valid: 1 hingga 20.

    Catatan

    • Tags adalah parameter opsional. Untuk menentukan Tags, Anda harus menentukan Tags.N.Key.

    • Tag stack disebarkan ke setiap sumber daya yang mendukung tagging. Penyebaran tag.

    usage
    Value

    string

    No

    Nilai tag ke-N dari stack.

    Nilai yang valid: 1 hingga 20.

    Catatan

    Tag stack disebarkan ke sumber daya yang dapat di-tag. Penyebaran tag.

    test
    ResourceGroupId

    string

    No

    ID dari resource group. Jika tidak ditentukan, stack ditambahkan ke resource group default.

    Apa itu resource group

    rg-acfmxazb4ph6aiy****
    Parallelism

    integer

    No

    Jumlah maksimum operasi bersamaan pada sumber daya.

    Default: kosong. Menerima bilangan bulat yang lebih besar dari atau sama dengan 0.

    Catatan

    • Jika lebih besar dari 0, nilai yang ditentukan digunakan. Jika 0 atau kosong, tidak ada batas yang berlaku untuk stack ROS; stack Terraform menggunakan default Terraform (biasanya 10).

    • Nilai yang ditentukan tetap pada stack dan memengaruhi operasi selanjutnya seperti pembaruan.

    1
    TemplateScratchId

    string

    No

    ID dari skenario sumber daya.

    Panggil ListTemplateScratches untuk meng-query ID skenario sumber daya.

    Catatan

    Anda harus menentukan hanya salah satu dari parameter berikut: TemplateBody, TemplateURL, TemplateId, atau TemplateScratchId.

    ts-aa9c62feab844a6b****
    TemplateScratchRegionId

    string

    No

    ID region dari skenario sumber daya. Nilai default: nilai dari RegionId.

    Panggil DescribeRegions untuk meng-query region yang tersedia.

    cn-hangzhou

    Operasi ini menggunakan Parameter umum.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    B288A0BE-D927-4888-B0F7-B35EF84B6E6F
    StackId

    string

    ID stack.

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

    Contoh

    Respons sukses

    JSONformat

    {
  "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.