调用GetStackResource接口查询某个资源栈的资源。

调试

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

请求参数

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

系统规定参数。取值:GetStackResource

LogicalResourceId String WebServer

资源逻辑ID,即模板中资源的名称。

RegionId String cn-hangzhou

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

StackId String 4a6c9851-3b0f-4f5f-b4ca-a14bf691****

资源栈ID。

ClientToken String 123e4567-e89b-12d3-a456-426655440000

保证请求的幂等性。此参数值由客户端生成,并且必须是全局唯一的。仅允许ASCII字符,最多可包含64个字符。更多详情,请参见如何保证幂等性

ShowResourceAttributes Boolean true

是否查询资源属性。

返回数据

名称 类型 示例值 描述
Status String CREATE_COMPLETE

资源状态。取值范围:

  • CREATE_COMPLETE
  • CREATE_FAILED
  • CREATE_IN_PROGRESS
  • DELETE_FAILED
  • DELETE_IN_PROGRESS
  • ROLLBACK_COMPLETE
  • ROLLBACK_FAILED
  • ROLLBACK_IN_PROGRESS
Description String no description

资源描述。

LogicalResourceId String WebServer

资源逻辑ID,即模板中资源的名称。

StackId String cn-hangzhou

资源栈ID。

StackName String test-describe-resource

资源栈名称。资源栈名称可以包含数字、字母(大小写敏感)、连字符、下划线。必须以数字或字母开头,且长度不超过255个字符。

StatusReason String state changed

资源状态原因。

PhysicalResourceId String d04af923-e6b7-4272-aeaa-47ec9777****

资源物理ID,即实际资源ID。

ResourceType String ALIYUN::ROS::WaitConditionHandle

资源类型。

CreateTime String 2019-08-01T06:01:23

创建时间。

按照ISO8601标准表示,需使用UTC时间,格式:YYYY-MM-DDThh:mm:ss。

Metadata Map {"key": "value"}

元数据。

UpdateTime String 2019-08-01T06:01:29

更新时间。

按照ISO8601标准表示,需使用UTC时间,格式:YYYY-MM-DDThh:mm:ss。

ResourceAttributes List [ { "ResourceAttributeValue":"curl -Uri \"http://100.100.100.110/waitcondition?stackname=test-describe-resource&stackid=efdf5c10-96a5-4fd7-ab89-68e7baa2e0d5&resource=WaitConditionHandle&expire=1564682564&signature=991d910a901a89db6580d74233119960c004de55\" -Method Post -Headers @{\"Content-Type\"=\"application/json\"; \"Accept\"=\"application/json\"; \"x-acs-region-id\"=\"cn-beijing\"}", "ResourceAttributeKey":"PowerShellCurlCli" } ]

资源属性列表。

RequestId String B288A0BE-D927-4888-B0F7-B35EF84B6E6

请求ID。

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

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

ResourceDriftStatus String IN_SYNC

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

  • DELETED:资源与预期的模板配置不同,因为资源已被删除。
  • MODIFIED:资源与预期的模板配置不同。
  • NOT_CHECKED:ROS 没有检查资源是否与预期的模板配置不同。
  • IN_SYNC:资源的当前配置与其预期的模板配置相匹配。

示例

请求示例

http(s)://ros.aliyuncs.com/?Action=GetStackResource
&RegionId=cn-hangzhou
&StackId=4a6c9851-3b0f-4f5f-b4ca-a14bf691****
&LogicalResourceId=WebServer
&<公共请求参数>

正常返回示例

XML 格式

