All Products
Search

This Product

    Resource Orchestration Service:UpdateStackInstances

    Document Center

    Resource Orchestration Service:UpdateStackInstances

    Last Updated:Jun 10, 2026

    Memperbarui instans stack untuk satu atau beberapa akun di wilayah tertentu.

    Deskripsi operasi

    This topic provides an example of how to update stacks for the stack group MyStackGroup, which is in the China (Hangzhou) region and uses self-managed permissions. The stacks are updated for the Alibaba Cloud accounts 151266687691**** and 141261387191**** in the China (Hangzhou) and China (Beijing) regions.

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

    update

    *StackInstance

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID wilayah Grup tumpukan. Panggil DescribeRegions untuk mendapatkan daftar terbaru wilayah Alibaba Cloud.

    cn-hangzhou
    StackGroupName

    string

    Yes

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

    MyStackGroup
    AccountIds

    array

    No

    ID akun tujuan tempat Anda ingin menerapkan stack dengan izin yang dikelola sendiri. Anda dapat menentukan hingga 30 ID akun.

    Catatan

    Parameter ini diperlukan saat Anda memperbarui stack dengan izin yang dikelola sendiri.

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

    string

    No

    The IDs of the destination accounts for which you want to deploy stacks with self-managed permissions. You can specify up to 30 account IDs.

    Catatan

    This parameter is required when you update stacks with self-managed permissions.

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

    array

    Yes

    Daftar wilayah tempat Anda ingin melakukan operasi. Anda dapat menentukan hingga 20 wilayah.

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

    string

    No

    The list of regions where you want to perform the operation. You can specify up to 20 regions.

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

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan. Token klien dihasilkan oleh klien dan harus unik secara global.
    Token dapat memiliki panjang hingga 64 karakter dan dapat berisi huruf, angka, tanda hubung (-), dan garis bawah (_).
    Untuk informasi selengkapnya, lihat Cara memastikan idempotensi.

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

    string

    No

    Deskripsi operasi pembaruan.

    Deskripsi harus memiliki panjang 1 hingga 256 karakter.

    Update stack instances in hangzhou and beijing
    OperationPreferences

    object

    No

    Pengaturan operasi untuk memperbarui stack.

    Ini mencakup parameter berikut:

    • {"FailureToleranceCount": N}

      Jumlah akun yang operasi stacknya boleh gagal di suatu wilayah. Jika jumlah kegagalan di suatu wilayah melebihi nilai ini, Resource Orchestration Service (ROS) menghentikan operasi di wilayah tersebut. Jika operasi dihentikan di satu wilayah, operasi tidak akan berlanjut di wilayah lain.

      N harus berupa bilangan bulat dari 0 hingga 20.

      Jika Anda tidak menentukan FailureToleranceCount, nilai default adalah 0.

    • {"FailureTolerancePercentage": N}

      Persentase akun yang operasi stacknya boleh gagal di suatu wilayah. Jika persentase kegagalan di suatu wilayah melebihi nilai ini, ROS menghentikan operasi di wilayah tersebut.

      N harus berupa bilangan bulat dari 0 hingga 100. Jika persentase bukan bilangan bulat, ROS membulatkannya ke bawah ke bilangan bulat terdekat.

      Jika Anda tidak menentukan FailureTolerancePercentage, nilai default adalah 0.

    • {"MaxConcurrentCount": N}

      Jumlah maksimum akun tempat stack dapat diterapkan secara bersamaan di suatu wilayah.

      N harus berupa bilangan bulat dari 1 hingga 20.

      Jika Anda tidak menentukan MaxConcurrentCount, nilai default adalah 1.

    • {"MaxConcurrentPercentage": N}

      Persentase akun tempat stack dapat diterapkan secara bersamaan di suatu wilayah.

      Nilai harus berupa bilangan bulat dari 1 hingga 100. Jika persentase bukan bilangan bulat, ROS membulatkannya ke bawah ke bilangan bulat terdekat.

      Jika Anda tidak menentukan MaxConcurrentPercentage, nilai default adalah 1.

    • {"RegionConcurrencyType": N} Tipe konkurensi untuk menerapkan stack di wilayah yang berbeda. Nilai valid:

      • SEQUENTIAL (Default): Menerapkan stack di wilayah yang ditentukan satu per satu secara berurutan. Pada satu waktu, stack hanya diterapkan di satu wilayah.

      • PARALLEL: Menerapkan stack di semua wilayah 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}
    TimeoutInMinutes

    integer

    No

    Periode pengatur waktu habis untuk operasi pembaruan.

    • Nilai default: 60.

    • Unit: menit.

    10
    ParameterOverrides

    array<object>

    No

    Daftar parameter yang akan ditimpa.

    object

    No

    ParameterKey

    string

    Yes

    The name of the parameter to overwrite. If you do not specify this parameter, ROS uses the parameter name that you specified when you created the stack group.

    The value of N can be up to 200.

    Catatan

    • The ParameterOverrides parameter is optional.

    • If you specify ParameterOverrides, you must specify both ParameterOverrides.N.ParameterKey and ParameterOverrides.N.ParameterValue.

    Amount
    ParameterValue

    string

    Yes

    The value of the parameter to overwrite. If you do not specify the name and value of a parameter, ROS uses the parameter that you specified when you created the stack group.

    The value of N can be up to 200.

    Catatan

    • The ParameterOverrides parameter is optional.

    • If you specify ParameterOverrides, you must specify both ParameterOverrides.N.ParameterKey and ParameterOverrides.N.ParameterValue.

    1
    DeploymentTargets

    object

    No

    Target penerapan untuk stack yang diterapkan dalam mode dikelola layanan.

    Catatan

    Parameter ini diperlukan saat Anda memperbarui stack dalam mode dikelola layanan.

    RdFolderIds

    array

    No

    The IDs of the folders in the resource directory.

    string

    No

    The IDs of the folders in the resource directory. You can specify up to 20 folder IDs.

    You must specify `RdFolderIds` or `AccountIds`.

    • If you specify `RdFolderIds` but not `AccountIds`, stacks are deployed in all member accounts in the specified folders. If you specify the root folder, stacks are deployed in all member accounts in your resource directory.

    • If you specify `AccountIds` but not `RdFolderIds`, stacks are deployed in the specified member accounts.

    • If you specify both parameters, the accounts in `AccountIds` must be in the folders specified by `RdFolderIds`. Stacks are deployed in the specified member accounts.

    Catatan

    You can view the folder IDs on the Overview page in the Resource Management console. For more information, see View the basic information of a folder.

    ["fd-4PvlVLOL8v"]
    AccountIds

    array

    No

    The IDs of the member accounts in the resource directory. You can specify up to 50 member account IDs.

    Catatan

    You can view the member account IDs on the Overview page in the Resource Management console. For more information, see View the details of a member.

    string

    No

    The IDs of the member accounts in the resource directory. You can specify up to 50 member account IDs.

    Catatan

    You can view the member account IDs on the Overview page in the Resource Management console. For more information, see View the details of a member.

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

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

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The request ID.

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

    string

    The operation ID.

    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.