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
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. Token dihasilkan oleh klien dan harus unik secara global. |
123e4567-e89b-12d3-a456-42665544**** |
| OutputOption |
string |
No |
Apakah akan mengembalikan parameter Outputs (daftar output stack). Nilai valid:
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:
Catatan
Mendukung stack ROS dan stack Terraform. Mendukung operasi pembuatan stack (termasuk pembuatan lanjutan), pembaruan, penghapusan, impor sumber daya, dan operasi rollback yang sesuai.
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 selengkapnya 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. |
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:
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 |
| 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. |
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:
|
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:
|
false |
| StackName |
string |
Nama stack. |
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:
For more information about these commands, see Command. |
apply |
| Stream |
string |
The output stream. Valid values:
|
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 |
|
|
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:
|
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.