分页查询一个或者多个云角色信息。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| CloudAccountId |
string |
是 |
云账号 ID。 |
ca_01kmegjc11qa1txxxxx |
| InstanceId |
string |
是 |
实例 ID。 |
idaas_ue2jvisn35ea5lmthk267xxxxx |
| NextToken |
string |
否 |
用于标识下一个分页的起始位置的 Token。
|
NTxxxxxexample |
| MaxResults |
integer |
否 |
分页的最大记录数。
|
20 |
| Filter |
array<object> |
否 |
过滤条件。 |
|
|
object |
否 |
过滤条件。 |
||
| Name |
string |
否 |
过滤字段名称。取值可选范围：
枚举值：
|
CloudAccountRoleId |
| Value |
array |
否 |
过滤字段取值列表。 |
|
|
string |
否 |
过滤字段取值。 |
carole_01kmek49aqxxxx |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
请求 ID。 |
0441BD79-92F3-53AA-8657-F8CE4A2B912A |
| TotalCount |
integer |
列表总条数目。 |
100 |
| NextToken |
string |
本次调用返回的查询凭证（Token）值。 |
NTxxxexample |
| MaxResults |
integer |
分页查询时每页行数。 |
20 |
| CloudAccountRoles |
array<object> |
云角色列表。 |
|
|
array<object> |
云角色详情。 |
||
| InstanceId |
string |
实例 ID。 |
idaas_ue2jvisn35ea5lmthk267xxxxx |
| CloudAccountId |
string |
云账号 ID。 |
ca_01kmegjc11qa1txxxxx |
| CloudAccountRoleId |
string |
云角色 ID。 |
carole_01kmek49aqxxxx |
| CloudAccountRoleType |
string |
云角色类型。具体形式取决于云账号类型。当前支持的取值包括：
枚举值：
|
role |
| CloudAccountRoleUsageType |
string |
云角色使用类型。取值可选范围：
枚举值：
|
system |
| CloudAccountRoleName |
string |
云角色名称。 |
role-test |
| CloudAccountRoleExternalId |
string |
云角色标识。 |
acs:ram::xxx:role/role-test |
| CloudAccountRoleHealth |
string |
云角色健康状态。取值可选范围：
枚举值：
|
healthy |
| Status |
string |
云角色状态。取值可选范围：
枚举值：
|
enabled |
| Description |
string |
云角色描述。 |
cloud_account_role_description |
| CreateTime |
integer |
创建时间，Unix 时间戳格式，单位为毫秒。 |
1719320115000 |
| UpdateTime |
integer |
最近更新时间，Unix 时间戳格式，单位为毫秒。 |
1719320117000 |
| CloudAccountRoleHealthCheckResult |
object |
云角色健康状态检查结果。 |
|
| Result |
string |
云角色健康检查结果。取值可选范围：
枚举值：
|
success |
| LastCheckTime |
integer |
最后一次检测时间，Unix 时间戳格式，单位为毫秒。 |
1649830226000 |
| ErrorReason |
object |
错误原因。当健康检查状态为 unhealthy 时，该字段会返回值。 |
|
| ErrorCode |
string |
错误码。 |
AuthenticationFail.NoPermission |
| ErrorMessage |
string |
错误描述。 |
There is no permission. |
示例
正常返回示例
JSON格式
{
"RequestId": "0441BD79-92F3-53AA-8657-F8CE4A2B912A",
"TotalCount": 100,
"NextToken": "NTxxxexample",
"MaxResults": 20,
"CloudAccountRoles": [
{
"InstanceId": "idaas_ue2jvisn35ea5lmthk267xxxxx",
"CloudAccountId": "ca_01kmegjc11qa1txxxxx",
"CloudAccountRoleId": "carole_01kmek49aqxxxx",
"CloudAccountRoleType": "role",
"CloudAccountRoleUsageType": "system",
"CloudAccountRoleName": "role-test",
"CloudAccountRoleExternalId": "acs:ram::xxx:role/role-test",
"CloudAccountRoleHealth": "healthy",
"Status": "enabled",
"Description": "cloud_account_role_description",
"CreateTime": 1719320115000,
"UpdateTime": 1719320117000,
"CloudAccountRoleHealthCheckResult": {
"Result": "success",
"LastCheckTime": 1649830226000,
"ErrorReason": {
"ErrorCode": "AuthenticationFail.NoPermission",
"ErrorMessage": "There is no permission."
}
}
}
]
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。