<GetStackResourceResponse>
       <CreateTime type="string">2019-08-01T06:01:23</CreateTime>
       <Description type="string"></Description>
       <LogicalResourceId type="string">WaitConditionHandle</LogicalResourceId>
       <Metadata class="object"></Metadata>
       <PhysicalResourceId type="string"></PhysicalResourceId>
       <RequestId type="string">B288A0BE-D927-4888-B0F7-B35EF84B6E6F</RequestId>
       <ResourceAttributes class="array">
              <ResourceAttribute class="object">
                     <ResourceAttributeKey type="string">CurlCli</ResourceAttributeKey>
                     <ResourceAttributeValue type="string">curl -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'x-acs-region-id: cn-beijing' http://100.100.100.110/waitcondition?stackname=test-describe-resource\&amp;stackid=efdf5c10-96a5-4fd7-ab89-68e7baa2e0d5\&amp;resource=WaitConditionHandle\&amp;expire=1564682564\&amp;signature=991d910a901a89db6580d74233119960c004de55</ResourceAttributeValue>
              </ResourceAttribute>
              <ResourceAttribute class="object">
                     <ResourceAttributeKey type="string">WindowsCurlCli</ResourceAttributeKey>
                     <ResourceAttributeValue type="string">curl -i -X POST -H "Content-Type: application/json" -H "Accept: application/json" -H "x-acs-region-id: cn-beijing" "http://100.100.100.110/waitcondition?stackname=test-describe-resource&amp;stackid=efdf5c10-96a5-4fd7-ab89-68e7baa2e0d5&amp;resource=WaitConditionHandle&amp;expire=1564682564&amp;signature=991d910a901a89db6580d74233119960c004de55"</ResourceAttributeValue>
              </ResourceAttribute>
              <ResourceAttribute class="object">
                     <ResourceAttributeKey type="string">PowerShellCurlCli</ResourceAttributeKey>
                     <ResourceAttributeValue type="string">curl -Uri "http://100.100.100.110/waitcondition?stackname=test-describe-resource&amp;stackid=efdf5c10-96a5-4fd7-ab89-68e7baa2e0d5&amp;resource=WaitConditionHandle&amp;expire=1564682564&amp;signature=991d910a901a89db6580d74233119960c004de55" -Method Post -Headers @{"Content-Type"="application/json"; "Accept"="application/json"; "x-acs-region-id"="cn-beijing"}</ResourceAttributeValue>
              </ResourceAttribute>
       </ResourceAttributes>
       <ResourceType type="string">ALIYUN::ROS::WaitConditionHandle</ResourceType>
       <StackId type="string">efdf5c10-96a5-4fd7-ab89-68e7baa2****</StackId>
       <StackName type="string">test-describe-resource</StackName>
       <Status type="string">UPDATE_COMPLETE</Status>
       <StatusReason type="string">state changed</StatusReason>
       <UpdateTime type="string">2019-08-01T06:01:29</UpdateTime>
       <DriftDetectionTime>2020-02-27T07:47:47</DriftDetectionTime>
       <ResourceDriftStatus>IN_SYNC</ResourceDriftStatus>
</GetStackResourceResponse>

JSON 格式

{
    "CreateTime": "2019-08-01T06:01:23",
    "Description": "",
    "LogicalResourceId": "WaitConditionHandle",
    "Metadata": {},
    "PhysicalResourceId": "",
    "RequestId": "B288A0BE-D927-4888-B0F7-B35EF84B6E6F",
    "ResourceAttributes": [
        {
            "ResourceAttributeKey": "CurlCli",
            "ResourceAttributeValue": "curl -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'x-acs-region-id: cn-beijing' http://100.100.100.110/waitcondition?stackname=test-describe-resource\\&stackid=efdf5c10-96a5-4fd7-ab89-68e7baa2e0d5\\&resource=WaitConditionHandle\\&expire=1564682564\\&signature=991d910a901a89db6580d74233119960c004de55"
        },
        {
            "ResourceAttributeKey": "WindowsCurlCli",
            "ResourceAttributeValue": "curl -i -X POST -H \"Content-Type: application/json\" -H \"Accept: application/json\" -H \"x-acs-region-id: cn-beijing\" \"http://100.100.100.110/waitcondition?stackname=test-describe-resource&stackid=efdf5c10-96a5-4fd7-ab89-68e7baa2e0d5&resource=WaitConditionHandle&expire=1564682564&signature=991d910a901a89db6580d74233119960c004de55\""
        },
        {
            "ResourceAttributeKey": "PowerShellCurlCli",
            "ResourceAttributeValue": "curl -Uri \"http://100.100.100.110/waitcondition?stackname=test-describe-resource&stackid=efdf5c10-96a5-4fd7-ab89-68e7baa2e0d5&resource=WaitConditionHandle&expire=1564682564&signature=991d910a901a89db6580d74233119960c004de55\" -Method Post -Headers @{\"Content-Type\"=\"application/json\"; \"Accept\"=\"application/json\"; \"x-acs-region-id\"=\"cn-beijing\"}"
        }
    ],
    "ResourceType": "ALIYUN::ROS::WaitConditionHandle",
    "StackId": "efdf5c10-96a5-4fd7-ab89-68e7baa2****",
    "StackName": "test-describe-resource",
    "Status": "UPDATE_COMPLETE",
    "StatusReason": "state changed",
    "UpdateTime": "2019-08-01T06:01:29",
    "DriftDetectionTime": "2020-02-27T07:47:47",
	"ResourceDriftStatus": "IN_SYNC"
}

错误码

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

访问公共错误码查看更多错误码。

HttpCode

错误码

错误信息

描述

404

ResourceNotFound

The Resource ({name}) could not be found in Stack {stack}.

资源栈中不存某资源。name为资源名,stack为资源栈名称或ID。

404

StackNotFound

The Stack ({name}) could not be found.

资源栈不存在。name为资源栈名称或ID。