All Products
Search

This Product

    Resource Orchestration Service:GetStackGroup

    Document Center

    Resource Orchestration Service:GetStackGroup

    Last Updated:Jun 10, 2026

    Mengkueri detail grup tumpukan berdasarkan namanya di region Alibaba Cloud.

    Deskripsi operasi

    Topik ini memberikan contoh cara mengkueri grup tumpukan bernama MyStackGroup. Grup tumpukan ini berada di region China (Hangzhou) dan menggunakan mode izin yang dikelola sendiri (self-managed).

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

    get

    *StackGroup

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID region dari grup tumpukan. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar region terbaru.

    cn-hangzhou
    StackGroupName

    string

    No

    Nama grup tumpukan. Nama harus unik dalam suatu region. Panjang nama dapat mencapai 255 karakter, dan harus dimulai dengan angka atau huruf. Nama dapat berisi angka, huruf, tanda hubung (-), dan garis bawah (_).

    Catatan

    Anda hanya boleh menentukan salah satu dari parameter StackGroupName dan StackGroupId.

    MyStackGroup
    StackGroupId

    string

    No

    ID grup tumpukan.

    Catatan

    Anda hanya boleh menentukan salah satu dari parameter StackGroupName dan StackGroupId.

    fd0ddef9-9540-4b42-a464-94f77835****

    Untuk informasi lebih lanjut tentang parameter permintaan umum, lihat Parameter umum.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

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

    object

    Detail grup tumpukan.

    StackGroupId

    string

    ID grup tumpukan.

    fd0ddef9-9540-4b42-a464-94f77835****
    Status

    string

    Status grup tumpukan.

    Nilai yang valid:

    • ACTIVE: Grup tumpukan aktif.

    • DELETED: Grup tumpukan dihapus.

    ACTIVE
    AdministrationRoleName

    string

    Nama peran administrator RAM yang diasumsikan oleh ROS. Parameter ini ditentukan saat Anda membuat grup tumpukan dalam mode izin yang dikelola sendiri (self-managed). Jika Anda tidak menentukan parameter ini, nilai default AliyunROSStackGroupAdministrationRole dikembalikan.

    AliyunROSStackGroupAdministrationRole
    Parameters

    array<object>

    Daftar parameter dari grup tumpukan.

    object

    ParameterKey

    string

    The name of the parameter.

    Amount
    ParameterValue

    string

    The value of the parameter.

    12
    Description

    string

    Deskripsi grup tumpukan.

    StackGroup Description
    StackGroupName

    string

    Nama grup tumpukan.

    MyStackGroup
    ExecutionRoleName

    string

    Nama peran eksekusi RAM yang diasumsikan oleh peran administrator AliyunROSStackGroupAdministrationRole. Parameter ini ditentukan saat Anda membuat grup tumpukan dalam mode izin yang dikelola sendiri (self-managed). Jika Anda tidak menentukan parameter ini, nilai default AliyunROSStackGroupExecutionRole dikembalikan.

    AliyunROSStackGroupExecutionRole
    TemplateBody

    string

    Struktur isi templat.

    Catatan

    Kami menyarankan Anda untuk tidak menggunakan parameter ini. Gunakan TemplateContent sebagai gantinya.

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

    object

    Detail dari operasi deteksi drift terakhir yang berhasil pada grup tumpukan.

    DriftDetectionTime

    string

    The time when the drift detection operation was performed on the stack group.

    2020-02-27T07:47:47
    TotalStackInstancesCount

    integer

    The number of stack instances.

    2
    FailedStackInstancesCount

    integer

    The number of stack instances for which the drift detection operation failed.

    0
    DriftDetectionStatus

    string

    The drift detection status of the stack group.

    Valid values:

    • COMPLETED: The drift detection operation is completed for the stack group. All stack instances have been successfully drift-detected.

    • FAILED: The drift detection operation is completed for the stack group. The number of stack instances that failed the drift detection exceeds the specified threshold.

    • PARTIAL_SUCCESS: The drift detection operation is completed for the stack group. The drift detection operation failed for some stack instances, but the number of failures did not exceed the threshold.

    • IN_PROGRESS: The drift detection operation is in progress for the stack group.

    • STOPPED: The drift detection operation on the stack group was canceled.

    COMPLETED
    StackGroupDriftStatus

    string

    The drift status of the stack group.

    Valid values:

    • DRIFTED: At least one stack instance has drifted.

    • NOT_CHECKED: No successful drift detection has been performed on the stack group.

    • IN_SYNC: All stack instances are in the IN_SYNC state.

    DRIFTED
    InProgressStackInstancesCount

    integer

    The number of stack instances on which a drift detection operation is in progress.

    0
    InSyncStackInstancesCount

    integer

    The number of stack instances that are in the IN_SYNC state.

    1
    CancelledStackInstancesCount

    integer

    The number of stack instances for which the drift detection operation was canceled.

    0
    DriftedStackInstancesCount

    integer

    The number of stack instances that are in the DRIFTED state.

    1
    ResourceGroupId

    string

    ID grup sumber daya. Nilai ini ditentukan oleh ID grup sumber daya yang Anda tentukan saat membuat grup tumpukan.

    rg-acfmxazb4ph6aiy****
    PermissionModel

    string

    Model izin.

    Nilai yang valid:

    • SELF_MANAGED: izin yang dikelola sendiri.

    • SERVICE_MANAGED: izin yang dikelola layanan.

    Catatan

    Untuk informasi lebih lanjut tentang model izin dari grup tumpukan, lihat Ikhtisar.

    SELF_MANAGED
    AutoDeployment

    object

    Informasi tentang pengaturan deployment otomatis.

    Catatan

    Parameter ini hanya dikembalikan jika PermissionModel disetel ke SERVICE_MANAGED.

    Enabled

    boolean

    Indicates whether automatic deployment is enabled or disabled.

    Valid values:

    • true: Automatic deployment is enabled. If you add a new member account to the folder, the stack group automatically deploys stack instances in the specified region of the new account. If you remove a member account from the folder, the stack group automatically deletes stack instances from the specified region of the account.

    • false: Automatic deployment is disabled. After automatic deployment is disabled, the stack instances remain unchanged when the member accounts in the folder change.

    true
    RetainStacksOnAccountRemoval

    boolean

    Indicates whether to retain the stacks in the member account when the member account is removed from the folder.

    Valid values:

    • true: retains the stacks.

    • false: deletes the stacks.

    Catatan

    This parameter is returned only if Enabled is set to true.

    true
    RdFolderIds

    array

    ID folder dalam direktori sumber daya. Instans tumpukan di-deploy di semua akun dalam folder.

    Catatan

    Parameter ini hanya dikembalikan jika PermissionModel disetel ke SERVICE_MANAGED.

    string

    ID folder dalam direktori sumber daya. Instans tumpukan di-deploy di semua akun dalam folder.

    Catatan

    Parameter ini hanya dikembalikan jika PermissionModel disetel ke SERVICE_MANAGED.

    ["fd-4PvlVLOL8v"]
    TemplateContent

    string

    Struktur isi templat. Struktur dalam format JSON. Untuk informasi lebih lanjut, lihat Sintaks templat.

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

    string

    Waktu saat grup tumpukan dibuat.

    2024-06-14T02:13:50
    UpdateTime

    string

    Waktu saat grup tumpukan diperbarui.

    2024-06-15T02:01:00

    Tindakan yang akan dilakukan. Setel nilainya ke GetStackGroup.

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "14A07460-EBE7-47CA-9757-12CC4761D47A",
  "StackGroup": {
    "StackGroupId": "fd0ddef9-9540-4b42-a464-94f77835****",
    "Status": "ACTIVE",
    "AdministrationRoleName": "AliyunROSStackGroupAdministrationRole",
    "Parameters": [
      {
        "ParameterKey": "Amount",
        "ParameterValue": "12"
      }
    ],
    "Description": "StackGroup Description",
    "StackGroupName": "MyStackGroup",
    "ExecutionRoleName": "AliyunROSStackGroupExecutionRole",
    "TemplateBody": "{\"ROSTemplateFormatVersion\": \"2015-09-01\"}",
    "StackGroupDriftDetectionDetail": {
      "DriftDetectionTime": "2020-02-27T07:47:47",
      "TotalStackInstancesCount": 2,
      "FailedStackInstancesCount": 0,
      "DriftDetectionStatus": "COMPLETED",
      "StackGroupDriftStatus": "DRIFTED",
      "InProgressStackInstancesCount": 0,
      "InSyncStackInstancesCount": 1,
      "CancelledStackInstancesCount": 0,
      "DriftedStackInstancesCount": 1
    },
    "ResourceGroupId": "rg-acfmxazb4ph6aiy****",
    "PermissionModel": "SELF_MANAGED",
    "AutoDeployment": {
      "Enabled": true,
      "RetainStacksOnAccountRemoval": true
    },
    "RdFolderIds": [
      "[\"fd-4PvlVLOL8v\"]"
    ],
    "TemplateContent": "{\n      \"ROSTemplateFormatVersion\": \"2015-09-01\"\n}",
    "CreateTime": "2024-06-14T02:13:50",
    "UpdateTime": "2024-06-15T02:01:00"
  }
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.