All Products
Search

This Product

    Resource Orchestration Service:DeleteStackInstances

    Document Center

    Resource Orchestration Service:DeleteStackInstances

    Last Updated:Jun 10, 2026

    Menghapus instans stack dari akun dan region yang ditentukan. Anda dapat memilih untuk mempertahankan sumber daya.

    Deskripsi operasi

    Topik ini memberikan contoh cara menghapus instans stack dari grup stack MyStackGroup. Grup stack tersebut menggunakan izin yang dikelola sendiri dan berada di region China (Hangzhou). Contoh ini menghapus instans stack yang di-deploy di region China (Beijing) untuk akun Alibaba Cloud 151266687691****.

    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:DeleteStackInstances

    delete

    *StackInstance

    acs:ros:{#regionId}:{#accountId}:stackinstance/{#StackGroupName}/{#StackInstanceAccountId}/{#StackInstanceRegionId}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID region dari grup stack. Panggil operasi DescribeRegions untuk meng-query daftar terbaru region Alibaba Cloud.

    cn-hangzhou
    StackGroupName

    string

    Yes

    Nama grup stack. Nama harus unik dalam suatu region.
    Nama dapat memiliki panjang hingga 255 karakter. Nama harus dimulai dengan huruf atau digit dan dapat berisi huruf, digit, tanda hubung (-), dan garis bawah (_).

    MyStackGroup
    AccountIds

    array

    No

    ID akun dari mana instans stack akan dihapus. Parameter ini hanya berlaku untuk grup stack yang menggunakan izin yang dikelola sendiri. Anda dapat menentukan hingga 50 ID akun.

    ["151266687691****"]

    string

    No

    ID akun dari mana instans stack akan dihapus. Parameter ini hanya berlaku untuk grup stack yang menggunakan izin yang dikelola sendiri. Anda dapat menentukan hingga 50 ID akun.

    ["151266687691****","141261387191****"]
    RegionIds

    array

    Yes

    ID region tempat instans stack di-deploy. Anda dapat menentukan hingga 20 ID region.

    ["cn-hangzhou", "cn-beijing"]

    string

    No

    ID region tempat instans stack di-deploy. Anda dapat menentukan hingga 20 ID region.

    ["cn-hangzhou","cn-beijing"]
    RetainStacks

    boolean

    Yes

    Menentukan apakah akan mempertahankan stack.

    Nilai yang valid:

    • true: Stack dipertahankan.

    • false: Stack dihapus.

    false
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien Anda untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda.
    Token dapat memiliki panjang hingga 64 karakter dan dapat berisi huruf, digit, tanda hubung (-), dan garis bawah (_).
    Untuk informasi selengkapnya, lihat Cara memastikan idempotensi.

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

    string

    No

    Deskripsi operasi untuk menghapus instans stack.

    Deskripsi dapat memiliki panjang 1 hingga 256 karakter.

    Delete stack instances in hangzhou and beijing
    OperationPreferences

    object

    No

    Preferensi untuk operasi menghapus instans stack.

    Parameter ini berisi subparameter berikut:

    • {"FailureToleranceCount": N}

      Jumlah akun di setiap region yang penghapusan instans stack-nya dapat gagal. Jika jumlah kegagalan di suatu region melebihi nilai ini, operasi berhenti di region tersebut. Jika operasi berhenti di satu region, operasi tersebut tidak akan dilanjutkan di region lain.

      Nilai N harus berupa integer dari 0 hingga 20.

      Jika Anda tidak menentukan FailureToleranceCount, nilai default-nya adalah 0.

    • {"FailureTolerancePercentage": N}

      Persentase akun di setiap region yang penghapusan instans stack-nya dapat gagal. Jika persentase kegagalan di suatu region melebihi nilai ini, operasi berhenti di region tersebut.

      Nilai N harus berupa integer dari 0 hingga 100. Jika persentase yang dihitung bukan integer, ROS membulatkannya ke bawah ke integer terdekat.

      Jika Anda tidak menentukan FailureTolerancePercentage, nilai default-nya adalah 0.

    • {"MaxConcurrentCount": N}

      Jumlah maksimum akun di setiap region yang instans stack-nya dapat dihapus pada saat yang sama.

      Nilai N harus berupa integer dari 1 hingga 20.

      Jika Anda tidak menentukan MaxConcurrentCount, nilai default-nya adalah 1.

    • {"MaxConcurrentPercentage": N}

      Persentase maksimum akun di setiap region yang instans stack-nya dapat dihapus pada saat yang sama.

      Nilai N harus berupa integer dari 1 hingga 100. Jika persentase yang dihitung bukan integer, ROS membulatkannya ke bawah ke integer terdekat.

      Jika Anda tidak menentukan MaxConcurrentPercentage, nilai default-nya adalah 1.

    • {"RegionConcurrencyType": N} Model konkurensi untuk menghapus instans stack di region yang berbeda. Nilai yang valid:

      • SEQUENTIAL (default): Menghapus instans stack di setiap region yang ditentukan secara berurutan. Pada waktu tertentu, operasi hanya menghapus instans stack di satu region.

      • PARALLEL: Menghapus instans stack di semua region yang ditentukan secara paralel.

    Pisahkan beberapa parameter dengan koma (,).

    Catatan

    • Anda tidak dapat menentukan MaxConcurrentCount dan MaxConcurrentPercentage secara bersamaan.

    • Anda tidak dapat menentukan FailureToleranceCount dan FailureTolerancePercentage secara bersamaan.

    {"FailureToleranceCount": 1, "MaxConcurrentCount": 2}
    DeploymentTargets

    object

    No

    Target deployment dari mana instans stack akan dihapus. Parameter ini hanya berlaku untuk grup stack yang menggunakan izin yang dikelola layanan.

    RdFolderIds

    array

    No

    ID folder dalam direktori sumber daya. Anda dapat menentukan hingga 20 ID folder.

    Instans stack dihapus dari semua akun member dalam folder yang ditentukan. Jika Anda menentukan folder Root, instans stack dihapus dari semua akun member dalam direktori sumber daya Anda.

    Catatan

    Anda dapat menemukan ID folder pada halaman Overview di konsol Resource Management. Untuk informasi selengkapnya, lihat Melihat informasi dasar suatu folder.

    string

    No

    ID folder dalam direktori sumber daya. Anda dapat menentukan hingga 20 ID folder.

    Instans stack dihapus dari semua akun member dalam folder yang ditentukan. Jika Anda menentukan folder Root, instans stack dihapus dari semua akun member dalam direktori sumber daya Anda.

    Catatan

    Anda dapat menemukan ID folder pada halaman Overview di konsol Resource Management. Untuk informasi selengkapnya, lihat Melihat informasi dasar suatu folder.

    ["fd-4PvlVLOL8v"]
    AccountIds

    array

    No

    ID akun member dalam direktori sumber daya. Anda dapat menentukan hingga 30 ID akun member.

    Catatan

    Anda dapat menemukan ID akun member pada halaman Overview di konsol Resource Management. Untuk informasi selengkapnya, lihat Melihat detail member.

    string

    No

    ID akun member dalam direktori sumber daya. Anda dapat menentukan hingga 30 ID akun member.

    Catatan

    Anda dapat menemukan ID akun member pada halaman Overview di konsol Resource Management. Untuk informasi selengkapnya, lihat Melihat detail member.

    ["151266687691****","141261387191****"]

    Untuk informasi selengkapnya tentang parameter permintaan umum, lihat Parameter umum.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    14A07460-EBE7-47CA-9757-12CC4761D47A
    OperationId

    string

    ID operasi.

    6da106ca-1784-4a6f-a7e1-e723863d****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "14A07460-EBE7-47CA-9757-12CC4761D47A",
  "OperationId": "6da106ca-1784-4a6f-a7e1-e723863d****"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.