All Products
Search

This Product

    Resource Orchestration Service:ListStacks

    Document Center

    Resource Orchestration Service:ListStacks

    Last Updated:Jun 17, 2026

    Mengkueri daftar stack.

    Deskripsi operasi

    Deskripsi operasi

    Topik ini menyediakan contoh cara mengkueri daftar stack di wilayah China (Hangzhou).

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

    get

    *Stack

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    PageSize

    integer

    No

    Jumlah entri per halaman saat paging digunakan.

    Nilai maksimum: 50.

    Nilai default: 10.

    10
    ParentStackId

    string

    No

    ID stack induk.

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

    string

    Yes

    ID wilayah stack. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.

    cn-hangzhou
    PageNumber

    integer

    No

    Nomor halaman daftar stack.

    Nilai awal: 1.

    Nilai default: 1.

    1
    ShowNestedStack

    boolean

    No

    Menentukan apakah akan mencantumkan stack bertingkat. Nilai yang valid:

    • true

    • false (default)

    Catatan

    Jika ParentStackId ditentukan, nilai ini diatur ke true.

    true
    StackId

    string

    No

    ID stack. Jika Anda tidak memerlukan informasi stack yang terperinci, Anda dapat menentukan parameter ini alih-alih memanggil operasi GetStack.

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

    array

    No

    Status stack.

    CREATE_COMPLETE

    string

    No

    Status stack. Nilai yang valid:

    • CREATE_IN_PROGRESS: Stack sedang dibuat.

    • CREATE_FAILED: Stack gagal dibuat.

    • CREATE_COMPLETE: Stack telah dibuat.

    • UPDATE_IN_PROGRESS: Stack sedang diperbarui.

    • UPDATE_FAILED: Stack gagal diperbarui.

    • UPDATE_COMPLETE: Stack telah diperbarui.

    • DELETE_IN_PROGRESS: Stack sedang dihapus.

    • DELETE_FAILED: Stack gagal dihapus.

    • CREATE_ROLLBACK_IN_PROGRESS: Stack sedang di-rollback setelah kegagalan pembuatan.

    • CREATE_ROLLBACK_FAILED: Stack gagal di-rollback setelah kegagalan pembuatan.

    • CREATE_ROLLBACK_COMPLETE: Stack telah di-rollback setelah kegagalan pembuatan.

    • ROLLBACK_IN_PROGRESS: Stack sedang di-rollback.

    • ROLLBACK_FAILED: Stack gagal di-rollback.

    • ROLLBACK_COMPLETE: Stack telah di-rollback.

    • CHECK_IN_PROGRESS: Stack sedang divalidasi.

    • CHECK_FAILED: Stack gagal divalidasi.

    • CHECK_COMPLETE: Stack telah divalidasi.

    • REVIEW_IN_PROGRESS: Stack sedang ditinjau.

    • IMPORT_CREATE_IN_PROGRESS: Stack sedang dibuat melalui impor sumber daya.

    • IMPORT_CREATE_FAILED: Stack gagal dibuat melalui impor sumber daya.

    • IMPORT_CREATE_COMPLETE: Stack telah dibuat melalui impor sumber daya.

    • IMPORT_CREATE_ROLLBACK_IN_PROGRESS: Stack sedang di-rollback setelah kegagalan pembuatan melalui impor sumber daya.

    • IMPORT_CREATE_ROLLBACK_FAILED: Stack gagal di-rollback setelah kegagalan pembuatan melalui impor sumber daya.

    • IMPORT_CREATE_ROLLBACK_COMPLETE: Stack telah di-rollback setelah kegagalan pembuatan melalui impor sumber daya.

    • IMPORT_UPDATE_IN_PROGRESS: Stack sedang diperbarui melalui impor sumber daya.

    • IMPORT_UPDATE_FAILED: Stack gagal diperbarui melalui impor sumber daya.

    • IMPORT_UPDATE_COMPLETE: Stack telah diperbarui melalui impor sumber daya.

    • IMPORT_UPDATE_ROLLBACK_IN_PROGRESS: Stack sedang di-rollback setelah kegagalan pembaruan melalui impor sumber daya.

    • IMPORT_UPDATE_ROLLBACK_FAILED: Stack gagal di-rollback setelah kegagalan pembaruan melalui impor sumber daya.

    • IMPORT_UPDATE_ROLLBACK_COMPLETE: Stack telah di-rollback setelah kegagalan pembaruan melalui impor sumber daya.

    CREATE_COMPLETE
    StackName

    array

    No

    Nama stack.

    MyStack

    string

    No

    Nama stack.
    Nama dapat memiliki panjang hingga 255 karakter dan harus dimulai dengan angka atau huruf. Nama dapat berisi angka, huruf, tanda hubung (-), dan garis bawah (_). Tanda bintang (*) dapat digunakan untuk pencocokan fuzzy.

    Nilai valid N: 1 hingga 5.

    MyStack
    Tag

    array<object>

    No

    Tag stack.

    object

    No

    Key

    string

    No

    Kunci tag stack.
    Nilai valid N: 1 hingga 20.

    usage
    Value

    string

    No

    Nilai tag stack.
    Nilai valid N: 1 hingga 20.

    test
    ResourceGroupId

    string

    No

    ID grup sumber daya. Untuk informasi selengkapnya tentang grup sumber daya, lihat Apa itu grup sumber daya?.

    rg-acfmxazb4ph6aiy****
    StackIds

    array

    No

    Daftar ID stack.

    string

    No

    ID stack. Anda dapat menentukan beberapa ID stack untuk mengkueri detail beberapa stack sekaligus. Nilai valid N: 1 hingga 10.

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

    string

    No

    Awal rentang waktu untuk pemfilteran berdasarkan waktu pembuatan. Tentukan waktu dalam standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC+0.

    2023-04-01T15:10:00Z
    EndTime

    string

    No

    Akhir rentang waktu untuk pemfilteran berdasarkan waktu pembuatan. Tentukan waktu dalam standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC+0.

    2023-04-01T15:16:00Z

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

    Elemen respons

    Element

    Type

    Description

    Example

    object

    TotalCount

    integer

    Jumlah total stack.

    2
    PageSize

    integer

    Jumlah entri per halaman dalam pengaturan paging.

    Nilai maksimum: 50.

    Nilai default: 10.

    10
    RequestId

    string

    ID permintaan.

    FBAC80B4-9C27-529D-BC9C-4155FA5CD7A7
    PageNumber

    integer

    Nomor halaman daftar stack.

    1
    Stacks

    array<object>

    Daftar stack.

    array<object>

    Status

    string

    Status stack.

    CREATE_COMPLETE
    UpdateTime

    string

    Waktu ketika stack terakhir diperbarui. Waktu ditampilkan dalam UTC+0 dalam format standar ISO 8601 tanpa sufiks Z. Format: YYYY-MM-DDThh:mm:ss.

    2022-03-10T07:44:36
    DriftDetectionTime

    string

    Waktu ketika deteksi drift berhasil terbaru dilakukan pada stack.

    2022-03-10T06:46:36
    StatusReason

    string

    Alasan mengapa stack berada dalam status saat ini.

    Stack CREATE completed successfully
    CreateTime

    string

    Waktu ketika stack dibuat. Waktu ditampilkan dalam UTC+0 dalam format standar ISO 8601 tanpa sufiks Z. Format: YYYY-MM-DDThh:mm:ss.

    2022-03-10T06:44:36
    DisableRollback

    boolean

    Menunjukkan apakah rollback dinonaktifkan saat stack gagal dibuat. Nilai yang valid:

    • true: Rollback dinonaktifkan.

    • false (default): Rollback diaktifkan.

    false
    Tags

    array<object>

    Tag stack.

    object

    Key

    string

    Kunci tag dari stack.

    acs:rm:rgId
    Value

    string

    Nilai tag dari stack.

    rg-aek2frunvw7****
    StackName

    string

    Nama stack.

    MyStack
    TimeoutInMinutes

    integer

    Periode waktu habis untuk membuat stack. Satuan: menit. Nilai yang valid: 10, 20, 60, 120, dan 1440.

    Informasi ini dihasilkan berdasarkan log panggilan dan mungkin tidak lengkap. Verifikasi informasinya.

    60
    RegionId

    string

    ID wilayah stack. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.

    cn-hangzhou
    ParentStackId

    string

    ID stack induk.

    4a6c9851-3b0f-4f5f-b4ca-a14bf692****
    StackId

    string

    ID stack.

    67805444-a605-45ee-a57f-83908ff6****
    StackDriftStatus

    string

    Status drift stack dalam deteksi drift berhasil terbaru. Nilai yang valid:

    • DRIFTED: Stack telah mengalami drift.

    • NOT_CHECKED: Tidak ada deteksi drift berhasil yang dilakukan pada stack.

    • IN_SYNC: Stack dalam kondisi sinkron.

    IN_SYNC
    StackType

    string

    Jenis stack. Nilai yang valid:

    • ROS: Stack menggunakan template ROS.

    • Terraform: Stack menggunakan template Terraform.

    ROS
    ResourceGroupId

    string

    ID grup sumber daya.

    rg-aek2frunvw7****
    ServiceManaged

    boolean

    Menunjukkan apakah stack adalah stack terkelola. Nilai yang valid:

    • true: Stack adalah stack terkelola.

    • false: Stack bukan stack terkelola.

    false
    ServiceName

    string

    Nama layanan tempat stack terkelola berada.

    ACVS
    OperationInfo

    object

    Informasi tambahan yang dikembalikan ketika terjadi kesalahan selama operasi stack.

    Catatan

    Properti respons ini hanya dikembalikan dalam kasus tertentu dan berisi setidaknya satu sub-properti. Misalnya, terjadi kesalahan saat API layanan cloud lain dipanggil.

    Code

    string

    Kode error.

    DependencyViolation
    Message

    string

    Pesan error.

    There is still instance(s) in the specified security group.
    RequestId

    string

    ID dari permintaan yang dimulai untuk memanggil operasi API dari layanan Alibaba Cloud lain.

    071D6166-3F6B-5C7B-A1F0-0113FBB643A8
    Action

    string

    Nama operasi API yang dimiliki oleh layanan Alibaba Cloud lain.

    DeleteSecurityGroup
    ResourceType

    string

    Tipe sumber daya tempat terjadinya error operasi.

    ALIYUN::ECS::SecurityGroup
    LogicalResourceId

    string

    ID logis dari sumber daya tempat terjadinya error operasi.

    EcsSecurityGroup
    DeletionProtection

    string

    Menunjukkan apakah perlindungan penghapusan diaktifkan untuk stack. Nilai yang valid:

    • Enabled: Perlindungan penghapusan diaktifkan.

    • Disabled: Perlindungan penghapusan dinonaktifkan. Anda dapat menghapus stack dengan menggunakan konsol atau dengan memanggil operasi DeleteStack.

    Catatan

    Mekanisme perlindungan penghapusan stack bertingkat sama dengan stack root.

    Valid values:

    • Enabled :

      Enabled

    • Disabled :

      Disabled

    Disabled

    Contoh

    Respons sukses

    JSONformat

    {
  "TotalCount": 2,
  "PageSize": 10,
  "RequestId": "FBAC80B4-9C27-529D-BC9C-4155FA5CD7A7",
  "PageNumber": 1,
  "Stacks": [
    {
      "Status": "CREATE_COMPLETE",
      "UpdateTime": "2022-03-10T07:44:36",
      "DriftDetectionTime": "2022-03-10T06:46:36",
      "StatusReason": "Stack CREATE completed successfully",
      "CreateTime": "2022-03-10T06:44:36",
      "DisableRollback": false,
      "Tags": [
        {
          "Key": "acs:rm:rgId",
          "Value": "rg-aek2frunvw7****"
        }
      ],
      "StackName": "MyStack",
      "TimeoutInMinutes": 60,
      "RegionId": "cn-hangzhou",
      "ParentStackId": "4a6c9851-3b0f-4f5f-b4ca-a14bf692****",
      "StackId": "67805444-a605-45ee-a57f-83908ff6****",
      "StackDriftStatus": "IN_SYNC",
      "StackType": "ROS",
      "ResourceGroupId": "rg-aek2frunvw7****",
      "ServiceManaged": false,
      "ServiceName": "ACVS",
      "OperationInfo": {
        "Code": "DependencyViolation",
        "Message": "There is still instance(s) in the specified security group.",
        "RequestId": "071D6166-3F6B-5C7B-A1F0-0113FBB643A8",
        "Action": "DeleteSecurityGroup",
        "ResourceType": "ALIYUN::ECS::SecurityGroup",
        "LogicalResourceId": "EcsSecurityGroup"
      },
      "DeletionProtection": "Disabled"
    }
  ]
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.