Mengambil informasi mengenai stack di Resource Orchestration Service (ROS).
Deskripsi operasi
Pada contoh ini, informasi mengenai stack dengan ID c754d2a4-28f1-46df-b557-9586173a**** di wilayah China (Hangzhou) diambil.
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 operasi DescribeRegions untuk menanyakan daftar wilayah terbaru. |
cn-hangzhou |
| ClientToken |
string |
No |
Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token tersebut, tetapi harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. |
123e4567-e89b-12d3-a456-42665544**** |
| OutputOption |
string |
No |
Menentukan apakah Outputs dikembalikan atau tidak. Nilai yang valid:
Catatan
Parameter Outputs memerlukan waktu lama untuk dihitung. Jika Anda tidak memerlukan Outputs dari stack, kami menyarankan agar Anda mengatur OutputOption ke Disabled untuk meningkatkan kecepatan respons operasi GetStack. |
Disabled |
| ShowResourceProgress |
string |
No |
Menentukan apakah informasi ResourceProgress dikembalikan atau tidak. Nilai yang valid:
Catatan
Stack ROS dan Terraform didukung. Operasi pembuatan, pembuatan yang dilanjutkan, pembaruan, penghapusan, impor, dan rollback pada stack didukung.
Catatan
Selama operasi pembuatan, stack berada dalam salah satu status berikut: CREATE_IN_PROGRESS, CREATE_COMPLETE, CREATE_FAILED, CREATE_ROLLBACK_IN_PROGRESS, CREATE_ROLLBACK_COMPLETE, dan CREATE_ROLLBACK_FAILED. |
Disabled |
| LogOption |
string |
No |
Opsi untuk mengembalikan log. Nilai yang valid:
|
Stack |
Untuk informasi selengkapnya mengenai parameter permintaan umum, lihat Common parameters.
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
|||
| Status |
string |
Status stack. Nilai yang 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 mengapa stack berada dalam status saat ini. |
Stack CREATE completed successfully |
| ParentStackId |
string |
ID stack induk. |
4a6c9851-3b0f-4f5f-b4ca-a14bf692**** |
| CreateTime |
string |
Waktu pembuatan stack. Waktu mengikuti standar ISO 8601 dalam format YYYY-MM-DDThh:mm:ss. Waktu ditampilkan dalam UTC. |
2020-09-16T08:21:40 |
| DeletionProtection |
string |
Menunjukkan apakah perlindungan penghapusan diaktifkan untuk stack. Nilai yang valid:
Catatan
Perlindungan penghapusan stack bersarang sama dengan perlindungan penghapusan stack akarnya. |
Disabled |
| RootStackId |
string |
ID stack akar. Parameter ini dikembalikan jika stack yang ditentukan adalah stack bersarang. |
4a6c9851-3b0f-4f5f-b4ca-a14bf692**** |
| TemplateDescription |
string |
Deskripsi template. |
Create a VPC. |
| StackType |
string |
Jenis stack. Nilai yang valid:
|
ROS |
| RamRoleName |
string |
Nama role Resource Access Management (RAM). ROS mengasumsikan role RAM untuk membuat stack dan menggunakan kredensial role tersebut untuk memanggil API layanan Alibaba Cloud. |
test-role |
| UpdateTime |
string |
Waktu pembaruan stack. Waktu mengikuti standar ISO 8601 dalam format YYYY-MM-DDThh:mm:ss. Waktu ditampilkan dalam UTC. |
2020-09-17T08:21:40 |
| Outputs |
array<object> |
Output stack. |
|
|
object |
Output stack. Catatan
Parameter ini dikembalikan jika OutputOption diatur ke Enabled. |
[{"Description": "VPC ID","OutputKey": "VpcId","OutputValue": "vpc-bp1m6fww66xbntjyc****"}] |
|
| DriftDetectionTime |
string |
Waktu deteksi drift terakhir yang berhasil dilakukan pada stack. |
2020-09-16T09:21:40 |
| RegionId |
string |
ID wilayah stack. Anda dapat memanggil operasi DescribeRegions untuk menanyakan daftar wilayah terbaru. |
cn-hangzhou |
| StackDriftStatus |
string |
Status stack pada deteksi drift terakhir yang berhasil dilakukan. Nilai yang 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 |
Menunjukkan apakah rollback dinonaktifkan ketika pembuatan stack gagal. Nilai yang 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 |
Periode timeout untuk pembuatan stack. Satuan: menit. |
10 |
| StackId |
string |
ID stack. |
c754d2a4-28f1-46df-b557-9586173a**** |
| ResourceGroupId |
string |
ID kelompok sumber daya. |
rg-acfmxazb4ph6aiy**** |
| ResourceProgress |
object |
Kemajuan pembuatan resource. |
|
| TotalResourceCount |
integer |
Jumlah total resource. Catatan
Parameter ini dikembalikan hanya jika |
2 |
| SuccessResourceCount |
integer |
Jumlah resource yang berhasil dibuat. Catatan
Parameter ini dikembalikan hanya jika |
1 |
| FailedResourceCount |
integer |
Jumlah resource yang gagal dibuat. Catatan
Parameter ini dikembalikan hanya jika |
0 |
| InProgressResourceCount |
integer |
Jumlah resource yang sedang dibuat. Catatan
Parameter ini dikembalikan hanya jika |
1 |
| PendingResourceCount |
integer |
Jumlah resource yang akan dibuat. Catatan
Parameter ini dikembalikan hanya jika |
0 |
| InProgressResourceDetails |
array<object> |
Rincian kemajuan resource yang sedang dibuat. Catatan
Parameter ini dikembalikan hanya jika |
|
|
object |
|||
| ResourceName |
string |
Nama resource. |
WaitCondition |
| ResourceType |
string |
Jenis resource. |
ALIYUN::ROS::WaitCondition |
| ProgressValue |
number |
Nilai kemajuan saat ini dari resource. |
5 |
| ProgressTargetValue |
number |
Nilai target kemajuan dari resource. |
10 |
| StackOperationProgress |
number |
Kemajuan keseluruhan pembuatan stack, dalam persentase. Nilai yang valid: 0 hingga 100. Nilai ini secara progresif meningkat dari 0 hingga 100 selama operasi pembuatan stack. Jika stack berhasil dibuat, nilai mencapai 100. Jika pembuatan stack gagal, rollback dimulai untuk resource stack, dan nilai secara progresif menurun. Nilai menurun hingga 0 ketika resource stack di-rollback. Parameter ini hanya menunjukkan kemajuan pembuatan keseluruhan, baik selama operasi pembuatan maupun rollback stack. Catatan
Parameter ini dikembalikan hanya jika |
100 |
| StackActionProgress |
number |
Kemajuan pembuatan atau rollback stack, dalam persentase. Nilai yang valid: 0 hingga 100. Nilai ini secara progresif meningkat dari 0 hingga 100 selama operasi pembuatan stack. Jika stack berhasil dibuat, nilai mencapai 100. Jika pembuatan stack gagal, rollback dimulai untuk resource stack, dan nilai secara progresif meningkat dari persentase sisa kemajuan (100 - nilai Progress yang dihasilkan saat pembuatan stack gagal). Nilai meningkat hingga 100 ketika resource stack di-rollback. Parameter ini menunjukkan kemajuan pembuatan selama operasi pembuatan stack dan menunjukkan kemajuan rollback selama operasi rollback stack. Catatan
Parameter ini dikembalikan hanya jika |
100 |
| Log |
object |
Log stack. |
|
| TerraformLogs |
array<object> |
Log yang dihasilkan saat stack Terraform dijalankan. Parameter ini hanya dikembalikan untuk stack Terraform. Parameter ini dikembalikan jika LogOption dibiarkan kosong atau diatur ke Stack atau All. Catatan
Parameter ini tidak dikembalikan untuk stack yang sedang berjalan. Log dihasilkan dari operasi terbaru pada stack, seperti operasi pembuatan, pembuatan yang dilanjutkan, pembaruan, atau penghapusan. |
|
|
object |
test |
||
| Command |
string |
Nama perintah Terraform yang dijalankan. Nilai yang valid:
Untuk informasi selengkapnya mengenai perintah Terraform, lihat Basic CLI Features. |
apply |
| Stream |
string |
Aliran output. Nilai yang valid:
|
stdout |
| Content |
string |
Konten aliran output yang dikembalikan setelah perintah dijalankan. |
Apply complete! Resources: 42 added, 0 changed, 0 destroyed. |
| ResourceLogs |
array<object> |
Log resource dalam stack. Parameter ini dikembalikan jika LogOption diatur ke Resource atau All. Catatan
Log hanya dikembalikan untuk resource jenis tertentu, seperti jenis |
|
|
array<object> |
test |
||
| ResourceName |
string |
Nama resource yang didefinisikan dalam template. |
MyResourceCleaner |
| Logs |
array<object> |
Semua log yang terkait dengan resource. |
|
|
object |
test |
||
| Keys |
array |
Kata kunci log resource. |
|
|
string |
Kata kunci log resource. |
ResourceDetails |
|
| Content |
string |
Konten log resource. |
[] |
| TemplateId |
string |
ID template. Parameter ini hanya dikembalikan jika template stack saat ini adalah template kustom atau template bersama. Jika template adalah template bersama, nilai parameter ini sama dengan nilai TemplateARN. |
a52f81be-496f-4e1c-a286-8852ab54**** |
| TemplateVersion |
string |
Versi template. Parameter ini hanya dikembalikan jika template stack saat ini adalah template kustom atau template bersama. Jika template adalah template bersama, parameter ini hanya dikembalikan jika VersionOption diatur ke AllVersions. Nilai yang valid: v1 hingga v100. |
v1 |
| TemplateScratchId |
string |
ID skenario sumber daya. Parameter ini hanya dikembalikan jika template stack saat ini dihasilkan dari skenario sumber daya. |
ts-7f7a704cf71c49a6**** |
| TemplateURL |
string |
URL file yang berisi isi template. Parameter ini hanya dikembalikan jika template stack saat ini berasal dari URL. URL dapat mengarah ke template yang berada di server web HTTP atau HTTPS atau di bucket Object Storage Service (OSS). |
oss://ros/template/demo |
| Interface |
string |
Deskripsi antarmuka pengguna (UI) konsol. |
{} |
| ServiceManaged |
boolean |
Menunjukkan apakah stack adalah stack terkelola. Nilai yang valid:
|
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 dikembalikan bersama setidaknya satu sub-parameter dan hanya dalam kondisi tertentu. Misalnya, informasi tambahan dikembalikan ketika operasi API layanan Alibaba Cloud lain gagal dipanggil. |
|
| Code |
string |
Kode kesalahan. |
DependencyViolation |
| Message |
string |
Pesan kesalahan. |
There is still instance(s) in the specified security group. |
| RequestId |
string |
ID permintaan yang diajukan untuk memanggil operasi API layanan Alibaba Cloud lain. |
071D6166-3F6B-5C7B-A1F0-0113FBB643A8 |
| Action |
string |
Nama operasi API milik layanan Alibaba Cloud lain. |
DeleteSecurityGroup |
| ResourceType |
string |
Jenis resource tempat terjadinya kesalahan operasi. |
ALIYUN::ECS::SecurityGroup |
| LogicalResourceId |
string |
ID logis resource tempat terjadinya kesalahan operasi. |
EcsSecurityGroup |
| OrderIds |
array |
ID pesanan. Parameter ini hanya dikembalikan jika Anda mengonfigurasi pembayaran manual saat membuat stack langganan. |
|
|
string |
ID pesanan. |
2161413696**** |
|
| CheckedStackResourceCount |
integer |
Jumlah resource tempat deteksi drift dilakukan. Catatan
Parameter ini hanya dikembalikan jika deteksi drift terakhir pada stack berhasil. |
1 |
| NotCheckedStackResourceCount |
integer |
Jumlah resource tempat deteksi drift tidak dilakukan. Catatan
Parameter ini hanya dikembalikan jika deteksi drift terakhir pada stack berhasil. |
1 |
| RollbackFailedRootReason |
string |
Ketika status stack adalah rollback gagal, bidang ini menampilkan alasan kegagalan eksekusi tahap sebelumnya yang menyebabkan 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.