检索与用户或用户组关联的应用程序列表
功能介绍
检索与用户或用户组关联的应用程序列表。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v1/instances/{instance_id}/application-assignments-for-principals
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
instance_id |
是 |
String |
IAM Identity Center实例的全局唯一标识符(ID) |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
principal_id |
是 |
String |
身份主体的全局唯一标识符(ID) |
principal_type |
是 |
String |
身份主体类型,USER或者GROUP |
limit |
否 |
Integer |
每个请求返回的最大结果数。 |
marker |
否 |
String |
分页标记 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Security-Token |
否 |
String |
如果正在使用临时安全凭据,则此header是必需的,该值是临时安全凭据的安全令牌(会话令牌)。 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
application_assignments |
Array of ApplicationAssignmentDto objects |
应用程序分配的主体 |
page_info |
PageInfoDto object |
分页信息 |
参数 |
参数类型 |
描述 |
---|---|---|
application_urn |
String |
应用程序URN |
principal_id |
String |
主体Id |
principal_type |
String |
主体类型 |
参数 |
参数类型 |
描述 |
---|---|---|
next_marker |
String |
如果存在,则表示可用的输出比当前响应中包含的输出多。在对操作的后续调用中,在标签请求参数中使用此值,以获取输出的下一部分。您应该重复此操作,直到next_marker响应元素返回为null |
current_count |
Integer |
本页返回条目数量 |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误信息 |
request_id |
String |
请求唯一标识 |
状态码:403
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误信息 |
request_id |
String |
请求唯一标识 |
encoded_authorization_message |
String |
加密的错误信息 |
请求示例
检索与用户或用户组关联的应用程序列表
GET https://{hostname}/v1/instances/{instance_id}/application-assignments-for-principals
响应示例
状态码:200
Successful
{ "application_assignments" : [ { "application_urn" : "IdentityCenter::8c1eef3a241945f69c3d3a6b0xxxxx:application:ins-36218e5b4cxxxx/apl-83142f08178ce359", "principal_id" : "4b969bc6-e8ed-47ce-b62b-936319e2bcb1", "principal_type" : "USER" }, { "application_urn" : "IdentityCenter::8c1eef3a241945f69c3d3a6b02xxx:application:ins-36218e5b4c2cxxx/apl-83142f08178ce349", "principal_id" : "4b969bc6-e8ed-47ce-b62b-936319e2bcb1", "principal_type" : "USER" } ], "page_info" : { "next_marker" : null, "current_count" : 2 } }
状态码
状态码 |
描述 |
---|---|
200 |
Successful |
400 |
Bad request |
403 |
Forbidden |
错误码
请参见错误码。