GetStack - - Alibaba Cloud Documentation Center

Mengambil informasi tentang sebuah stack.

Topik ini menjelaskan cara mengambil informasi stack dengan ID c754d2a4-28f1-46df-b557-9586173a**** yang dideploy di wilayah China (Hangzhou).

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Wajib	Contoh	Deskripsi
Action	String	Yes	GetStack	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke GetStack.
StackId	String	Yes	c754d2a4-28f1-46df-b557-9586173a****	ID stack.
RegionId	String	Yes	cn-hangzhou	ID wilayah tempat stack berada. Anda dapat memanggil operasi DescribeRegions untuk menanyakan daftar terbaru wilayah Alibaba Cloud.
ClientToken	String	No	123e4567-e89b-12d3-a456-42665544****	Token client yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan client untuk menghasilkan nilai ini, tetapi Anda harus memastikan bahwa nilainya unik di antara permintaan yang berbeda. Panjang token maksimal 64 karakter. Untuk informasi selengkapnya, lihat Ensure idempotence.
OutputOption	String	No	Disabled	Menentukan apakah akan mengembalikan parameter output stack. Nilai yang valid: Enabled: mengembalikan parameter output. Ini adalah nilai default. Disabled: tidak mengembalikan parameter output. Catatan Sistem memerlukan waktu lama untuk menghitung parameter output. Jika Anda tidak ingin menanyakan parameter output, kami menyarankan agar Anda menetapkan parameter OutputOption ke Disabled untuk meningkatkan kecepatan respons operasi GetStack.
ShowResourceProgress	String	No	Disabled	Menentukan apakah akan mengembalikan parameter ResourceProgress. Nilai yang valid: Disabled: tidak mengembalikan parameter ResourceProgress. Ini adalah nilai default. EnabledIfCreateStack: mengembalikan parameter ResourceProgress hanya jika stack sedang dibuat. Catatan Stack berada dalam salah satu status berikut saat sedang dibuat: CREATE_IN_PROGRESS, CREATE_COMPLETE, CREATE_FAILED, CREATE_ROLLBACK_IN_PROGRESS, CREATE_ROLLBACK_COMPLETE, atau CREATE_ROLLBACK_FAILED.
LogOption	String	No	Stack	Opsi untuk mengembalikan log. Nilai yang valid: None: tidak mengembalikan log. Stack: mengembalikan log stack. Ini adalah nilai default. Resource: mengembalikan log resource dalam stack. All: mengembalikan log semua resource.

Untuk informasi selengkapnya tentang parameter permintaan umum, lihat Common parameters.

Parameter respons

