Mengkueri informasi stack.
Deskripsi operasi
Topik ini menyediakan contoh cara mengkueri informasi stack dengan ID c754d2a4-28f1-46df-b557-9586173a**** di wilayah China (Hangzhou).
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
ros:GetStack |
get |
*stack.
|
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. Nilai dihasilkan oleh klien dan harus unik secara global. |
123e4567-e89b-12d3-a456-42665544**** |
| OutputOption |
string |
No |
Apakah akan mengembalikan parameter Outputs (daftar Outputs stack). Nilai valid:
Catatan
Menghitung Outputs memakan waktu. Jika Anda tidak memerlukan informasi Outputs, atur OutputOption ke Disabled untuk meningkatkan kecepatan tanggapan operasi. |
Disabled |
| ShowResourceProgress |
string |
No |
Apakah akan mengembalikan parameter ResourceProgress (progres pemrosesan Sumber daya). Nilai valid:
Catatan
Opsi ini mendukung stack ROS dan Tumpukan Terraform. Opsi ini mendukung pembuatan stack (termasuk pembuatan lanjutan), pembaruan, penghapusan, Impor sumber daya, dan operasi rollback terkait.
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:
|
Stack |
Untuk informasi lebih lanjut tentang parameter permintaan umum, lihat Parameter umum.
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
|||
| Status |
string |
Status stack. Nilai valid:
|
CREATE_COMPLETE |
| Description |
string |
Deskripsi stack. |
Buat 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. |
Pembuatan stack berhasil |
| ParentStackId |
string |
ID tumpukan induk. |
4a6c9851-3b0f-4f5f-b4ca-a14bf692**** |
| CreateTime |
string |
Pengatur waktu ketika stack dibuat. Pengatur waktu ditampilkan dalam UTC+0 dan mengikuti standar ISO 8601 tanpa karakter Z di akhir. Format: YYYY-MM-DDThh:mm:ss. |
2020-09-16T08:21:40 |
| DeletionProtection |
string |
Apakah perlindungan penghapusan diaktifkan untuk stack. Nilai valid:
Catatan
Mekanisme perlindungan penghapusan pada tumpukan bersarang sama dengan tumpukan akar. |
Disabled |
| RootStackId |
string |
ID tumpukan akar. Parameter ini hanya dikembalikan ketika stack merupakan tumpukan bersarang. |
4a6c9851-3b0f-4f5f-b4ca-a14bf692**** |
| TemplateDescription |
string |
Deskripsi templat. |
Buat VPC |
| StackType |
string |
Tipe stack. Nilai valid:
|
ROS |
| RamRoleName |
string |
Nama Peran RAM. Resource Orchestration Service (ROS) mengasumsikan peran ini untuk membuat stack dan memanggil operasi API atas nama pengguna dengan menggunakan kredensial peran tersebut. |
test-peran |
| UpdateTime |
string |
Pengatur waktu ketika stack terakhir kali diperbarui. Pengatur waktu ditampilkan dalam UTC+0 dan mengikuti standar ISO 8601 tanpa karakter Z di akhir. Format: YYYY-MM-DDThh:mm:ss. |
2020-09-17T08:21:40 |
| Outputs |
array<object> |
Outputs stack. |
|
|
object |
Outputs stack. Catatan
Parameter ini hanya dikembalikan ketika OutputOption diatur ke Enabled. |
[{"Description": "ID VPC","OutputKey": "VpcId","OutputValue": "vpc-bp1m6fww66xbntjyc****"}] |
|
| DriftDetectionTime |
string |
Pengatur waktu ketika Pendeteksian deviasi terakhir yang berhasil dilakukan pada stack. Pengatur waktu dalam format YYYY-MM-DDThh:mm:ss. |
2020-09-16T09:21:40 |
| RegionId |
string |
ID wilayah stack. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru. |
cn-hangzhou |
| StackDriftStatus |
string |
Status drift stack berdasarkan Pendeteksian drift terakhir yang berhasil. Nilai valid:
|
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 pembuatan stack gagal. Nilai valid:
|
false |
| StackName |
string |
Nama stack. |
StackSaya |
| Tags |
array<object> |
Tag stack. |
|
|
object |
|||
| Key |
string |
Kunci tag stack. |
penggunaan |
| Value |
string |
Nilai tag stack. |
uji |
| TimeoutInMinutes |
integer |
Periode pengatur waktu untuk membuat stack. Unit: minutes. |
10 |
| StackId |
string |
ID stack. |
c754d2a4-28f1-46df-b557-9586173a**** |
| ResourceGroupId |
string |
ID kelompok sumber daya. |
rg-acfmxazb4ph6aiy**** |
| ResourceProgress |
object |
Progres pemrosesan sumber daya. |
|
| TotalResourceCount |
integer |
Jumlah total sumber daya. Catatan
Parameter ini hanya dikembalikan ketika ShowResourceProgress diatur ke EnabledIfCreateStack. |
2 |
| SuccessResourceCount |
integer |
Jumlah sumber daya yang berhasil diproses. Catatan
Parameter ini hanya dikembalikan ketika ShowResourceProgress diatur ke EnabledIfCreateStack. |
1 |
| FailedResourceCount |
integer |
Jumlah sumber daya yang gagal diproses. Catatan
Parameter ini hanya dikembalikan ketika ShowResourceProgress diatur ke EnabledIfCreateStack. |
0 |
| InProgressResourceCount |
integer |
Jumlah sumber daya yang sedang diproses. Catatan
Parameter ini hanya dikembalikan ketika ShowResourceProgress diatur ke EnabledIfCreateStack. |
1 |
| PendingResourceCount |
integer |
Jumlah sumber daya yang menunggu untuk diproses. Catatan
Parameter ini hanya dikembalikan ketika ShowResourceProgress diatur ke EnabledIfCreateStack. |
0 |
| InProgressResourceDetails |
array<object> |
Daftar detail progres untuk sumber daya yang sedang diproses. Catatan
Parameter ini hanya dikembalikan ketika ShowResourceProgress diatur ke EnabledIfCreateStack. |
|
|
object |
Detail progres sumber daya yang sedang diproses. |
||
| ResourceName |
string |
Nama sumber daya. |
WaitCondition |
| ResourceType |
string |
Tipe sumber daya. |
ALIYUN::ROS::WaitCondition |
| ProgressValue |
number |
Nilai progres saat ini dari sumber daya. |
5 |
| ProgressTargetValue |
number |
Nilai progres target dari sumber daya. |
10 |
| StackOperationProgress |
number |
Progres operasi stack dalam persentase. Nilai valid: 0 hingga 100. Contoh: Ketika stack sedang dibuat, nilai dimulai dari 0 dan meningkat. Jika stack berhasil dibuat, nilai mencapai 100. Jika pembuatan gagal dan rollback dimulai, nilai menurun. Ketika rollback berhasil, nilai mencapai 0. Parameter ini menunjukkan progres 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 |
Progres aksi stack dalam persentase. Nilai valid: 0 hingga 100. Contoh: Ketika stack sedang dibuat, nilai dimulai dari 0 dan meningkat. Jika stack berhasil dibuat, nilai mencapai 100. Jika pembuatan gagal dan rollback dimulai, nilai dimulai dari nilai lain (100 dikurangi nilai progres ketika pembuatan sumber daya gagal) dan meningkat. Ketika rollback berhasil, nilai mencapai 100. Selama pembuatan stack, parameter ini menunjukkan progres aksi pembuatan. Selama rollback stack, parameter ini menunjukkan progres aksi rollback. Catatan
Parameter ini hanya dikembalikan ketika ShowResourceProgress diatur ke PercentageOnly. |
100 |
| Log |
object |
Log yang terkait dengan stack. |
|
| TerraformLogs |
array<object> |
Log output Terraform. Parameter ini hanya dikembalikan untuk Tumpukan 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 berisi log dari operasi terbaru (membuat, melanjutkan pembuatan, memperbarui, atau menghapus) pada stack. |
|
|
object |
Satu entri log output Terraform. |
||
| Command |
string |
Nama perintah Terraform yang dijalankan. Nilai valid:
Untuk informasi lebih lanjut tentang perintah, lihat Command. |
apply |
| Stream |
string |
Aliran output. Nilai valid:
|
stdout |
| Content |
string |
Konten yang dikeluarkan oleh perintah saat ini dalam aliran output saat ini. |
Penerapan selesai! Sumber daya: 42 ditambahkan, 0 diubah, 0 dihapus |
| ResourceLogs |
array<object> |
Log output sumber daya. Parameter ini dikembalikan ketika LogOption diatur ke Resource atau All. Catatan
Hanya tipe sumber daya tertentu yang mengembalikan log sumber daya, seperti |
|
|
array<object> |
Log output dari satu sumber daya. |
||
| ResourceName |
string |
Nama sumber daya yang didefinisikan dalam templat. |
MyResourceCleaner |
| Logs |
array<object> |
Semua log yang terkait dengan sumber daya. |
|
|
object |
Satu entri log output sumber daya. |
||
| Keys |
array |
Daftar kata kunci untuk entri log yang terkait dengan sumber daya. |
|
|
string |
Kata kunci. |
ResourceDetails |
|
| Content |
string |
Konten entri log yang terkait dengan sumber daya. |
[] |
| 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 dari templat tersebut. |
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 proses 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, seperti server web (HTTP atau HTTPS) atau Bucket OSS Alibaba Cloud. |
oss://ros/template/demo |
| Interface |
string |
Deskripsi antarmuka. |
{} |
| ServiceManaged |
boolean |
Apakah stack merupakan stack terkelola. Nilai valid:
|
false |
| ServiceName |
string |
Nama layanan tempat stack terkelola berada. |
ACVS |
| OperationInfo |
object |
Informasi tambahan yang dikembalikan ketika terjadi error selama operasi stack. Catatan
Parameter 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. |
Masih ada instans di kelompok keamanan yang ditentukan. |
| RequestId |
string |
ID permintaan dari pemanggilan API ke layanan cloud lain. |
071D6166-3F6B-5C7B-A1F0-0113FBB643A8 |
| Action |
string |
Nama operasi API yang dipanggil pada layanan cloud lain. |
HapusSecurityGroup |
| ResourceType |
string |
Tipe sumber daya tempat terjadinya error operasi. |
ALIYUN::ECS::SecurityGroup |
| LogicalResourceId |
string |
ID logis sumber daya tempat terjadinya 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 sumber daya yang telah dilakukan Pendeteksian deviasi. Catatan
Parameter ini hanya dikembalikan ketika Pendeteksian deviasi terakhir pada stack berhasil. |
1 |
| NotCheckedStackResourceCount |
integer |
Jumlah sumber daya yang belum dilakukan Pendeteksian deviasi. Catatan
Parameter ini hanya dikembalikan ketika Pendeteksian deviasi 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. |
Sumber daya 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.