调用GetStackInstance接口查询资源栈组在指定账号和地域下关联的资源栈实例的详细信息。
本文将提供一个示例,对杭州地域已有的自助管理权限模式的资源栈组MyStackGroup
,查询其在在北京地域和阿里云账号151266687691****
下的资源栈实例的详细信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | GetStackInstance |
要执行的操作。取值:GetStackInstance。 |
RegionId | String | 是 | cn-hangzhou |
资源栈组所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。 |
StackGroupName | String | 是 | MyStackGroup |
资源栈组名称。名称在单个地域内唯一。 长度不超过255个字符,必须以数字或英文字母开头,可以包含数字、英文字母、短划线(-)和下划线(_)。 |
StackInstanceAccountId | String | 是 | 151266687691**** |
资源栈实例所属目标账号ID。
说明 关于目标账号的更多信息,请参见概览。
|
StackInstanceRegionId | String | 是 | cn-beijing |
资源栈实例所属地域。 |
关于公共请求参数的详情,请参见公共参数。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | B8A6B693-82C8-419D-8796-DE99EC33CFF9 |
请求ID。 |
StackInstance | Object |
资源栈实例详情。 |
|
Status | String | CURRENT |
资源栈实例的状态。 取值:
|
StackGroupId | String | fd0ddef9-9540-4b42-a464-94f77835**** |
资源栈组ID。 |
StackId | String | 35ad60e3-6a92-42d8-8812-f0700d45**** |
资源栈实例所对应的资源栈ID。 说明 仅当资源栈的实例状态为CURRENT时,才会返回该参数。
|
DriftDetectionTime | String | 2020-02-27T07:47:47 |
资源栈组最近一次成功完成偏差检测的时间。 说明 仅当资源栈组做过偏差检测,才会返回该参数。
|
StackDriftStatus | String | IN_SYNC |
资源栈组最近一次成功完成偏差检测的状态。 取值:
说明 仅当资源栈组做过偏差检测,才会返回该参数。
|
StatusReason | String | User initiated stop |
状态原因描述。 说明 仅当资源栈的实例状态为OUTDATED时,才会返回该参数。
|
ParameterOverrides | Array of ParameterOverride |
覆盖参数列表。 |
|
ParameterKey | String | Amount |
覆盖参数的名称。 |
ParameterValue | String | 1 |
覆盖参数的值。 |
StackGroupName | String | MyStackGroup |
资源栈组名称。 |
AccountId | String | 151266687691**** |
资源栈实例所属目标账号ID。 |
RegionId | String | cn-beijing |
资源栈实例所属地域。 |
RdFolderId | String | fd-4PvlVLOL8v |
资源目录的资源夹ID。 说明 仅限使用服务管理权限模式的资源栈组,才会返回该参数。
|
示例
请求示例
http(s)://ros.aliyuncs.com/?Action=GetStackInstance
&RegionId=cn-hangzhou
&StackGroupName=MyStackGroup
&StackInstanceAccountId=151266687691****
&StackInstanceRegionId=cn-beijing
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<GetStackInstanceResponse>
<RequestId>B8A6B693-82C8-419D-8796-DE99EC33CFF9</RequestId>
<StackInstance>
<Status>OUTDATED</Status>
<AccountId>151266687691****</AccountId>
<StatusReason>Cancelled since failure tolerance has exceeded</StatusReason>
<StackGroupName>MyStackGroup</StackGroupName>
<StackGroupId>fd0ddef9-9540-4b42-a464-94f77835****</StackGroupId>
<RegionId>cn-beijing</RegionId>
</StackInstance>
</GetStackInstanceResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "B8A6B693-82C8-419D-8796-DE99EC33CFF9",
"StackInstance" : {
"Status" : "OUTDATED",
"AccountId" : "151266687691****",
"StatusReason" : "Cancelled since failure tolerance has exceeded",
"ParameterOverrides" : [ ],
"StackGroupName" : "MyStackGroup",
"StackGroupId" : "fd0ddef9-9540-4b42-a464-94f77835****",
"RegionId" : "cn-beijing"
}
}
错误码
访问错误中心查看更多错误码。
错误代码 |
错误信息 |
HTTP状态码 |
描述 |
---|---|---|---|
InvalidParameter |
The specified parameter {name} is invalid, {reason}. |
400 |
无效参数,name为参数名,reason为原因。 |
StackGroupNotFound |
The StackGroup ({name}) could not be found. |
404 |
资源栈组不存在。name为资源栈组名称。 |
StackInstanceNotFound |
The StackInstance could not be found. |
404 |
资源栈实例不存在。 |