功能介绍
检索您添加到资源共享或被共享给您的不同资源。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
| 授权项 | 访问级别 | 资源类型（*为必须） | 条件键 | 别名 | 依赖的授权项 |
| ram:sharedResources:searchDistinctResource | List | - | - | - | - |
URI
POST /v1/shared-resources/search-distinct-resource
请求参数
表2 请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 |
| limit | 否 | Integer | 页面中最大结果的数量。当未指定limit参数情况下，系统默认值为2000。 |
| marker | 否 | String | 页面标记。 |
| resource_ids | 否 | Array of strings | 指定资源ID。 |
| principal | 否 | String | 指定资源使用者。 |
| resource_region | 否 | String | 资源所在的区域。 |
| resource_urns | 否 | Array of strings | 指定资源URN的列表。 |
| resource_owner | 是 | String | 指定资源共享实例的所有者（self或者other-accounts）。 |
响应参数
状态码：200
表3 响应Body参数 | 参数 | 参数类型 | 描述 |
| distinct_shared_resources | Array of DistinctSharedResource objects | 不同资源的信息列表。 |
| page_info | PageInfo object | 参数解释： 分页详细信息。包含 previous_marker，next_marker 与 current_count 字段 约束限制： 不涉及 |
表4 DistinctSharedResource | 参数 | 参数类型 | 描述 |
| resource_urn | String | 参数解释： 资源的统一资源名称。 约束限制： 不涉及 取值范围： 由[0-1500]个字符组成 默认取值： 不涉及 |
| resource_type | String | 参数解释： 资源的类型。 约束限制： 不涉及 取值范围： 由[0-1500]个字符组成 默认取值： 不涉及 |
| updated_at | String | 参数解释： 最后一次更新资源共享实例的时间。 约束限制： 不涉及 取值范围： 对应 RFC 3339 规范的日期时间格式，yyyy-MM-ddTHH:mm:ss.SSSZ 默认取值： 不涉及 |
表5 PageInfo | 参数 | 参数类型 | 描述 |
| previous_marker | String | 参数解释： 上一页的页面标识。 约束限制： 不涉及 取值范围： 仅支持数字，且长度为[1- 64]个字符组成 默认取值： 不涉及 |
| next_marker | String | 参数解释： 下一页的页面标识。 约束限制： 不涉及 取值范围： 仅支持数字，且长度为[1- 64]个字符组成 默认取值： 不涉及 |
| current_count | Integer | 参数解释： 页面数量。 约束限制： 不涉及 取值范围： 仅支持数字，范围为 [1-2000] 默认取值： 不涉及 |
请求示例
检索您添加到资源共享或被共享给您的不同资源。
POST /v1/shared-resources/search-distinct-resource
{
"limit" : 2000,
"marker" : "string",
"resource_ids" : [ "string" ],
"principal" : "string",
"resource_region" : "string",
"resource_urns" : [ "string" ],
"resource_owner" : "self"
} 响应示例
状态码：200
请求成功。
{
"distinct_shared_resources" : [ {
"resource_urn" : "string",
"resource_type" : "string",
"updated_at" : "2022-09-19T02:32:48.943Z"
} ],
"page_info" : {
"previous_marker" : "string",
"next_marker" : "string",
"current_count" : 2000
}
} 
