华为云用户手册

响应示例 状态码： 200 请求成功。 { "resource_share_invitation" : { "receiver_account_id" : "string", "resource_share_id" : "string", "resource_share_name" : "string", "resource_share_invitation_id" : "string", "sender_account_id" : "string", "status" : "string", "created_at" : "2022-08-22T12:28:26.631Z", "updated_at" : "2022-08-22T12:28:26.631Z" }}

错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 更多服务错误码请参见API错误中心。 状态码 错误码 错误信息 描述 处理措施 400 RAM .1001 The domain id in the header or the token is invalid. 账号ID或token无效。 请检查账号ID是否正确。 400 RAM.1002 The domain id %s in the header is invalid. 账号ID无效。 请检查账号ID是否正确。 400 RAM.1003 The token is invalid. token无效。 请联系技术支持。 400 RAM.1004 The account id is invalid. 账号ID无效。 请检查资源使用者的账号ID是否正确。 400 RAM.1005 The share principal %s cannot be the owner. 共享的使用者不能是资源所有者。 请检查资源使用者是否设置正确。 400 RAM.1006 The principal is invalid for duplicate. 资源使用者存在重复。 请删除重复的资源使用者。 400 RAM.1007 The resource urn is invalid for duplicate. 共享资源的URN存在重复。 请删除重复的共享资源URN。 400 RAM.1008 Bad request for checking permission. 共享资源的权限异常。 请检查是否已经对 IAM 用户授予RAM操作权限。 400 RAM.1009 The resource type %s has no permission. 共享资源未设置权限。 请设置共享资源的权限。 400 RAM.1010 The domain id %s does not own the resource urn %s. 账号ID与资源URN不匹配。 请检查账号ID与资源URN是否匹配。 400 RAM.1011 The %s num exceeds %s quota %s if add count %s. 超出最大配额。 请检查请求参数。 400 RAM.1012 The %s num exceeds the total quota %s if add count %s. 超出最大配额。 请检查请求参数。 400 RAM.1013 The organization management id %s has not enabled sharing. 组织共享功能未开启。 请开启组织共享功能。 400 RAM.1014 The cross organizations share cannot shared to the organizations with the principal %s. 跨组织共享无效。 请检查资源使用者的账号是否属于其他组织。 400 RAM.1015 The cross organizations share cannot shared to the organizations unit with the principal %s. 跨组织共享无效。 请检查资源使用者的账号是否属于其他组织。 400 RAM.1016 The cross organizations share cannot shared to the organizations root with the principal %s. 跨组织共享无效。 请检查资源使用者的账号是否属于其他组织。 404 RAM.1017 The resource share id %s is not found. 资源共享实例的ID无效。 请检查资源共享实例的ID是否正确。 404 RAM.1018 The permission id %s is not found. 共享资源的权限ID无效。 请检查共享资源的权限ID是否正确。 400 RAM.1019 Please accept the open beta of resource access service. 租户未申请服务公测。 请先申请服务公测。 404 RAM.1020 Get project failed. 获取project失败。 请检查账号ID是否正确。 404 RAM.1021 Get domain information failed. 获取domain信息失败。 请联系技术支持。 404 RAM.1022 The principal %s is not exist. 资源使用者不存在。 请检查资源使用者是否正确。 404 RAM.1023 The principal %s is invalid. 资源使用者无效。 请检查资源使用者是否正确。 404 RAM.1024 The urn %s is invalid. 共享资源的URN无效。 请检查共享资源的URN是否正确。 400 RAM.1025 Server SSL cert check failed. SSL证书检查失败。 请联系技术支持。 400 RAM.1026 Query restricted list failed. 查询受限列表失败。 请联系技术支持。 400 RAM.1027 Query frozen list failed. 查询冻结列表失败。 请联系技术支持。 400 RAM.1028 Bad request for notification. 请求错误。 请联系技术支持。 403 RAM.1029 The current operation has been restricted. 当前操作受限。 请检查账号是否被受限。 403 RAM.1030 The current operation has been frozen. 当前操作已冻结。 请检查账号是否被冻结。 400 RAM.1031 Bad request for authorization header pattern. 请求头校验失败。 请联系技术支持。 400 RAM.1032 Bad quota type. 错误的配额类型。 请检查配额类型是否正确。 400 RAM.1033 Async job failed. 任务执行失败。 请联系技术支持。 400 RAM.1034 Don`t have lock 获取锁失败。 请联系技术支持。 400 RAM.1035 Bad request for invalid context attributes. 请求错误。 请联系技术支持。 400 RAM.1036 Bad request for request proof. 请求错误。 请联系技术支持。 400 RAM.1037 Bad request for impersonate. 请求错误。 请联系技术支持。 400 RAM.1101 The status %s of the resource share with id %s is not active. 资源共享实例的状态未激活。 请检查资源共享实例的状态。 400 RAM.1102 There are resources in use in the resource share %s. 资源共享实例中存在已绑定的资源。 请检查资源是否已被绑定。 400 RAM.1103 Some resources do not have or have multiple corresponding permissions. 共享资源未添加或添加多种权限。 请检查共享资源的权限是否设置正确。 404 RAM.1104 Http header not found. HTTP请求头无效。 请检查HTTP请求头。 400 RAM.1105 Bad request for invalid user profile. HTTP请求头中UserProfile参数无效。 请检查HTTP请求头中UserProfile参数。 400 RAM.1106 Get domain tags failed. 获取Domain标签失败。 请联系技术支持。 500 RAM.1107 Bad request for invalid token. 获取OP账号Token失败。 请联系技术支持。 400 RAM.1108 Cannot share resource across sites between international account and national account. 国内站与国际站禁止共享资源。 请检查资源所有者和资源使用者是否属于相同站点。 400 RAM.1109 Cannot share resource between op account and not-op account. OP账号与非OP账号禁止共享资源。 请检查资源所有者和资源使用者是否属于相同类型账号。 400 RAM.1110 Resource sharing not allowed between internal and external accounts. 华为内部客户账号与外部客户账号之间禁止共享资源。 请检查资源所有者和资源使用者是否属于相同类型账号。 400 RAM.1201 The request body is empty. 请求参数为空。 请检查请求参数。 409 RAM.1202 Some principals have been associated to the resource share with id %s. 资源共享实例中已绑定同样的资源使用者。 请检查是否重复绑定同一个资源使用者。 409 RAM.1203 Some resources have been associated to the resource share with id %s. 资源已被资源共享实例关联。 请检查是否重复关联同一个资源。 400 RAM.1204 The status %s of the resource share is not active. 资源共享实例的状态未激活。 请联系技术支持。 400 RAM.1205 Get organization id error. 获取组织ID错误。 请检查账号ID是否正确。 400 RAM.1206 Get ancestors error. 获取上层组织错误。 请检查账号ID是否正确。 400 RAM.1207 Unable to disassociate the principal or the resource which is not exist or owned by you. 无法解除不属于您或不存在的资源或资源使用者的关联。 请检查资源使用者或资源是否正确。 400 RAM.1208 Unable to disassociate the principal because you belong to the organization. 无法移除属于组织的资源使用者。 请检查资源使用者是否属于组织。 400 RAM.1209 Get organization path failed. 获取租户组织路径失败。 请联系技术支持。 400 RAM.1301 The status %s of the resource share is not active. 资源共享实例的状态未激活。 请联系技术支持。 409 RAM.1302 The resource type %s has associated one permission. 共享资源已经绑定权限。 请检查请求参数。 409 RAM.1303 The resource type %s is in use in the resource share with id %s. 共享资源正在使用中，无法解绑此共享资源的权限。 请停止使用此共享资源后再进行解绑权限操作。 409 RAM.1701 The current status of the invitation is %s. 资源共享邀请的状态异常。 请检查资源共享邀请的状态是否正确。 404 RAM.1702 The resource share invitation with id %s is not found. 资源共享的邀请无效。 请检查资源共享的邀请是否过期。 400 RAM.1801 The account id %s is not the management account of organization. 账号ID不是组织管理账号。 非组织管理账号无法进行该操作，请联系组织管理账号处理。 400 RAM.1802 Get organization info error. 组织信息错误。 请检查组织信息是否正确。 400 RAM.1803 The sharing with organization is not enabled by management account %s. 组织管理账号未开启共享。 请联系组织管理账号开启组织共享功能。 501 RAM.1804 RAM is not support organization sharing function. RAM不支持组织共享功能。 请联系技术支持。 400 RAM.1901 Tag key is exist for resource share id. 资源共享实例已存在此标签键。 请检查该资源共享实例中是否已存在同名标签。 400 RAM.1902 The tag key is duplicate. 标签键重复。 请检查标签键是否重复。 400 RAM.1903 The tag value is duplicate. 标签值重复。 请检查标签值是否重复。 400 RAM.1904 Failed to check the resource tag. 检查资源标签失败。 请联系技术支持。 400 RAM.1905 The tag policy doesn't allow the specified value for the following tag key. 标签策略不允许这些标签键使用指定的标签值。 请检查标签是否符合标签策略。 父主题： 附录

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 resource_types Array of ResourceTypesSummary objects 云服务资源的详细信息列表。 page_info PageInfo object 分页详细信息。 表4 ResourceTypesSummary 参数 参数类型 描述 region_id String 资源所在区 域名 称。 resource_type String 资源类型名称。 表5 PageInfo 参数 参数类型 描述 previous_marker String 上一页的页面标识。 next_marker String 下一页的页面标识。 current_count Integer 页面数量。

响应示例 状态码： 200 请求成功。 { "resource_types" : [ { "region_id" : "string", "resource_type" : "string" } ], "page_info" : { "previous_marker" : "string", "next_marker" : "string", "current_count" : 2000 }}

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 quotas QuotaResourcesDto object 配额信息列表。 表3 QuotaResourcesDto 参数 参数类型 描述 resources Array of Quotas objects 配额信息。 表4 Quotas 参数 参数类型 描述 type String 配额类型。resource_share账号创建资源共享的数量，resource_association资源共享关联的资源数量，principal_association资源共享关联的身份数量，permission_association资源共享关联的权限数量，tag_association资源共享关联的标签数量。 quota Integer 总配额数量。 min Integer 最小配额。 max Integer 最大配额。 used Integer 已使用的配额数量。

响应示例 状态码： 200 请求成功。 { "resource_share" : { "id" : "string", "name" : "string", "description" : "string", "allow_external_principals" : true, "owning_account_id" : "string", "status" : "string", "tags" : [ { "key" : "string", "value" : "string" } ], "created_at" : "2023-01-30T11:29:17.578Z", "updated_at" : "2023-01-30T11:29:17.578Z" }}

支持的授权项 策略包含系统策略和自定义策略，如果系统策略不满足授权要求，管理员可以创建自定义策略，并通过给用户组授予自定义策略来进行精细的访问控制。策略支持的操作与API相对应，授权项列表说明如下： 权限：允许或拒绝某项操作。 对应API接口：自定义策略实际调用的API接口。 授权项：自定义策略中支持的Action，在自定义策略中的Action中写入授权项，可以实现授权项对应的权限功能。 依赖的授权项：部分Action存在对其他Action的依赖，需要将依赖的Action同时写入授权项，才能实现对应的权限功能。 IAM项目(Project)/企业项目(Enterprise Project)：自定义策略的授权范围，包括IAM项目与企业项目。授权范围如果同时支持IAM项目和企业项目，表示此授权项对应的自定义策略，可以在IAM和企业管理两个服务中给用户组授权并生效。如果仅支持IAM项目，不支持企业项目，表示仅能在IAM中给用户组授权并生效，如果在企业管理中授权，则该自定义策略不生效。关于IAM项目与企业项目的区别，详情请参见：IAM项目与企业项目的区别。 “√”表示支持，“x”表示暂不支持。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 resource_share ResourceShare object 描述RAM中的资源共享。 表5 ResourceShare 参数 参数类型 描述 id String 资源共享实例的ID。 name String 资源共享实例的名称。 description String 资源共享实例的描述。 allow_external_principals Boolean 资源共享实例是否支持共享给组织外账号。 owning_account_id String 资源共享实例的所有者ID。 status String 资源共享实例的状态。 tags Array of Tag objects 资源共享实例的标签列表。 created_at String 创建资源共享实例的时间。 updated_at String 最后一次更新资源共享实例的时间。 表6 Tag 参数 参数类型 描述 key String 标签"键"的标识符或名称。 value String 标签"键"对应的"值"。您可以将标签的值设置为空字符串，但不能设置为null。

响应示例 状态码： 200 请求成功。 { "resource_share_associations" : [ { "associated_entity" : "string", "association_type" : "string", "created_at" : "2022-08-22T11:53:04.912Z", "updated_at" : "2022-08-22T11:53:04.912Z", "external" : true, "resource_share_id" : "string", "resource_share_name" : "string", "status" : "string", "status_message" : "string" } ]}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Security-Token 否 String 如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。 表3 请求Body参数 参数 是否必选 参数类型 描述 name 是 String 资源共享实例的名称。 description 否 String 资源共享实例的描述。 allow_external_principals 否 Boolean 资源共享实例是否支持共享给组织外账号。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Security-Token 否 String 如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。 表3 请求Body参数 参数 是否必选 参数类型 描述 principals 否 Array of strings 指定与资源共享实例关联的一个或多个资源使用者的列表。 resource_urns 否 Array of strings 指定与资源共享实例关联的一个或多个共享资源URN的列表。

响应示例 状态码： 201 请求成功。 { "resource_share" : { "id" : "string", "name" : "string", "description" : "string", "allow_external_principals" : true, "owning_account_id" : "string", "status" : "string", "tags" : [ { "key" : "string", "value" : "string" } ], "created_at" : "2022-09-27T03:14:08.883Z", "updated_at" : "2022-09-27T03:14:08.883Z" }}

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 resource_share_associations Array of ResourceShareAssociation objects 与资源共享实例关联的资源使用者或共享资源的详细信息。 表5 ResourceShareAssociation 参数 参数类型 描述 associated_entity String 绑定的实体。这可以是共享资源的URN、账号ID、组织根的URN或OU的URN之一。 association_type String 绑定中包含的实体类型。 created_at String 绑定被创建的时间。 updated_at String 最后一次更新绑定的时间。 external Boolean 标识资源使用者是否和共享的拥有者属于同一个组织 resource_share_id String 资源共享实例的ID。 resource_share_name String 资源共享实例的名称。 status String 绑定的当前状态。 status_message String 绑定的当前状态的描述。

请求示例 创建一个资源共享实例，并指定需要共享的资源，资源使用者，授予资源使用者的权限，以及资源共享实例的标签。 POST https://{endpoint}/v1/resource-shares{ "name" : "string", "description" : "string", "permission_ids" : [ "string" ], "principals" : [ "string" ], "resource_urns" : [ "string" ], "tags" : [ { "key" : "string", "value" : "string" } ]}

响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 详细的公共响应消息头字段请参见表1。 表1 公共响应消息头 消息头名称 描述 Content-Type 资源内容的类型。 类型：String 默认值：无。 Connection 指明与服务器的连接是长连接还是短连接。 类型：String 有效值：keep-alive | close。 默认值：无。 Date RAM服务响应的时间。 类型：String 默认值：无。 X-Request-Id 由RAM创建来唯一确定本次请求的值，可以通过该值来定位问题。 类型：String 默认值：无。

响应消息体 响应消息体通常以结构化格式返回，与响应消息头中Content-type对应，传递除响应消息头之外的内容。 对于检索共享资源权限列表接口，返回如下消息体。为篇幅起见，这里只展示部分内容。 { "permissions": [ { "id": "7d04b6d4-00d5-41bd-b13c-22abd1ea249b", "name": "test-dns-zones", "resource_type": "dns:zone", "is_resource_type_default": true, "created_at": "2022-08-10T07:18:47Z", "updated_at": "2022-10-21T15:22:15Z" }, { "id": "8c378992-2450-4b2e-9c94-58fe01c74397", "name": "test-dns-resolverRules", "resource_type": "dns:resolverRule", "is_resource_type_default": true, "created_at": "2022-08-10T07:50:02Z", "updated_at": "2022-10-25T17:27:01Z" },...... 当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示。 { "error_msg": "The resource type vpc:subnet has no permission", "error_code": "RAM.1009"} 其中，error_code表示错误码，error_msg表示错误描述信息。

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Security-Token 否 String 如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。 表2 请求Body参数 参数 是否必选 参数类型 描述 name 是 String 资源共享实例的名称。 description 否 String 资源共享实例的描述。 allow_external_principals 否 Boolean 资源共享实例是否支持共享给组织外账号。 permission_ids 否 Array of strings 资源共享实例关联的RAM权限列表。一种资源类型只能关联一个RAM权限。如果您没有指定权限ID，RAM将自动为每个资源类型关联默认权限。 principals 否 Array of strings 资源共享实例关联的一个或多个资源使用者的列表。 resource_urns 否 Array of strings 资源共享实例关联的一个或多个共享资源URN的列表。 tags 否 Array of Tag objects 资源共享标签列表。 表3 Tag 参数 是否必选 参数类型 描述 key 是 String 标签"键"的标识符或名称。 value 是 String 标签"键"对应的"值"。您可以将标签的值设置为空字符串，但不能设置为null。

响应参数 状态码： 201 表4 响应Body参数 参数 参数类型 描述 resource_share ResourceShare object 描述RAM中的资源共享。 表5 ResourceShare 参数 参数类型 描述 id String 资源共享实例的ID。 name String 资源共享实例的名称。 description String 资源共享实例的描述。 allow_external_principals Boolean 资源共享实例是否支持共享给组织外账号。 owning_account_id String 资源共享实例的所有者ID。 status String 资源共享实例的状态。 tags Array of Tag objects 资源共享实例的标签列表。 created_at String 创建资源共享实例的时间。 updated_at String 最后一次更新资源共享实例的时间。 表6 Tag 参数 参数类型 描述 key String 标签"键"的标识符或名称。 value String 标签"键"对应的"值"。您可以将标签的值设置为空字符串，但不能设置为null。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 shared_principals Array of SharedPrincipal objects 资源使用者的详细信息列表。 page_info PageInfo object 分页详细信息。 表4 SharedPrincipal 参数 参数类型 描述 resource_share_id String 资源使用者绑定的资源共享实例的ID。 id String 资源使用者的账号ID或URN。 created_at String 资源使用者与资源共享实例关联的时间。 updated_at String 最后一次更新资源共享实例的时间。 表5 PageInfo 参数 参数类型 描述 previous_marker String 上一页的页面标识。 next_marker String 下一页的页面标识。 current_count Integer 页面数量。

请求示例 检索共享资源的使用者。 POST https://{endpoint}/v1/shared-principals/search{ "limit" : 2000, "marker" : "string", "principals" : [ "string" ], "resource_urn" : "string", "resource_owner" : "self", "resource_share_ids" : [ "string" ]}

响应示例 状态码： 200 请求成功。 { "shared_principals" : [ { "resource_share_id" : "string", "id" : "string", "created_at" : "2022-09-19T02:33:13.496Z", "updated_at" : "2022-09-19T02:33:13.496Z" } ], "page_info" : { "previous_marker" : "string", "next_marker" : "string", "current_count" : 2000 }}

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Security-Token 否 String 如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。 表2 请求Body参数 参数 是否必选 参数类型 描述 limit 否 Integer 分页页面的最大值。 marker 否 String 页面标记。 principals 否 Array of strings 指定资源使用者。 resource_urn 否 String 指定资源的URN。 resource_owner 是 String 指定资源共享实例的所有者（self或者other-accounts）。 resource_share_ids 否 Array of strings 指定资源共享实例的ID列表。

请求示例 检索您创建的资源共享实例详情。 POST https://{endpoint}/v1/resource-shares/search{ "limit" : 2000, "name" : "string", "marker" : "string", "permission_id" : "string", "resource_owner" : "self", "resource_share_ids" : [ "string" ], "resource_share_status" : "string", "tag_filters" : [ { "key" : "string", "values" : [ "string" ] } ]}

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 resource_shares Array of ResourceShare objects 资源共享实例的详细信息列表。 page_info PageInfo object 分页详细信息。 表5 ResourceShare 参数 参数类型 描述 id String 资源共享实例的ID。 name String 资源共享实例的名称。 description String 资源共享实例的描述。 allow_external_principals Boolean 资源共享实例是否支持共享给组织外账号。 owning_account_id String 资源共享实例的所有者ID。 status String 资源共享实例的状态。 tags Array of Tag objects 资源共享实例的标签列表。 created_at String 创建资源共享实例的时间。 updated_at String 最后一次更新资源共享实例的时间。 表6 Tag 参数 参数类型 描述 key String 标签"键"的标识符或名称。 value String 标签"键"对应的"值"。您可以将标签的值设置为空字符串，但不能设置为null。 表7 PageInfo 参数 参数类型 描述 previous_marker String 上一页的页面标识。 next_marker String 下一页的页面标识。 current_count Integer 页面数量。

响应示例 状态码： 200 请求成功。 { "resource_shares" : [ { "id" : "string", "name" : "string", "description" : "string", "allow_external_principals" : true, "owning_account_id" : "string", "status" : "string", "tags" : [ { "key" : "string", "value" : "string" } ], "created_at" : "2023-01-06T08:24:55.638Z", "updated_at" : "2023-01-06T08:24:55.638Z" } ], "page_info" : { "previous_marker" : "string", "next_marker" : "string", "current_count" : 2000 }}

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Security-Token 否 String 如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。 表2 请求Body参数 参数 是否必选 参数类型 描述 limit 否 Integer 分页页面的最大值。 name 否 String 资源共享实例名称。 marker 否 String 页面标记。 permission_id 否 String 权限ID。 resource_owner 是 String 检索您创建的或共享给您的（self或者other-accounts）资源共享实例。 resource_share_ids 否 Array of strings 资源共享实例的ID列表。 resource_share_status 否 String 资源共享实例的状态。 tag_filters 否 Array of TagFilter objects 资源共享实例的标签。 表3 TagFilter 参数 是否必选 参数类型 描述 key 是 String 标签"键"的标识符或名称。 values 否 Array of strings 标签"键"对应的"值"列表。

请求示例 根据标签信息查询资源共享实例数量。 POST https://{endpoint}/v1/resource-shares/resource-instances/count{ "without_any_tag" : true, "tags" : [ { "key" : "string", "values" : [ "string" ] } ], "matches" : [ { "key" : "string", "value" : "string" } ]}

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Security-Token 否 String 如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。 表2 请求Body参数 参数 是否必选 参数类型 描述 without_any_tag 否 Boolean 不包含任意一个标签，该字段为true时查询所有不带标签的资源。 tags 否 Array of TagFilter objects 包含标签，最多包含20个key，每个key下面的value最多20个，结构体不能缺失，key不能为空或者空字符串。Key不能重复，同一个key中values不能重复。返回包含所有标签的资源列表，key之间是"与"的关系，key-value结构中value是"或"的关系。无tag过滤条件时返回全量数据。 matches 否 Array of Match objects 资源共享实例绑定标签列表的匹配字段。 表3 TagFilter 参数 是否必选 参数类型 描述 key 是 String 标签"键"的标识符或名称。 values 否 Array of strings 标签"键"对应的"值"列表。 表4 Match 参数 是否必选 参数类型 描述 key 是 String 键。取值范围为policy , organizational-unit, account。 value 是 String 值。每个值最大长度255个字符。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 tags Array of TagDTO objects 一个或多个标签键值对的列表。标签键必须存在，而不是空字符串。标签值必须存在，但可以是空字符串。 page_info PageInfoMarkerByKey object 分页详细信息。 表4 TagDTO 参数 参数类型 描述 key String 标签"键"的标识符或名称。您可以将标签的值设置为空字符串，但不能设置为null。 values Array of strings 值列表。每个值最大长度255个字符。 表5 PageInfoMarkerByKey 参数 参数类型 描述 previous_marker String 上一页的页面标识。 next_marker String 下一页的页面标识。 current_count Integer 页面数量。

响应示例 状态码： 200 请求成功。 { "associated_permissions" : [ { "permission_id" : "string", "permission_name" : "string", "resource_type" : "string", "status" : "string", "created_at" : "2022-09-19T02:12:30.736Z", "updated_at" : "2022-09-19T02:12:30.736Z" } ], "page_info" : { "previous_marker" : "string", "next_marker" : "string", "current_count" : 2000 }}