Parameter	Type	Contoh	Deskripsi
Status	String	CREATE_COMPLETE	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: Stack sedang dikembalikan setelah gagal dibuat. CREATE_ROLLBACK_FAILED: Gagal mengembalikan stack setelah gagal dibuat. CREATE_ROLLBACK_COMPLETE: Stack berhasil dikembalikan setelah gagal dibuat. ROLLBACK_IN_PROGRESS: Resource dalam stack sedang dikembalikan. ROLLBACK_FAILED: Gagal mengembalikan resource dalam stack. ROLLBACK_COMPLETE: Resource dalam 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.
Description	String	Create a VPC.	Deskripsi stack.
Parameters	Array of Parameter		Parameter stack.
ParameterKey	String	ALIYUN::Region	Nama parameter.
ParameterValue	String	cn-hangzhou	Nilai parameter.
RequestId	String	B288A0BE-D927-4888-B0F7-B35EF84B6E6F	ID permintaan.
StatusReason	String	Stack CREATE completed successfully	Alasan mengapa stack berada dalam status saat ini.
ParentStackId	String	4a6c9851-3b0f-4f5f-b4ca-a14bf692****	ID stack induk.
CreateTime	String	2020-09-16T08:21:40	Waktu pembuatan stack. Waktu mengikuti standar ISO 8601 dalam format YYYY-MM-DDThh:mm:ss. Waktu ditampilkan dalam UTC.
DeletionProtection	String	Disabled	Menunjukkan apakah perlindungan penghapusan diaktifkan untuk stack. Nilai yang valid: Enabled: Perlindungan penghapusan diaktifkan untuk stack. Disabled: Perlindungan penghapusan dinonaktifkan untuk stack. Anda dapat menghapus stack di Konsol Resource Orchestration Service (ROS) atau dengan memanggil operasi DeleteStack. Catatan Perlindungan penghapusan untuk stack bersarang bekerja sama seperti pada stack akar.
RootStackId	String	4a6c9851-3b0f-4f5f-b4ca-a14bf692****	ID stack akar. Parameter ini dikembalikan jika stack yang ditentukan merupakan stack bersarang.
TemplateDescription	String	Create a VPC.	Deskripsi templat.
StackType	String	ROS	Jenis stack. Nilai yang valid: ROS: Stack ROS, yang dibuat menggunakan Template ROS. Terraform: Stack Terraform, yang dibuat menggunakan Template Terraform.
RamRoleName	String	test-role	Nama Peran RAM. ROS mengasumsikan Peran RAM untuk membuat stack dan menggunakan kredensial peran tersebut untuk memanggil API layanan Alibaba Cloud. ROS mengasumsikan Peran RAM untuk melakukan operasi pada stack. Jika Anda memiliki izin untuk melakukan operasi pada stack tetapi tidak memiliki izin untuk menggunakan Peran RAM, ROS tetap mengasumsikan Peran RAM tersebut. Anda harus memastikan bahwa hak istimewa minimal diberikan kepada peran tersebut. Jika Anda tidak menentukan parameter ini, ROS mengasumsikan peran yang sudah ada dan terkait dengan stack. Jika tidak ada peran yang tersedia untuk diasumsikan oleh ROS, ROS menggunakan kredensial sementara yang dihasilkan dari kredensial akun Anda. Panjang nama Peran RAM maksimal 64 byte.
UpdateTime	String	2020-09-17T08:21:40	Waktu pembaruan stack. Waktu mengikuti standar ISO 8601 dalam format YYYY-MM-DDThh:mm:ss. Waktu ditampilkan dalam UTC.
Outputs	Array of Object	[{"Description": "VPC ID","OutputKey": "VpcId","OutputValue": "vpc-bp1m6fww66xbntjyc****"}]	Parameter output stack. Catatan Parameter ini dikembalikan jika parameter OutputOption diatur ke Enabled.
DriftDetectionTime	String	2020-09-16T09:21:40	Waktu operasi pendeteksian drift terakhir yang berhasil dilakukan.
RegionId	String	cn-hangzhou	ID wilayah tempat stack dideploy. Anda dapat memanggil operasi DescribeRegions untuk menanyakan daftar terbaru wilayah Alibaba Cloud.
StackDriftStatus	String	IN_SYNC	Status stack pada operasi pendeteksian drift terakhir yang berhasil. Nilai yang valid: DRIFTED: Stack telah mengalami deviasi. NOT_CHECKED: Tidak ada operasi pendeteksian drift yang berhasil dilakukan pada stack. IN_SYNC: Stack sedang disinkronkan.
NotificationURLs	Array of String	["http://127.XX.XX.1:8080/x", "http://127.0.XX.XX:8080/y"]	URL callback yang digunakan untuk menerima event stack.
DisableRollback	Boolean	false	Menunjukkan apakah rollback dinonaktifkan ketika stack gagal dibuat. Nilai yang valid: true: Rollback dinonaktifkan ketika stack gagal dibuat. false: Rollback diaktifkan ketika stack gagal dibuat. Ini adalah nilai default.
StackName	String	MyStack	Nama stack. Panjang nama maksimal 255 karakter, dan dapat berisi angka, huruf, tanda hubung (-), dan garis bawah (_). Nama harus dimulai dengan angka atau huruf.
Tags	Array of Tag		Tag stack.
Key	String	usage	Kunci tag stack.
Value	String	test	Nilai tag stack.
TimeoutInMinutes	Integer	10	Periode timeout dalam menit untuk pembuatan stack. Satuan: menit.
StackId	String	c754d2a4-28f1-46df-b557-9586173a****	ID stack.
ResourceGroupId	String	rg-acfmxazb4ph6aiy****	ID kelompok sumber daya tempat instans berada.
ResourceProgress	Object		Progres pembuatan resource.
TotalResourceCount	Integer	2	Jumlah total resource.
SuccessResourceCount	Integer	1	Jumlah resource yang berhasil dibuat.
FailedResourceCount	Integer	0	Jumlah resource yang gagal dibuat.
InProgressResourceCount	Integer	1	Jumlah resource yang sedang dibuat.
PendingResourceCount	Integer	0	Jumlah resource yang akan dibuat.
InProgressResourceDetails	Array of InProgressResourceDetail		Rincian progres resource yang sedang dibuat.
ResourceName	String	WaitCondition	Nama resource.
ResourceType	String	ALIYUN::ROS::WaitCondition	Jenis resource.
ProgressValue	Float	5	Nilai progres saat ini dari resource.
ProgressTargetValue	Float	10	Nilai progres yang diinginkan dari resource.
Log	Object		Log stack.
TerraformLogs	Array of TerraformLog		Log stack Terraform. Parameter ini hanya dikembalikan untuk stack Terraform. Parameter ini dikembalikan jika parameter LogOption dibiarkan kosong atau diatur ke Stack atau All. Catatan Parameter ini tidak dikembalikan untuk stack yang sedang berjalan. Log dihasilkan dari operasi pembuatan, pembuatan ulang, pembaruan, atau penghapusan terakhir pada stack.
Command	String	apply	Nama perintah Terraform yang dijalankan. Nilai yang valid: apply plan destroy version Untuk informasi selengkapnya tentang perintah Terraform, lihat Basic CLI Features.
Stream	String	stdout	Aliran output. Nilai yang valid: stdout: aliran output standar. stderr: aliran error standar.
Content	String	Apply complete! Resources: 42 added, 0 changed, 0 destroyed.	Konten aliran output yang dikembalikan setelah perintah dijalankan.
ResourceLogs	Array of ResourceLog		Log resource dalam stack. Parameter ini dikembalikan jika parameter LogOption diatur ke Resource atau All. Catatan Log dikembalikan untuk resource jenis tertentu, seperti `ALIYUN::ROS::ResourceCleaner`.
ResourceName	String	MyResourceCleaner	Nama resource yang didefinisikan dalam templat.
Logs	Array of Log		Log semua resource.
Keys	Array of String	ResourceDetails	Kata kunci.
Content	String	[]	Konten log resource.
TemplateId	String	a52f81be-496f-4e1c-a286-8852ab54****	ID templat. Parameter ini hanya dikembalikan jika templat saat ini dari stack merupakan templat kustom atau templat bersama. Jika templat merupakan templat bersama, nilai parameter ini sama dengan nilai parameter TemplateARN.
TemplateVersion	String	v1	Versi templat. Parameter ini hanya dikembalikan jika templat saat ini dari stack merupakan templat kustom atau templat bersama. Jika templat merupakan templat bersama, parameter ini hanya dikembalikan ketika parameter VersionOption diatur ke AllVersions. Nilai yang valid: v1 hingga v100.
TemplateScratchId	String	ts-7f7a704cf71c49a6****	ID skenario. Parameter ini hanya dikembalikan jika templat saat ini dari stack dihasilkan dari skenario.
TemplateURL	String	oss://ros/template/demo	URL file yang berisi isi templat. Parameter ini hanya dikembalikan jika templat saat ini dari stack berasal dari URL. URL dapat mengarah ke templat yang berada di server web HTTP atau HTTPS atau di bucket Alibaba Cloud Object Storage Service (OSS).
Interface	String	{}	Deskripsi UI web di Konsol ROS.
ServiceManaged	Boolean	false	Menunjukkan apakah stack merupakan stack terkelola. Nilai yang valid: true false
ServiceName	String	ACVS	Nama layanan tempat stack terkelola tersebut berada.
OperationInfo	Object		Informasi tambahan yang ditampilkan ketika terjadi kesalahan pada operasi stack. Catatan Properti ini dikembalikan dalam kondisi tertentu. Setidaknya satu sub-properti dikembalikan. Misalnya, kesalahan dilaporkan ketika Anda memanggil API layanan cloud lainnya.
Code	String	DependencyViolation	Kode kesalahan yang dikembalikan.
Message	String	There is still instance(s) in the specified security group.	Pesan kesalahan yang dikembalikan.
RequestId	String	071D6166-3F6B-5C7B-A1F0-0113FBB643A8	ID permintaan untuk memanggil API layanan cloud lainnya.
Action	String	DeleteSecurityGroup	Nama API layanan cloud lainnya.
ResourceType	String	ALIYUN::ECS::SecurityGroup	Jenis resource tempat terjadinya kesalahan operasi.
LogicalResourceId	String	EcsSecurityGroup	ID logis resource tempat terjadinya kesalahan operasi.

