All Products
Search
Document Center

Resource Orchestration Service:GetStack

Last Updated:Jun 17, 2026

Mengkueri informasi stack.

Deskripsi operasi

Topik ini menyediakan contoh cara mengkueri informasi stack yang ID-nya c754d2a4-28f1-46df-b557-9586173a**** 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:GetStack

get

*stack

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

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

StackId

string

Yes

ID stack.

c754d2a4-28f1-46df-b557-9586173a****

RegionId

string

Yes

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

cn-hangzhou

ClientToken

string

No

Token klien yang digunakan untuk memastikan idempotensi permintaan. Token dihasilkan oleh klien dan harus unik secara global.
Token dapat memiliki panjang hingga 64 karakter.
Untuk informasi selengkapnya, lihat Cara memastikan idempotensi.

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

OutputOption

string

No

Apakah akan mengembalikan parameter Outputs (daftar output stack). Nilai valid:

  • Enabled (default): Mengembalikan parameter Outputs.

  • Disabled: Tidak mengembalikan parameter Outputs.

Catatan

Menghitung Outputs memakan waktu. Jika Anda tidak memerlukan informasi Outputs, atur OutputOption ke Disabled untuk meningkatkan kecepatan tanggapan API.

Disabled

ShowResourceProgress

string

No

Apakah akan mengembalikan parameter ResourceProgress (kemajuan pemrosesan resource). Nilai valid:

  • Disabled (default): Tidak mengembalikan parameter ResourceProgress.

  • PercentageOnly: Mengembalikan parameter StackOperationProgress dan StackActionProgress di ResourceProgress.

Catatan

Mendukung stack ROS dan stack Terraform. Mendukung operasi pembuatan stack (termasuk pembuatan lanjutan), pembaruan, penghapusan, impor sumber daya, dan operasi rollback yang sesuai.

  • EnabledIfCreateStack (tidak direkomendasikan): Mengembalikan parameter *Count dan InProgressResourceDetails di ResourceProgress hanya selama pembuatan stack.

Catatan

Selama pembuatan stack, status stack adalah CREATE_IN_PROGRESS, CREATE_COMPLETE, CREATE_FAILED, CREATE_ROLLBACK_IN_PROGRESS, CREATE_ROLLBACK_COMPLETE, atau CREATE_ROLLBACK_FAILED.

Disabled

LogOption

string

No

Opsi log. Nilai valid:

  • None: Tidak mengembalikan log.

  • Stack (default): Mengembalikan log terkait stack.

  • Resource: Mengembalikan log terkait resource.

  • All: Mengembalikan semua log.

Stack

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

Elemen respons

Element

Type

Description

Example

object

Status

string

Status stack. Nilai valid:

  • CREATE_IN_PROGRESS: Stack sedang dibuat.

  • CREATE_FAILED: Stack gagal dibuat.

  • CREATE_COMPLETE: Stack berhasil dibuat.

  • UPDATE_IN_PROGRESS: Stack sedang diperbarui.

  • UPDATE_FAILED: Stack gagal diperbarui.

  • UPDATE_COMPLETE: Stack berhasil diperbarui.

  • DELETE_IN_PROGRESS: Stack sedang dihapus.

  • DELETE_FAILED: Stack gagal dihapus.

  • DELETE_COMPLETE: Stack berhasil dihapus.

  • CREATE_ROLLBACK_IN_PROGRESS: Pembuatan stack sedang di-rollback.

  • CREATE_ROLLBACK_FAILED: Pembuatan stack gagal di-rollback.

  • CREATE_ROLLBACK_COMPLETE: Pembuatan stack berhasil di-rollback.

  • ROLLBACK_IN_PROGRESS: Stack sedang di-rollback.

  • ROLLBACK_FAILED: Stack gagal di-rollback.

  • ROLLBACK_COMPLETE: Stack berhasil di-rollback.

  • CHECK_IN_PROGRESS: Stack sedang divalidasi.

  • CHECK_FAILED: Stack gagal divalidasi.

  • CHECK_COMPLETE: Stack berhasil 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 berhasil dibuat melalui impor sumber daya.

  • IMPORT_CREATE_ROLLBACK_IN_PROGRESS: Pembuatan stack melalui impor sumber daya sedang di-rollback.

  • IMPORT_CREATE_ROLLBACK_FAILED: Pembuatan stack melalui impor sumber daya gagal di-rollback.

  • IMPORT_CREATE_ROLLBACK_COMPLETE: Pembuatan stack melalui impor sumber daya berhasil di-rollback.

  • 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 berhasil diperbarui melalui impor sumber daya.

  • IMPORT_UPDATE_ROLLBACK_IN_PROGRESS: Pembaruan stack melalui impor sumber daya sedang di-rollback.

  • IMPORT_UPDATE_ROLLBACK_FAILED: Pembaruan stack melalui impor sumber daya gagal di-rollback.

  • IMPORT_UPDATE_ROLLBACK_COMPLETE: Pembaruan stack melalui impor sumber daya berhasil di-rollback.

