调用GetStackInstance接口查询指定资源栈组关联的资源栈实例的详细信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String GetStackInstance

系统规定参数。取值:GetStackInstance

RegionId String cn-hangzhou

资源栈所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

StackGroupName String MyStackGroup

资源栈组名称。名称在单个Region内唯一,可以包含数字、英文字母(区分大小写)、连字符、下划线。必须以数字或英文字母开头,且长度不超过255个字符。

StackInstanceAccountId String 123456

资源栈实例所属账号。

StackInstanceRegionId String cn-beijing

资源栈实例所属地域。

返回数据

名称 类型 示例值 描述
RequestId String 14A07460-EBE7-47CA-9757-12CC4761D47A

请求ID。

StackInstance Struct

资源栈实例详情。

AccountId String 123456

资源栈实例所属账号。

DriftDetectionTime String 2020-02-27T07:47:47

资源栈最近一次成功的偏差检查的时间。

ParameterOverrides Array

覆盖参数列表。

ParameterKey String Amount

覆盖参数的名称。

ParameterValue String 1

覆盖参数的值。

RegionId String cn-beijing

资源栈实例所属地域。

StackDriftStatus String IN_SYNC

资源栈最近一次成功的偏差检查中的资源栈的状态。取值范围:

  • DRIFTED:资源栈处于偏差状态。
  • NOT_CHECKED:资源栈未进行过成功的偏差检查。
  • IN_SYNC:资源栈处于同步状态。
StackGroupId String fd0ddef9-9540-4b42-a464-94f7783501d0

资源栈组ID。

StackGroupName String MyStackGroup

资源栈组名称。

StackId String 35ad60e3-6a92-42d8-8812-f0700d450971

资源栈实例所对应的资源栈ID。

Status String CURRENT

资源栈实例的状态,有如下几种:

  • CURRENT:资源栈实例对应资源栈是最新的。
  • OUTDATED:资源栈实例对应的资源栈不是资源栈组最新的。可能有如下原因:
    • 在创建资源栈实例(CreateStackInstances)操作期间,创建对应的资源栈失败。
    • 在更新资源栈实例(可通过UpdateStackInstancesUpdateStackGroup)操作期间,更新对应的资源栈失败,或只更新部分资源栈实例其他资源栈实例没有更新。
    • 操作期间终止了操作。
StatusReason String User initiated stop

状态原因描述。

示例

请求示例

http(s)://[Endpoint]/?Action=GetStackInstance
&RegionId=cn-hangzhou
&StackGroupName=MyStackGroup
&StackInstanceAccountId=123456
&StackInstanceRegionId=cn-beijing
&<公共请求参数>

正常返回示例

XML 格式

<RequestId>B8A6B693-82C8-419D-8796-DE99EC33CFF9</RequestId>
<StackInstance>
    <Status>CURRENT</Status>
    <StatusReason/>
    <StackGroupId>fd0ddef9-9540-4b42-a464-94f7783501d0</StackGroupId>
    <AccountId>123456</AccountId>
    <StackGroupName>MyStackGroup</StackGroupName>
    <StackId>35ad60e3-6a92-42d8-8812-f0700d450971</StackId>
    <RegionId>cn-hangzhou</RegionId>
    <DriftDetectionTime>2020-02-27T07:47:47</DriftDetectionTime>
    <StackDriftStatus>IN_SYNC</StackDriftStatus>
</StackInstance>

JSON 格式

{
	"RequestId": "B8A6B693-82C8-419D-8796-DE99EC33CFF9",
	"StackInstance": {
		"Status": "CURRENT",
		"StatusReason": "",
		"StackGroupId": "fd0ddef9-9540-4b42-a464-94f7783501d0",
		"ParameterOverrides": [],
		"AccountId": "123456",
		"StackGroupName": "MyStackGroup",
		"StackId": "35ad60e3-6a92-42d8-8812-f0700d450971",
		"RegionId": "cn-hangzhou",
		"DriftDetectionTime": "2020-02-27T07:47:47",
		"StackDriftStatus": "IN_SYNC"
	}
}

错误码

访问错误中心查看更多错误码。