调用GetStackGroupOperation接口查询资源栈组操作的信息。

本文将提供一个示例，对杭州地域已有的自助管理权限模式的资源栈组MyStackGroup，查询操作ID为6da106ca-1784-4a6f-a7e1-e723863d****的操作信息。

调试

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

请求参数

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

要执行的操作。取值：GetStackGroupOperation。
RegionId String 是 cn-hangzhou

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

OperationId String 是 6da106ca-1784-4a6f-a7e1-e723863d****

操作ID。您可以调用ListStackGroupOperations获取操作ID。

关于公共请求参数的详情，请参见公共参数。

返回数据

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

请求ID。
StackGroupOperation Object

资源栈组操作详情。
Status String SUCCEEDED

操作状态。

取值：

  • RUNNING：操作正在进行中。
  • SUCCEEDED：操作成功。
  • FAILED：操作失败。
  • STOPPING：操作正在停止中。
  • STOPPED：操作已停止。
StackGroupId String fd0ddef9-9540-4b42-a464-94f77835****

资源栈组ID。
Action String DELETE

操作动作。

取值：

  • CREATE：创建。
  • UPDATE：更新。
  • DELETE：删除。
  • DETECT_DRIFT：偏差检测。
CreateTime String 2020-01-20T09:22:3

操作开始时间。
RetainStacks Boolean true

是否保留资源栈。删除资源栈实例时可选择删除或保留它所指向的资源栈。

取值：

  • true：只删除资源栈实例，不删除相应的资源栈。
  • false：删除资源栈实例和相应的资源栈，请您谨慎操作。
说明 仅在您执行删除资源栈实例的操作时，才会返回该参数。
StackGroupName String MyStackGroup

资源栈组名称。
OperationId String 6da106ca-1784-4a6f-a7e1-e723863d****

资源栈组操作ID。
OperationDescription String Create stack instance in hangzhou

操作描述。

说明 仅在您调用CreateStackInstances执行创建资源栈实例操作时，指定了请求参数OperationDescription，此处才会返回该参数。
StackGroupDriftDetectionDetail Object

偏差检测的详情。

说明 仅在您执行偏差检测的操作时，才会返回该参数。
DriftDetectionTime String 2020-02-27T07:47:47

偏差检测时间。
TotalStackInstancesCount Integer 2

资源栈实例的数量。
FailedStackInstancesCount Integer 0

偏差检测失败的资源栈实例的数量。
DriftDetectionStatus String COMPLETED

偏差检测状态。

取值：

  • COMPLETED：资源栈组偏差检测结束，所有资源栈实例均成功完成了偏差检测。
  • FAILED：资源栈组偏差检测结束，失败的资源栈实例偏差检测数量超过了设定的阈值。
  • PARTIAL_SUCCESS：资源栈组偏差检测结束，部分资源栈实例偏差检测失败，但失败数量没有超过阈值。
  • IN_PROGRESS：资源栈组偏差检测进行中。
  • STOPPED：用户取消了资源栈组的偏差检测。
StackGroupDriftStatus String DRIFTED

资源栈组偏差状态。

取值：

  • DRIFTED：至少一个资源栈实例处于偏差状态。
  • NOT_CHECKED：资源栈组未进行过成功的偏差检测。
  • IN_SYNC：所有资源栈实例均处于同步状态。
InProgressStackInstancesCount Integer 0

偏差检测中的资源栈实例的数量。
InSyncStackInstancesCount Integer 1

处于同步状态的资源栈实例的数量。
CancelledStackInstancesCount Integer 0

取消偏差检测的资源栈实例的数量。
DriftedStackInstancesCount Integer 1

处于偏差状态的资源栈实例的数量。
OperationPreferences Object

操作设置。
MaxConcurrentCount Integer 1

最大并发账号数。每个地域中可同时部署资源栈的账号数。

取值范围：1~20。

说明 只能返回MaxConcurrentCount和MaxConcurrentPercentage其中一个参数。
FailureToleranceCount Integer 1

容错数。每个地域中资源栈可以失败的账号数，超过该数字将停止该地域中的操作。如果停止了一个地域中的操作，此操作在其他地域中不继续执行。

取值范围：0~20。

说明 只能返回FailureToleranceCount和FailureTolerancePercentage其中一个参数。
MaxConcurrentPercentage Integer 10

最大并发账号百分比。每个地域中可同时部署资源栈的账号数占总账号数的百分比。

取值范围：1~100。