CREATE_COMPLETE

Description

string

Deskripsi stack.

Create a VPC.

Parameters

array<object>

Parameter stack.

object

ParameterKey

string

Nama parameter.

ALIYUN::Region

ParameterValue

string

Nilai parameter.

cn-hangzhou

RequestId

string

ID permintaan.

B288A0BE-D927-4888-B0F7-B35EF84B6E6F

StatusReason

string

Alasan stack berada dalam status saat ini.

Stack CREATE completed successfully

ParentStackId

string

ID tumpukan induk.

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

CreateTime

string

Waktu ketika stack dibuat. Waktu ditampilkan dalam UTC+0 dan mengikuti standar ISO 8601 tanpa Z di akhir. Format: YYYY-MM-DDThh:mm:ss.

2020-09-16T08:21:40

DeletionProtection

string

Apakah perlindungan penghapusan diaktifkan untuk stack. Nilai valid:

  • Enabled: Perlindungan penghapusan diaktifkan.

  • Disabled: Perlindungan penghapusan dinonaktifkan. Dalam hal ini, Anda dapat merilis stack menggunakan konsol atau memanggil operasi DeleteStack.

Catatan

Mekanisme perlindungan penghapusan tumpukan bersarang sama dengan tumpukan akar.

Disabled

RootStackId

string

ID tumpukan akar. Parameter ini hanya dikembalikan ketika stack adalah tumpukan bersarang.

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

TemplateDescription

string

Deskripsi templat.

Create a VPC.

StackType

string

Tipe stack. Nilai valid:

  • ROS: Stack menggunakan Templat ROS.

  • Terraform: Stack menggunakan Templat Terraform.

ROS

RamRoleName

string

Nama peran RAM. Resource Orchestration Service (ROS) mengasumsikan peran ini untuk membuat stack dan memanggil operasi API atas nama pengguna menggunakan kredensial peran.
ROS selalu menggunakan peran ini untuk semua operasi yang dilakukan pada stack. Selama pengguna memiliki izin untuk melakukan operasi pada stack, ROS akan menggunakan peran ini meskipun pengguna tidak memiliki izin untuk menggunakan peran tersebut. Hal ini memastikan bahwa peran memberikan hak istimewa minimal.
Jika tidak ada nilai yang ditentukan, ROS menggunakan peran yang sebelumnya dikaitkan dengan stack. Jika tidak ada peran yang tersedia, ROS menggunakan kredensial sementara yang dihasilkan dari kredensial pengguna.
Nama peran RAM dapat memiliki panjang hingga 64 byte.

test-role

UpdateTime

string

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

2020-09-17T08:21:40

Outputs

array<object>

Daftar output stack.

object

Daftar output stack.

Catatan

Parameter ini hanya dikembalikan ketika OutputOption diatur ke Enabled.

[{"Description": "VPC ID","OutputKey": "VpcId","OutputValue": "vpc-bp1m6fww66xbntjyc****"}]

DriftDetectionTime

string

Waktu ketika Pendeteksian drift terakhir yang berhasil dilakukan pada stack.

2020-09-16T09:21:40

RegionId

string

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