Contoh

Permintaan contoh

http(s)://ros.aliyuncs.com/?Action=GetStack
&StackId=c754d2a4-28f1-46df-b557-9586173a****
&RegionId=cn-hangzhou
&<Common request parameters>

Respons sukses contoh

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<GetStackResponse>
    <Status>CREATE_COMPLETE</Status>
    <Description>Create a VPC.</Description>
    <Parameters>
        <ParameterKey>ALIYUN::Region</ParameterKey>
        <ParameterValue>cn-hangzhou</ParameterValue>
    </Parameters>
    <RequestId>B288A0BE-D927-4888-B0F7-B35EF84B6E6F</RequestId>
    <StatusReason>Stack CREATE completed successfully</StatusReason>
    <ParentStackId>4a6c9851-3b0f-4f5f-b4ca-a14bf692****</ParentStackId>
    <CreateTime>2020-09-16T08:21:40</CreateTime>
    <DeletionProtection>Disabled</DeletionProtection>
    <RootStackId>4a6c9851-3b0f-4f5f-b4ca-a14bf692****</RootStackId>
    <TemplateDescription>Create a VPC.</TemplateDescription>
    <StackType>ROS</StackType>
    <RamRoleName>test-role</RamRoleName>
    <UpdateTime>2020-09-17T08:21:40</UpdateTime>
    <Outputs/>
    <DriftDetectionTime>2020-09-16T09:21:40</DriftDetectionTime>
    <RegionId>cn-hangzhou</RegionId>
    <StackDriftStatus>IN_SYNC</StackDriftStatus>
    <NotificationURLs>["http://127.XX.XX.1:8080/x", "http://127.0.XX.XX:8080/y"]</NotificationURLs>
    <DisableRollback>false</DisableRollback>
    <StackName>MyStack</StackName>
    <Tags>
        <Key>usage</Key>
        <Value>test</Value>
    </Tags>
    <TimeoutInMinutes>10</TimeoutInMinutes>
    <StackId>c754d2a4-28f1-46df-b557-9586173a****</StackId>
    <ResourceGroupId>rg-acfmxazb4ph6aiy****</ResourceGroupId>
    <ResourceProgress>
        <TotalResourceCount>2</TotalResourceCount>
        <SuccessResourceCount>1</SuccessResourceCount>
        <FailedResourceCount>0</FailedResourceCount>
        <InProgressResourceCount>1</InProgressResourceCount>
        <PendingResourceCount>0</PendingResourceCount>
        <InProgressResourceDetails>
            <ResourceName>WaitCondition</ResourceName>
            <ResourceType>ALIYUN::ROS::WaitCondition</ResourceType>
            <ProgressValue>5</ProgressValue>
            <ProgressTargetValue>10</ProgressTargetValue>
        </InProgressResourceDetails>
    </ResourceProgress>
    <Log>
        <TerraformLogs>
            <Command>apply</Command>
            <Stream>stdout</Stream>
            <Content>Apply complete! Resources: 42 added, 0 changed, 0 destroyed.</Content>
        </TerraformLogs>
        <ResourceLogs>
            <ResourceName>MyResourceCleaner</ResourceName>
            <Logs>
                <Keys>ResourceDetails</Keys>
                <Content>[]</Content>
            </Logs>
        </ResourceLogs>
    </Log>
    <TemplateId>a52f81be-496f-4e1c-a286-8852ab54****</TemplateId>
    <TemplateVersion>v1</TemplateVersion>
    <TemplateScratchId>ts-7f7a704cf71c49a6****</TemplateScratchId>
    <TemplateURL>oss://ros/template/demo</TemplateURL>
    <Interface>{}</Interface>
    <ServiceManaged>false</ServiceManaged>
    <ServiceName>ACVS</ServiceName>
    <OperationInfo>
        <Code>DependencyViolation</Code>
        <Message>There is still instance(s) in the specified security group.</Message>
        <RequestId>071D6166-3F6B-5C7B-A1F0-0113FBB643A8</RequestId>
        <Action>DeleteSecurityGroup</Action>
        <ResourceType>ALIYUN::ECS::SecurityGroup</ResourceType>
        <LogicalResourceId>EcsSecurityGroup</LogicalResourceId>
    </OperationInfo>
</GetStackResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "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" : "",
  "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
    }
  },
  "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"
  }
}

Kode kesalahan

Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.

HttpCode	Kode kesalahan	Pesan kesalahan	Deskripsi
404	StackNotFound	The Stack ({name}) could not be found.	Pesan kesalahan yang dikembalikan karena stack yang ditentukan tidak ada. name menunjukkan nama atau ID stack.