调用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。