cn-hangzhou

StackDriftStatus

string

Status deviasi stack pada pendeteksian drift terakhir yang berhasil. Nilai valid:

  • DRIFTED: Stack telah mengalami deviasi.

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

  • IN_SYNC: Stack sinkron.

IN_SYNC

NotificationURLs

array

URL callback untuk menerima event stack.

string

URL callback untuk menerima event stack.

["http://127.XX.XX.1:8080/x", "http://127.0.XX.XX:8080/y"]

DisableRollback

boolean

Apakah rollback dinonaktifkan ketika stack gagal dibuat. Nilai valid:

  • true: Rollback dinonaktifkan. Tidak ada rollback yang dilakukan ketika stack gagal dibuat.

  • false (default): Rollback diaktifkan. Rollback dilakukan ketika stack gagal dibuat.

false

StackName

string

Nama stack.
Nama dapat memiliki panjang hingga 255 karakter dan harus dimulai dengan digit atau huruf. Nama dapat berisi digit, huruf, tanda hubung (-), dan garis bawah (_).

MyStack

Tags

array<object>

Tag stack.

object

Key

string

Kunci tag stack.

usage

Value

string

Nilai tag stack.

test

TimeoutInMinutes

integer

Waktu tunggu untuk pembuatan stack. Unit: minutes.

10

StackId

string

ID stack.

c754d2a4-28f1-46df-b557-9586173a****

ResourceGroupId

string

ID kelompok sumber daya.

rg-acfmxazb4ph6aiy****

ResourceProgress

object

Kemajuan pemrosesan resource.

TotalResourceCount

integer

Jumlah total resource.

Catatan

Parameter ini hanya dikembalikan ketika ShowResourceProgress diatur ke EnabledIfCreateStack.

2

SuccessResourceCount

integer

Jumlah resource yang berhasil diproses.

Catatan

Parameter ini hanya dikembalikan ketika ShowResourceProgress diatur ke EnabledIfCreateStack.

1

FailedResourceCount

integer

Jumlah resource yang gagal diproses.

Catatan

Parameter ini hanya dikembalikan ketika ShowResourceProgress diatur ke EnabledIfCreateStack.

0

InProgressResourceCount

integer

Jumlah resource yang sedang diproses.

Catatan

Parameter ini hanya dikembalikan ketika ShowResourceProgress diatur ke EnabledIfCreateStack.

1

PendingResourceCount

integer

Jumlah resource yang menunggu diproses.

Catatan

Parameter ini hanya dikembalikan ketika ShowResourceProgress diatur ke EnabledIfCreateStack.

0

InProgressResourceDetails

array<object>

Daftar detail kemajuan untuk resource yang sedang diproses.

Catatan

Parameter ini hanya dikembalikan ketika ShowResourceProgress diatur ke EnabledIfCreateStack.

object

Detail kemajuan resource yang sedang diproses.

ResourceName

string

The resource name.

WaitCondition

ResourceType

string

The resource type.

ALIYUN::ROS::WaitCondition

ProgressValue

number

The current progress value of the resource.

5

ProgressTargetValue

number

The target progress value of the resource.

10

StackOperationProgress

number

Persentase kemajuan operasi stack. Rentang nilai: 0 hingga 100.

Contoh: Selama pembuatan stack, nilai dimulai dari 0 dan meningkat. Jika pembuatan berhasil, nilai mencapai 100. Jika pembuatan gagal dan rollback dimulai, nilai menurun. Ketika rollback berhasil, nilai mencapai 0. Parameter ini menunjukkan kemajuan keseluruhan operasi pembuatan, terlepas dari apakah status stack sedang membuat atau melakukan rollback.

Catatan

Parameter ini hanya dikembalikan ketika ShowResourceProgress diatur ke PercentageOnly.

100

StackActionProgress

number

Persentase kemajuan aksi stack. Rentang nilai: 0 hingga 100.

