All Products
Search

This Product

    Resource Orchestration Service:UpdateStackGroup

    Document Center

    Resource Orchestration Service:UpdateStackGroup

    Last Updated:Jun 10, 2026

    Memperbarui grup stack yang sudah ada.

    Deskripsi operasi

    Topik ini memberikan contoh cara memperbarui template grup stack MyStackGroup menjadi {"ROSTemplateFormatVersion": "2015-09-01"}. Grup stack berada di region China (Hangzhou) dan menggunakan izin yang dikelola sendiri.

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

    update

    *StackGroup

    acs:ros:{#regionId}:{#accountId}:stackgroup/{#StackGroupName}

    Template

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID region tempat grup stack berada. Anda dapat memanggil operasi DescribeRegions untuk membuat kueri daftar region Alibaba Cloud terbaru.

    cn-hangzhou
    StackGroupName

    string

    Yes

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

    MyStackGroup
    Description

    string

    No

    Deskripsi grup stack.

    Deskripsi harus memiliki panjang 1 hingga 256 karakter.

    My Stack Group
    AccountIds

    array

    No

    ID akun tujuan tempat untuk men-deploy stack dalam mode izin yang dikelola sendiri. Anda dapat menentukan maksimum 50 ID akun tujuan.

    ["12****"]

    string

    No

    ID akun tujuan tempat untuk men-deploy stack dalam mode izin yang dikelola sendiri. Anda dapat menentukan maksimum 50 ID akun tujuan.

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

    array

    No

    ID region tempat Anda ingin men-deploy stack. Anda dapat menentukan maksimum 20 ID region.

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

    string

    No

    ID region tempat Anda ingin men-deploy stack. Anda dapat menentukan maksimum 20 ID region.

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

    string

    No

    Struktur yang berisi body template. Body template harus memiliki panjang 1 hingga 524.288 byte. Jika panjang body template besar, lewatkan parameter dalam body request menggunakan metode HTTP POST dan Body Param untuk mencegah kegagalan request yang disebabkan oleh URL yang terlalu panjang.

    Catatan

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

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

    string

    No

    URL file yang berisi body template. URL harus mengarah ke template yang terletak di server web HTTP atau HTTPS atau di bucket Alibaba Cloud Object Storage Service (OSS). Body template harus memiliki panjang 1 hingga 524.288 byte. Misalnya, URL bucket OSS dapat berupa oss://ros/template/demo atau oss://ros/template/demo?RegionId=cn-hangzhou. Jika Anda tidak menentukan region bucket OSS, nilai parameter `RegionId` digunakan.

    Catatan

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

    oss://ros-template/demo
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi request. Anda dapat menggunakan klien untuk membuat token, tetapi Anda harus memastikan bahwa token tersebut unik di antara request yang berbeda.
    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 untuk memperbarui grup stack.

    Update stack instances in hangzhou
    OperationPreferences

    object

    No

    Preferensi untuk operasi grup stack.

    Parameter berikut disertakan:

    • FailureToleranceCount

      Jumlah akun di setiap region yang mengizinkan kegagalan operasi stack. Jika jumlah operasi yang gagal di sebuah region melebihi nilai ini, Resource Orchestration Service (ROS) menghentikan operasi di region tersebut. Jika operasi dihentikan di satu region, operasi tidak dimulai di region lain.

      Nilai harus berupa bilangan bulat dari 0 hingga 20.

      Jika Anda tidak menentukan parameter ini, 0 digunakan sebagai nilai default.

    • FailureTolerancePercentage

      Persentase akun di setiap region yang mengizinkan kegagalan operasi stack. Jika persentase operasi yang gagal di sebuah region melebihi nilai ini, ROS menghentikan operasi di region tersebut.

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

      Jika Anda tidak menentukan parameter ini, 0 digunakan sebagai nilai default.

    • MaxConcurrentCount

      Jumlah maksimum akun di setiap region tempat stack di-deploy secara bersamaan.

      Nilai harus berupa bilangan bulat dari 1 hingga 20.

      Jika Anda tidak menentukan parameter ini, 1 digunakan sebagai nilai default.

    • MaxConcurrentPercentage

      Persentase maksimum akun di setiap region tempat stack di-deploy secara bersamaan.

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

      Jika Anda tidak menentukan parameter ini, 1 digunakan sebagai nilai default.

    • RegionConcurrencyType Jenis konkurensi region deployment. Nilai yang valid:

      • SEQUENTIAL (default): Men-deploy stack di region yang ditentukan secara berurutan. Pada waktu tertentu, stack di-deploy hanya di satu region.

      • PARALLEL: Men-deploy stack di semua region yang ditentukan secara paralel.

    Pisahkan beberapa parameter dengan tanda koma (,).

    Catatan

    • Anda hanya dapat menentukan salah satu dari `MaxConcurrentCount` dan `MaxConcurrentPercentage`.

    • Anda hanya dapat menentukan salah satu dari `FailureToleranceCount` dan `FailureTolerancePercentage`.

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

    string

    No

    Nama role administrator RAM yang diasumsikan oleh ROS. Parameter ini diperlukan ketika Anda membuat grup stack yang memiliki izin yang dikelola sendiri. Jika Anda tidak menentukan nilai, `AliyunROSStackGroupAdministrationRole` digunakan sebagai nilai default. ROS mengasumsikan role ini untuk melakukan operasi pada stack di grup stack. ROS menggunakan kredensial role ini untuk mengasumsikan execution role (`AliyunROSStackGroupExecutionRole`).

    Nama harus memiliki panjang 1 hingga 64 karakter dan dapat berisi huruf, angka, dan tanda hubung (-).

    AliyunROSStackGroupAdministrationRole
    ExecutionRoleName

    string

    No

    Nama execution role RAM yang diasumsikan oleh administrator role (`AliyunROSStackGroupAdministrationRole`). Parameter ini diperlukan ketika Anda membuat grup stack yang memiliki izin yang dikelola sendiri. Jika Anda tidak menentukan nilai, `AliyunROSStackGroupExecutionRole` digunakan sebagai nilai default. ROS mengasumsikan role ini untuk melakukan operasi pada stack di grup stack.

    Nama harus memiliki panjang 1 hingga 64 karakter dan dapat berisi huruf, angka, dan tanda hubung (-).

    AliyunROSStackGroupExecutionRole
    TemplateId

    string

    No

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

    Catatan

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

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

    string

    No

    Versi template. Jika Anda tidak menentukan parameter ini, versi terbaru digunakan.

    Catatan

    `TemplateVersion` berlaku hanya ketika `TemplateId` ditentukan.

    v1
    Parameters

    array<object>

    No

    Parameter grup stack.

    object

    No

    ParameterKey

    string

    Yes

    Kunci parameter. Jika Anda tidak menentukan kunci dan nilai parameter, ROS menggunakan nama dan nilai default yang ditentukan dalam template.

    Anda dapat menentukan maksimum 200 parameter.

    Catatan

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

    Amount
    ParameterValue

    string

    Yes

    Nilai parameter.

    Anda dapat menentukan maksimum 200 parameter.

    Catatan

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

    1
    PermissionModel

    string

    No

    Model izin.

    Nilai yang valid:

    • SELF_MANAGED (default): Izin yang dikelola sendiri. Jika Anda menggunakan model izin ini, Anda harus membuat role RAM di akun administrator dan member sehingga akun dapat dikaitkan satu sama lain. Kemudian, Anda dapat men-deploy stack di akun member.

    • SERVICE_MANAGED: Izin yang dikelola layanan. Jika Anda menggunakan model izin ini, ROS membuat service-linked role untuk akun administrator dan member. Akun administrator menggunakan service-linked role untuk men-deploy stack di akun member.

    Catatan

    • Jika instance stack ada di grup stack, Anda tidak dapat mengubah model izin.

    • Jika Anda menggunakan model izin service-managed untuk men-deploy stack, akun saat ini harus berupa akun pengelolaan atau akun administrator yang didelegasikan dari resource directory Anda, dan trusted access harus diaktifkan untuk akun tersebut. Untuk informasi selengkapnya, lihat Mengatur akun administrator yang didelegasikan dan Mengaktifkan trusted access.

    SELF_MANAGED
    AutoDeployment

    object

    No

    Pengaturan deployment otomatis.

    Catatan

    Parameter ini diperlukan hanya ketika `PermissionModel` disetel ke `SERVICE_MANAGED`.

    {"Enabled": true, "RetainStacksOnAccountRemoval": true}
    Enabled

    boolean

    Yes

    Menentukan apakah akan mengaktifkan deployment otomatis.

    Nilai yang valid:

    • true: Mengaktifkan deployment otomatis. Jika Anda mengaktifkan deployment otomatis, ROS secara otomatis men-deploy stack ke akun member baru yang ditambahkan ke folder. Jika akun member dihapus dari folder, ROS secara otomatis menghapus stack dari akun tersebut.

    • false: Menonaktifkan deployment otomatis. Jika Anda menonaktifkan deployment otomatis, stack tetap tidak berubah ketika akun member di folder berubah.

    true
    RetainStacksOnAccountRemoval

    boolean

    No

    Menentukan apakah akan mempertahankan stack di akun member yang dihapus dari folder.

    Nilai yang valid:

    • true: Mempertahankan stack.

    • false: Menghapus stack.

    Catatan

    Parameter ini diperlukan hanya ketika `Enabled` disetel ke true.

    true
    DeploymentTargets

    object

    No

    Target deployment tempat Anda ingin men-deploy stack dalam mode izin service-managed.

    {"RdFolderIds": ["fd-4PvlVLOL8v"]}
    RdFolderIds

    array

    No

    ID folder di resource directory.

    string

    No

    ID folder di resource directory. Anda dapat menentukan maksimum 20 ID folder.

    Anda harus menentukan setidaknya salah satu dari parameter `RdFolderIds` dan `AccountIds`. Bagian berikut menjelaskan parameter:

    • Jika Anda menentukan `RdFolderIds` tetapi bukan `AccountIds`, stack di-deploy di semua akun member di folder yang ditentukan. Jika Anda memilih folder Root, stack di-deploy di semua akun member di resource directory.

    • Jika Anda menentukan `AccountIds` tetapi bukan `RdFolderIds`, stack di-deploy di akun member yang ditentukan.

    • Jika Anda menentukan keduanya `RdFolderIds` dan `AccountIds`, stack di-deploy di akun member yang ditentukan yang berada di folder yang ditentukan.

    Catatan

    Anda dapat melihat ID folder di halaman Ikhtisar dari konsol Resource Management. Untuk informasi selengkapnya, lihat Melihat informasi dasar folder.

    ["fd-4PvlVLOL8v"]
    AccountIds

    array

    No

    ID akun member di resource directory. Anda dapat menentukan maksimum 30 ID akun member.

    Catatan

    Anda dapat melihat ID akun member di halaman Ikhtisar dari konsol Resource Management. Untuk informasi selengkapnya, lihat Melihat detail member.

    string

    No

    ID akun member di resource directory. Anda dapat menentukan maksimum 30 ID akun member.

    Catatan

    Anda dapat melihat ID akun member di halaman Ikhtisar dari konsol Resource Management. Untuk informasi selengkapnya, lihat Melihat detail member.

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

    array

    No

    Opsi untuk grup stack. Anda dapat menentukan hingga satu opsi.

    string

    No

    Opsi untuk grup stack. Nilai yang valid: `ExpandModules`. Opsi ini memperluas modul di akun saat ini.

    Catatan

    • Parameter ini berlaku hanya jika template berisi modul.

    • Secara default, modul tidak diperluas di akun saat ini. Modul harus ada di semua akun tujuan deployment. Jika Anda memperluas modul di akun saat ini, modul harus ada di akun saat ini.

    ExpandModules
    DeploymentOptions

    array

    No

    Opsi deployment untuk grup stack dengan izin service-managed. Anda dapat menentukan hingga satu opsi deployment.

    string

    No

    Nilai yang valid:

    • Deploy: Memperbarui instance yang ada di akun resource directory yang ditentukan.

    • Configure: Memodifikasi resource directory tujuan deployment tetapi tidak memperbarui instance yang ada.

    Untuk informasi selengkapnya tentang parameter umum, lihat Parameter umum.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID request.

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

    string

    ID operasi.

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

    ID akun tempat Anda ingin men-deploy stack menggunakan izin yang dikelola sendiri. Anda dapat menentukan hingga 20 ID akun.

    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.