调用DetectStackResourceDrift接口对资源进行偏差检测。

同步接口。要求资源栈成功进行偏差检测。

调试

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

请求参数

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

要执行的操作,取值:DetectStackResourceDrift

LogicalResourceId String ScalingRuleName

资源名称。

RegionId String cn-hangzhou

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

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

资源栈ID。

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

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

返回数据

名称 类型 示例值 描述
ActualProperties String {"ScalingRuleName": "test1"}

实际的资源属性,JSON格式。

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

资源偏差检测时间。

ExpectedProperties String {"ScalingRuleName": "test2"}

模板中定义的资源属性,JSON格式。

LogicalResourceId String ScalingRule

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

PhysicalResourceId String asr-2ze4zzc3kf9yz1kd****

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

PropertyDifferences Array

资源属性偏差。

ActualValue String test1

资源属性的实际取值。

DifferenceType String NOT_EQUAL

资源属性的偏差类型。取值范围:

  • ADD:已将值添加到数据类型为数组或列表的资源属性。
  • REMOVE:属性已从当前资源配置中删除。
  • NOT_EQUAL:当前属性值与堆栈模板中定义的预期值不同。
ExpectedValue String test2

资源属性模板定义值。

PropertyPath String /ScalingRuleName

资源属性的路径。

RequestId String B288A0BE-D927-4888-B0F7-B35EF84B6E6F

请求ID。

ResourceDriftStatus String MODIFIED

资源偏差状态。取值范围:

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

资源类型。

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

资源栈ID。

示例

请求示例

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

正常返回示例

XML 格式

<DetectStackResourceDriftResponse>
      <ActualProperties>{"ScalingRuleName": "test1"}</ActualProperties>
      <DriftDetectionTime>2020-02-27T07:47:47</DriftDetectionTime>
      <ExpectedProperties>{"ScalingRuleName": "test2"}</ExpectedProperties>
      <LogicalResourceId>ScalingRule</LogicalResourceId>
      <PhysicalResourceId>asr-2ze4zzc3kf9yz1kd****</PhysicalResourceId>
      <PropertyDifferences>
            <ActualValue>test1</ActualValue>
            <DifferenceType>NOT_EQUAL</DifferenceType>
            <ExpectedValue>test2</ExpectedValue>
            <PropertyPath>/ScalingRuleName</PropertyPath>
      </PropertyDifferences>
      <ResourceDriftStatus>MODIFIED</ResourceDriftStatus>
      <ResourceType>ALIYUN::ESS::ScalingRule</ResourceType>
      <StackId>4a6c9851-3b0f-4f5f-b4ca-a14bf691****</StackId>
</DetectStackResourceDriftResponse>

JSON 格式

{
    "ActualProperties": "{\"ScalingRuleName\": \"test1\"}",
    "DriftDetectionTime": "2020-02-27T07:47:47",
    "ExpectedProperties": "{\"ScalingRuleName\": \"test2\"}",
    "LogicalResourceId": "ScalingRule",
    "PhysicalResourceId": "asr-2ze4zzc3kf9yz1kd****",
    "PropertyDifferences": [
        {
            "ActualValue": "test1",
            "DifferenceType": "NOT_EQUAL",
            "ExpectedValue": "test2",
            "PropertyPath": "/ScalingRuleName"
        }
    ],
    "ResourceDriftStatus": "MODIFIED",
    "ResourceType": "ALIYUN::ESS::ScalingRule",
    "StackId": "4a6c9851-3b0f-4f5f-b4ca-a14bf691****"
}

错误码

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

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

HttpCode

错误码

错误信息

描述

400

ResourceDriftDetectionProcessing

Drift detection of resource {name} is processing.

已经在对资源进行偏差检测。name为资源名。

400

ResourceDriftDetectionFailure

Fail to detect resource {name} drift: {reason}

资源偏差检测失败。name为资源名,reason为原因。

404

StackNotFound

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

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

404

ResourceNotFound

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

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