Contoh: Selama pembuatan stack, nilai dimulai dari 0 dan meningkat. Jika pembuatan berhasil, nilai mencapai 100. Jika pembuatan gagal dan rollback dimulai, nilai dimulai dari nilai lain (100 dikurangi nilai kemajuan saat pembuatan resource gagal) dan meningkat. Ketika rollback berhasil, nilai mencapai 100. Selama pembuatan stack, parameter ini menunjukkan kemajuan aksi pembuatan. Selama rollback stack, parameter ini menunjukkan kemajuan aksi rollback.

Catatan

Parameter ini hanya dikembalikan ketika ShowResourceProgress diatur ke PercentageOnly.

100

Log

object

Log output terkait stack.

TerraformLogs

array<object>

Log output Terraform. Parameter ini hanya dikembalikan untuk stack Terraform. Parameter ini dikembalikan ketika LogOption tidak ditentukan, atau ketika LogOption diatur ke Stack atau All.

Catatan

Parameter ini tidak dikembalikan untuk stack yang sedang berjalan. Parameter ini menunjukkan log dari operasi terbaru (pembuatan, pembuatan lanjutan, pembaruan, atau penghapusan) pada stack.

object

test.

Command

string

The name of the Terraform command executed. Valid values:

  • apply

  • plan

  • destroy

  • version

For more information about these commands, see Command.

apply

Stream

string

The output stream. Valid values:

  • stdout: Standard output.

  • stderr: Standard error.

stdout

Content

string

The content output by the current command to the current output stream.

Apply complete! Resources: 42 added, 0 changed, 0 destroyed.

ResourceLogs

array<object>

Log output resource. Parameter ini dikembalikan ketika LogOption diatur ke Resource atau All.

Catatan

Hanya tipe resource tertentu yang mengembalikan log resource, seperti ALIYUN::ROS::ResourceCleaner.

array<object>

test.

ResourceName

string

The resource name defined in the template.

MyResourceCleaner

Logs

array<object>

All logs associated with the resource.

object

test

Keys

array

The list of keywords for a log associated with the resource.

string

A keyword.

ResourceDetails

Content

string

The content of a log associated with the resource.

[]

TemplateId

string

ID templat. Parameter ini hanya dikembalikan ketika templat yang digunakan oleh stack adalah template pribadi atau template bersama.

Jika templat adalah template bersama, nilai yang dikembalikan sama dengan TemplateARN templat.

a52f81be-496f-4e1c-a286-8852ab54****

TemplateVersion

string

Versi templat. Parameter ini hanya dikembalikan ketika templat yang digunakan oleh stack adalah template pribadi atau template bersama.

Jika templat adalah template bersama, parameter ini hanya dikembalikan ketika VersionOption diatur ke AllVersions selama berbagi.

Nilai valid: v1 hingga v100.

v1

TemplateScratchId

string

ID skenario sumber daya. Parameter ini hanya dikembalikan ketika templat yang digunakan oleh stack dihasilkan dari skenario sumber daya.

ts-7f7a704cf71c49a6****

TemplateURL

string

URL file yang berisi body templat. Parameter ini hanya dikembalikan ketika templat yang digunakan oleh stack berasal dari URL, termasuk server web (HTTP atau HTTPS) atau bucket OSS Alibaba Cloud.

oss://ros/template/demo

Interface

string

Deskripsi antarmuka.

{}

ServiceManaged

boolean

Apakah stack adalah stack terkelola. Nilai 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 error selama operasi stack.

Catatan

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

Code

string

Kode kesalahan.

DependencyViolation

Message

string

Paket kesalahan.

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

RequestId

string

ID permintaan panggilan API ke layanan cloud lain.

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

Action

string

Nama operasi API yang dipanggil pada layanan cloud lain.

DeleteSecurityGroup

ResourceType

string

Tipe resource tempat terjadi error operasi.

ALIYUN::ECS::SecurityGroup

LogicalResourceId

string

ID logis resource tempat terjadi error operasi.

EcsSecurityGroup

OrderIds

array

Daftar ID pesanan. Parameter ini hanya dikembalikan ketika pembayaran manual untuk pesanan langganan dikonfigurasi selama pembuatan stack.

string

ID pesanan.

2161413696****

CheckedStackResourceCount

integer

