全部产品
Search

搜索本产品

    Resource Orchestration Service：ListStacks

    文档中心

    Resource Orchestration Service：ListStacks

    更新时间：Dec 15, 2025

    Menampilkan daftar stack.

    Deskripsi operasi

    Topik ini memberikan contoh cara menampilkan daftar stack. Dalam contoh ini, stack yang dideploy di wilayah China (Hangzhou) ditampilkan.

    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.

    Nilai maksimum: 50.

    Nilai default: 10.

    10
    ParentStackId

    string

    No

    ID tumpukan induk.

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

    string

    Yes

    ID wilayah stack. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.

    cn-hangzhou
    PageNumber

    integer

    No

    Nomor halaman.

    Halaman dimulai dari halaman 1.

    Nilai default: 1.

    1
    ShowNestedStack

    boolean

    No

    Menentukan apakah nested stack dikembalikan. Nilai yang valid:

    • true

    • false (default)

    Catatan

    Jika Anda menentukan ParentStackId, Anda harus mengatur ShowNestedStack ke true.

    true
    StackId

    string

    No

    ID stack. Anda dapat menentukan parameter ini untuk hanya menampilkan ID stack tersebut. Jika ingin menampilkan informasi detail tentang stack, panggil 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: Gagal membuat stack.

    • CREATE_COMPLETE: Stack berhasil dibuat.

    • UPDATE_IN_PROGRESS: Stack sedang diperbarui.

    • UPDATE_FAILED: Gagal memperbarui stack.

    • UPDATE_COMPLETE: Stack berhasil diperbarui.

    • DELETE_IN_PROGRESS: Stack sedang dihapus.

    • DELETE_FAILED: Gagal menghapus stack.

    • CREATE_ROLLBACK_IN_PROGRESS: Resource sedang dikembalikan setelah gagal membuat stack.

    • CREATE_ROLLBACK_FAILED: Gagal mengembalikan resource setelah gagal membuat stack.

    • CREATE_ROLLBACK_COMPLETE: Resource berhasil dikembalikan setelah gagal membuat stack.

    • ROLLBACK_IN_PROGRESS: Resource stack sedang dikembalikan.

    • ROLLBACK_FAILED: Gagal mengembalikan resource stack.

    • ROLLBACK_COMPLETE: Resource stack berhasil dikembalikan.

    • CHECK_IN_PROGRESS: Stack sedang divalidasi.

    • CHECK_FAILED: Gagal memvalidasi stack.

    • CHECK_COMPLETE: Stack berhasil divalidasi.

    • REVIEW_IN_PROGRESS: Stack sedang ditinjau.

    • IMPORT_CREATE_IN_PROGRESS: Stack sedang dibuat menggunakan resource yang diimpor.

    • IMPORT_CREATE_FAILED: Gagal membuat stack menggunakan resource yang diimpor.

    • IMPORT_CREATE_COMPLETE: Stack berhasil dibuat menggunakan resource yang diimpor.

    • IMPORT_CREATE_ROLLBACK_IN_PROGRESS: Resource sedang dikembalikan setelah gagal membuat stack menggunakan resource yang diimpor.

    • IMPORT_CREATE_ROLLBACK_FAILED: Gagal mengembalikan resource setelah gagal membuat stack menggunakan resource yang diimpor.

    • IMPORT_CREATE_ROLLBACK_COMPLETE: Resource berhasil dikembalikan setelah gagal membuat stack menggunakan resource yang diimpor.

    • IMPORT_UPDATE_IN_PROGRESS: Stack sedang diperbarui menggunakan resource yang diimpor.

    • IMPORT_UPDATE_FAILED: Gagal memperbarui stack menggunakan resource yang diimpor.

    • IMPORT_UPDATE_COMPLETE: Stack berhasil diperbarui menggunakan resource yang diimpor.

    • IMPORT_UPDATE_ROLLBACK_IN_PROGRESS: Resource sedang dikembalikan setelah gagal memperbarui stack menggunakan resource yang diimpor.

    • IMPORT_UPDATE_ROLLBACK_FAILED: Gagal mengembalikan resource setelah gagal memperbarui stack menggunakan resource yang diimpor.

    • IMPORT_UPDATE_ROLLBACK_COMPLETE: Resource berhasil dikembalikan setelah gagal memperbarui stack menggunakan resource yang diimpor.

    CREATE_COMPLETE
    StackName

    array

    No

    Nama-nama stack.

    MyStack

    string

    No

    Nama stack N.
    Nama dapat memiliki panjang hingga 255 karakter, dan boleh berisi angka, huruf, tanda hubung (-), dan garis bawah (_). Nama harus dimulai dengan angka atau huruf. Anda dapat menggunakan karakter wildcard (*) untuk pencarian fuzzy.

    Nilai N yang valid: 1 hingga 5.

    MyStack
    Tag

    array<object>

    No

    Tag-tag stack.

    object

    No

    Key

    string

    No

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

    usage
    Value

    string

    No

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

    test
    ResourceGroupId

    string

    No

    ID kelompok sumber daya.
    Untuk informasi selengkapnya tentang kelompok sumber daya, lihat bagian "Resource Group" dalam topik Apa itu Resource Management?.

    rg-acfmxazb4ph6aiy****
    StackIds

    array

    No

    ID-ID stack.

    string

    No

    ID stack N. Anda dapat menentukan satu atau beberapa ID untuk menampilkan satu atau beberapa stack sekaligus. Nilai N yang valid: 1 hingga 10.

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

    string

    No

    Awal rentang waktu untuk kueri. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

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

    string

    No

    Akhir rentang waktu saat data diambil. Waktu mengikuti standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.

    2023-04-01T15:16:00Z

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

    Elemen respons

    Element

    Type

    Description

    Example

    object

    TotalCount

    integer

    Total jumlah stack.

    2
    PageSize

    integer

    Jumlah entri per halaman.

    Nilai maksimum: 50.

    Nilai default: 10.

    10
    RequestId

    string

    ID permintaan.

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

    integer

    Nomor halaman.

    1
    Stacks

    array<object>

    Detail stack.

    array<object>

    Status

    string

    Status stack.

    CREATE_COMPLETE
    UpdateTime

    string

    Waktu stack diperbarui. Waktu mengikuti standar ISO 8601 dengan format YYYY-MM-DDThh:mm:ss. Waktu ditampilkan dalam UTC.

    2022-03-10T07:44:36
    DriftDetectionTime

    string

    Waktu deteksi drift terakhir yang berhasil dilakukan pada stack.

    2022-03-10T06:46:36
    StatusReason

    string

    Alasan stack berada dalam status saat ini.

    Stack CREATE completed successfully
    CreateTime

    string

    Waktu stack dibuat. Waktu mengikuti standar ISO 8601 dengan format YYYY-MM-DDThh:mm:ss. Waktu ditampilkan dalam UTC.

    2022-03-10T06:44:36
    DisableRollback

    boolean

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

    • true

    • false (default)

    false
    Tags

    array<object>

    Tag-tag stack.

    object

    Key

    string

    Kunci tag stack.

    acs:rm:rgId
    Value

    string

    Nilai tag stack.

    rg-aek2frunvw7****
    StackName

    string

    Nama stack.

    MyStack
    TimeoutInMinutes

    integer

    Batas waktu pembuatan stack. Satuan: menit.

    60
    RegionId

    string

    ID wilayah stack. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.

    cn-hangzhou
    ParentStackId

    string

    ID tumpukan induk.

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

    string

    ID stack.

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

    string

    Status stack berdasarkan deteksi drift terakhir yang berhasil dilakukan. Nilai yang valid:

    • DRIFTED: Stack telah mengalami deviasi.

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

    • IN_SYNC: Stack sedang disinkronkan.

    IN_SYNC
    StackType

    string

    Jenis stack. Nilai yang valid:

    • ROS: Stack ROS. Stack dibuat menggunakan Template ROS.

    • Terraform: Stack Terraform. Stack dibuat menggunakan Template Terraform.

    ROS
    ResourceGroupId

    string

    ID kelompok sumber daya.

    rg-aek2frunvw7****
    ServiceManaged

    boolean

    Menunjukkan apakah stack merupakan stack terkelola. Nilai yang valid:

    • true

    • false

    false
    ServiceName

    string

    Nama layanan tempat stack terkelola tersebut berada.

    ACVS
    OperationInfo

    object

    Informasi tambahan yang dikembalikan jika terjadi kesalahan pada operasi stack.

    Catatan

    Parameter ini hanya dikembalikan dalam kondisi tertentu, dan dikembalikan bersama setidaknya satu sub-parameter. Misalnya, terjadi kesalahan saat memanggil operasi API layanan Alibaba Cloud lainnya.

    Code

    string

    Kode kesalahan.

    DependencyViolation
    Message

    string

    Pesan kesalahan.

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

    string

    ID permintaan yang dikirim untuk memanggil operasi API layanan Alibaba Cloud lainnya.

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

    string

    Nama operasi API milik layanan Alibaba Cloud lainnya.

    DeleteSecurityGroup
    ResourceType

    string

    Jenis resource tempat terjadinya kesalahan operasi.

    ALIYUN::ECS::SecurityGroup
    LogicalResourceId

    string

    ID logis resource tempat terjadinya kesalahan operasi.

    EcsSecurityGroup
    DeletionProtection

    string

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

    • Enabled: Perlindungan penghapusan diaktifkan untuk stack.

    • Disabled: Perlindungan penghapusan dinonaktifkan untuk stack. Dalam hal ini, Anda dapat menghapus stack melalui Konsol atau dengan memanggil operasi DeleteStack.

    Catatan

    Perlindungan penghapusan untuk nested stack sama dengan tumpukan akar-nya.

    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.