说明 只能返回MaxConcurrentCount和MaxConcurrentPercentage其中一个参数。
RegionIdsOrder Array of String ["cn-hangzhou","cn-beijing"]

操作中按执行顺序排列的地域列表。
FailureTolerancePercentage Integer 10

容错百分比。每个地域中资源栈可以失败的账号数占总账号数的百分比，超过该百分比将停止该地域中的操作。

取值范围：0~100。

说明 只能返回FailureToleranceCount和FailureTolerancePercentage其中一个参数。
EndTime String 2020-01-20T09:22:4

操作结束时间。
ExecutionRoleName String AliyunROSStackGroupExecutionRole

创建自助管理权限模式的资源栈组时，需指定的供管理员角色（AliyunROSStackGroupAdministrationRole）扮演的RAM执行角色名称。若不指定，则默认返回AliyunROSStackGroupExecutionRole。
AdministrationRoleName String AliyunROSStackGroupAdministrationRole

创建自助管理权限模式的资源栈组时，指定的供ROS扮演的RAM管理员角色名称。若不指定，则默认返回AliyunROSStackGroupAdministrationRole。
DeploymentTargets Object

使用服务管理权限模式时，资源栈实例的部署目标。
RdFolderIds Array of String ["fd-4PvlVLOL8v"]

资源目录的资源夹ID列表。
AccountIds Array of String ["151266687691****","141261387191****"]

资源目录中的成员账号ID列表。

说明 仅在您调用UpdateStackInstances执行更新资源栈实例操作时，指定了请求参数AccountIds，此处才会返回该参数。

示例

请求示例

http(s)://ros.aliyuncs.com/?Action=GetStackGroupOperation
&OperationId=6da106ca-1784-4a6f-a7e1-e723863d****
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式 

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

<GetStackGroupOperationResponse>
    <RequestId>14A07460-EBE7-47CA-9757-12CC4761D47A</RequestId>
    <StackGroupOperation>
        <Status>SUCCEEDED</Status>
        <Action>DELETE</Action>
        <RetainStacks>false</RetainStacks>
        <EndTime>2020-01-20T09:22:4</EndTime>
        <OperationId>645d0eed-f1e6-40b0-8e8f-0e1eaa34da6f</OperationId>
        <CreateTime>2020-01-20T09:22:3</CreateTime>
        <StackGroupName>MyStackGroup</StackGroupName>
        <StackGroupId>fd0ddef9-9540-4b42-a464-94f77835****</StackGroupId>
        <AdministrationRoleName>AliyunROSStackGroupAdministrationRole</AdministrationRoleName>
        <OperationPreferences>
            <MaxConcurrentCount>1</MaxConcurrentCount>
            <RegionIdsOrder>cn-hangzhou</RegionIdsOrder>
            <RegionIdsOrder>cn-beijing</RegionIdsOrder>
            <FailureToleranceCount>0</FailureToleranceCount>
        </OperationPreferences>
        <ExecutionRoleName>AliyunROSStackGroupExecutionRole</ExecutionRoleName>
    </StackGroupOperation>
</GetStackGroupOperationResponse>

JSON格式 

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

{
  "RequestId" : "14A07460-EBE7-47CA-9757-12CC4761D47A",
  "StackGroupOperation" : {
    "Status" : "SUCCEEDED",
    "Action" : "DELETE",
    "RetainStacks" : false,
    "EndTime" : "2020-01-20T09:22:4",
    "OperationId" : "645d0eed-f1e6-40b0-8e8f-0e1eaa34da6f",
    "CreateTime" : "2020-01-20T09:22:3",
    "StackGroupName" : "MyStackGroup",
    "StackGroupId" : "fd0ddef9-9540-4b42-a464-94f77835****",
    "AdministrationRoleName" : "AliyunROSStackGroupAdministrationRole",
    "OperationPreferences" : {
      "MaxConcurrentCount" : 1,
      "RegionIdsOrder" : [ "cn-hangzhou", "cn-beijing" ],
      "FailureToleranceCount" : 0
    },
    "ExecutionRoleName" : "AliyunROSStackGroupExecutionRole"
  }
}

错误码

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

错误代码

错误信息

HTTP状态码

描述

InvalidParameter

The specified parameter {name} is invalid, {reason}.

400

无效参数，name为参数名，reason为原因。

StackGroupOperationNotFound

The StackGroupOperation ({OperationId}) could not be found.

404

资源栈组操作不存在。OperationId为操作ID。