调用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 |
操作状态。 取值:
|
StackGroupId | String | fd0ddef9-9540-4b42-a464-94f77835**** |
资源栈组ID。 |
Action | String | DELETE |
操作动作。 取值:
|
CreateTime | String | 2020-01-20T09:22:3 |
操作开始时间。 |
RetainStacks | Boolean | true |
是否保留资源栈。删除资源栈实例时可选择删除或保留它所指向的资源栈。 取值:
说明 仅在您执行删除资源栈实例的操作时,才会返回该参数。
|
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 |
偏差检测状态。 取值:
|
StackGroupDriftStatus | String | DRIFTED |
资源栈组偏差状态。 取值:
|
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。 |