Jumlah resource yang telah dilakukan Pendeteksian drift.

Catatan

Parameter ini hanya dikembalikan ketika Pendeteksian drift terakhir pada stack berhasil.

1

NotCheckedStackResourceCount

integer

Jumlah resource yang belum dilakukan Pendeteksian drift.

Catatan

Parameter ini hanya dikembalikan ketika Pendeteksian drift terakhir pada stack berhasil.

1

RollbackFailedRootReason

string

Ketika status stack adalah rollback gagal, bidang ini menampilkan penyebab utama kegagalan pada fase sebelumnya yang memicu rollback.

Resource UPDATE failed: Exception: resources.FailToCreate: FailToCreate: reason

Contoh

Respons sukses

JSONformat

{
  "Status": "CREATE_COMPLETE",
  "Description": "Create a VPC.",
  "Parameters": [
    {
      "ParameterKey": "ALIYUN::Region",
      "ParameterValue": "cn-hangzhou"
    }
  ],
  "RequestId": "B288A0BE-D927-4888-B0F7-B35EF84B6E6F",
  "StatusReason": "Stack CREATE completed successfully",
  "ParentStackId": "4a6c9851-3b0f-4f5f-b4ca-a14bf692****",
  "CreateTime": "2020-09-16T08:21:40",
  "DeletionProtection": "Disabled",
  "RootStackId": "4a6c9851-3b0f-4f5f-b4ca-a14bf692****",
  "TemplateDescription": "Create a VPC.",
  "StackType": "ROS",
  "RamRoleName": "test-role",
  "UpdateTime": "2020-09-17T08:21:40",
  "Outputs": [
    [
      {
        "Description": "VPC ID",
        "OutputKey": "VpcId",
        "OutputValue": "vpc-bp1m6fww66xbntjyc****"
      }
    ]
  ],
  "DriftDetectionTime": "2020-09-16T09:21:40",
  "RegionId": "cn-hangzhou",
  "StackDriftStatus": "IN_SYNC",
  "NotificationURLs": [
    "[\"http://127.XX.XX.1:8080/x\", \"http://127.0.XX.XX:8080/y\"]"
  ],
  "DisableRollback": false,
  "StackName": "MyStack",
  "Tags": [
    {
      "Key": "usage",
      "Value": "test"
    }
  ],
  "TimeoutInMinutes": 10,
  "StackId": "c754d2a4-28f1-46df-b557-9586173a****",
  "ResourceGroupId": "rg-acfmxazb4ph6aiy****",
  "ResourceProgress": {
    "TotalResourceCount": 2,
    "SuccessResourceCount": 1,
    "FailedResourceCount": 0,
    "InProgressResourceCount": 1,
    "PendingResourceCount": 0,
    "InProgressResourceDetails": [
      {
        "ResourceName": "WaitCondition",
        "ResourceType": "ALIYUN::ROS::WaitCondition",
        "ProgressValue": 5,
        "ProgressTargetValue": 10
      }
    ],
    "StackOperationProgress": 100,
    "StackActionProgress": 100
  },
  "Log": {
    "TerraformLogs": [
      {
        "Command": "apply",
        "Stream": "stdout",
        "Content": "Apply complete! Resources: 42 added, 0 changed, 0 destroyed."
      }
    ],
    "ResourceLogs": [
      {
        "ResourceName": "MyResourceCleaner",
        "Logs": [
          {
            "Keys": [
              "ResourceDetails"
            ],
            "Content": "[]"
          }
        ]
      }
    ]
  },
  "TemplateId": "a52f81be-496f-4e1c-a286-8852ab54****",
  "TemplateVersion": "v1",
  "TemplateScratchId": "ts-7f7a704cf71c49a6****",
  "TemplateURL": "oss://ros/template/demo",
  "Interface": "{}",
  "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"
  },
  "OrderIds": [
    "2161413696****"
  ],
  "CheckedStackResourceCount": 1,
  "NotCheckedStackResourceCount": 1,
  "RollbackFailedRootReason": "Resource UPDATE failed: Exception: resources.FailToCreate: FailToCreate: reason"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.