# 取消批量授权 - BatchCancelAuthorizationInterface #### 功能介绍 批量取消授权接口。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/LakeFormation/doc?api=BatchCancelAuthorizationInterface)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-lakeformation/abcd.html)。 #### URI POST /v1/{project_id}/instances/{instance_id}/policies/revoke 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释:** 项目编号。获取方法，请参见[获取项目ID](https://support.huaweicloud.com/api-lakeformation/lakeformation_04_0026.html)。 **约束限制:** 长度为1\~64个字符 **取值范围:** 长度为1\~64个字符 **默认取值:** false | | instance_id | 是 | String | **参数解释:** LakeFormation实例ID。创建实例时自动生成。例如：2180518f-42b8-4947-b20b-adfc53981a25。 **约束限制:** 最小长度为1 **取值范围:** 最小长度为1 **默认取值:** false | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | Array of strings | **参数解释:** 租户token。 **约束限制:** 数组元素个数为1\~100 **取值范围:** 数组元素个数为1\~100 **默认取值:** 不涉及 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | principal_list | 是 | Array of [Principal] objects | **参数解释:** 主体信息 **约束限制:** 数组元素个数为0\~20 **取值范围:** 数组元素个数为0\~20 **默认取值:** 不涉及 | | resource | 是 | [ResourceInfo] object | **参数解释:** 资源信息 **约束限制:** 不涉及 **取值范围:** 不涉及 **默认取值:** 不涉及 | | effect | 是 | Boolean | **参数解释:** 拒绝/允许 **约束限制:** 不涉及 **取值范围:** 不涉及 **默认取值:** true | | permissions | 否 | Array of strings | **参数解释:** 权限列表：ALL、CREATE、ALTER、DROP、DESCRIBE、EXEC、CREATE_DATABASE、LIST_DATABASE、CREATE_TABLE、LIST_TABLE、CREATE_FUNC、LIST_FUNC、REGISTER_MODEL、LIST_MODEL、CREATE_MODEL、CREATE_DATASET、LIST_DATASET、READ_DATASET、WRITE_DATASET、INSERT、UPDATE、DELETE、SELECT、READ、WRITE、OPERATE、INTROSPECTION、SOURCES、DICT GET、TRUNCATE、 OPTIMIZE、CREATE TEMPORARY TABLE、CREATE DICTIONARY、CREATE VIEW、SHOW DATABASES、SHOW TABLES、SHOW DICTIONARIES、SHOW COLUMNS、DROP DATABASE、DROP VIEW、DROP DICTIONARY、DROP TABLE、ALTER TABLE、ALTER UPDATE、ALTER DELETE、ALTER COLUMN、ALTER ADD COLUMN、ALTER DROP COLUMN、ALTER MODIFY COLUMN、ALTER COMMENT COLUMN、ALTER CLEAR COLUMN、 ALTER RENAME COLUMN、ALTER INDEX、ALTER ORDER BY、ALTER ADD INDEX、ALTER DROP INDEX、ALTER MATERIALIZE INDEX、ALTER CLEAR INDEX、ALTER CONSTRAINT、ALTER ADD CONSTRAINT、ALTER DROP CONSTRAINT、ALTER TTL、ALTER MATERIALIZE TTL、ALTER SETTINGS、ALTER MOVE PARTITION、ALTER FETCH PARTITION、ALTER FREEZE PARTITION、ALTER VIEW、ALTER VIEW REFRESH、ALTER VIEW MODIFY QUERY **约束限制:** 数组元素个数为0\~50 **取值范围:** 不涉及 **默认取值:** 不涉及 | | grant_able_permissions | 否 | Array of strings | **参数解释:** 可传递的权限列表：ALL、CREATE、ALTER、DROP、DESCRIBE、EXEC、CREATE_DATABASE、LIST_DATABASE、CREATE_TABLE、LIST_TABLE、CREATE_FUNC、LIST_FUNC、REGISTER_MODEL、LIST_MODEL、CREATE_MODEL、CREATE_DATASET、LIST_DATASET、READ_DATASET、WRITE_DATASET、INSERT,UPDATE、DELETE、SELECT、READ、WRITE、OPERATE、INTROSPECTION、SOURCES、DICT GET、 TRUNCATE、OPTIMIZE、CREATE TEMPORARY TABLE、CREATE DICTIONARY、CREATE VIEW、SHOW DATABASES、SHOW TABLES、SHOW DICTIONARIES、SHOW COLUMNS、DROP DATABASE、DROP VIEW、DROP DICTIONARY、DROP TABLE、ALTER TABLE、ALTER UPDATE、ALTER DELETE、ALTER COLUMN、ALTER ADD COLUMN、ALTER DROP COLUMN、ALTER MODIFY COLUMN、ALTER COMMENT COLUMN、ALTER CLEAR COLUMN、 ALTER RENAME COLUMN、ALTER INDEX、ALTER ORDER BY、ALTER ADD INDEX、ALTER DROP INDEX、ALTER MATERIALIZE INDEX、ALTER CLEAR INDEX、ALTER CONSTRAINT、ALTER ADD CONSTRAINT、ALTER DROP CONSTRAINT、ALTER TTL、ALTER MATERIALIZE TTL、ALTER SETTINGS、ALTER MOVE PARTITION、ALTER FETCH PARTITION、ALTER FREEZE PARTITION、ALTER VIEW、ALTER VIEW REFRESH、ALTER VIEW MODIFY QUERY **约束限制:** 数组元素个数为0\~50 **取值范围:** 不涉及 **默认取值:** 不涉及 | | conditions | 否 | String | **参数解释:** 条件 **约束限制:** 长度为1\~1000个字符 **取值范围:** 长度为1\~1000个字符 **默认取值:** 不涉及 | | data_filter | 否 | String | **参数解释:** 行过滤 **约束限制:** 长度为1\~1000个字符 **取值范围:** 长度为1\~1000个字符 **默认取值:** 不涉及 | | data_mask | 否 | String | **参数解释:** 列脱敏 **约束限制:** 长度为1\~1000个字符 **取值范围:** 长度为1\~1000个字符 **默认取值:** 不涉及 | | data_mask_type | 否 | String | **参数解释:** data mask type：REDACT修订， HASH哈希加密，PARTIAL_MASK部分掩码，NULLIFY用NULL值替换原值，UNMASKED原样显示，DATA_ONLY_SHOW_YEAR仅显示日期字符串的年份部分，CUSTOM自定义脱敏规则 **约束限制:** 可选值为：REDACT, HASH, PARTIAL_MASK, NULLIFY, UNMASKED, DATA_ONLY_SHOW_YEAR, CUSTOM **取值范围:** 不涉及 **默认取值:** 不涉及 | | parameters | 否 | Map\ | **参数解释:** 参数 **约束限制:** 长度为1\~256个字符 **取值范围:** 长度为1\~256个字符 **默认取值:** 不涉及 | | is_async | 否 | Boolean | **参数解释:** 是否异步添加OBS AccessLabel,默认为false **约束限制:** 不涉及 **取值范围:** 不涉及 **默认取值:** false | 表4Principal | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | principal_type | 是 | String | **参数解释:** 主体类型： USER-用户 GROUP-组 ROLE-角色 SHARE-共享 OTHER-其它 **约束限制:** 可选值为：USER, GROUP, ROLE, SHARE, OTHER **取值范围:** 不涉及 **默认取值:** 不涉及 | | principal_source | 是 | String | **参数解释:** 主体来源： IAM-云用户 SAML-联邦 LDAP-LDAP用户 LOCAL-本地用户 AGENTTENANT-委托 OTHER-其它 **约束限制:** 可选值为：IAM, SAML, LDAP, LOCAL, AGENTTENANT, OTHER **取值范围:** 不涉及 **默认取值:** 不涉及 | | principal_name | 是 | String | **参数解释:** 主体名称。只能包含中文、字母、数字和_-.特殊字符，且长度为1\~49个字符。principal_name支持中划线'-'字符，但是对Principal进行授权时不支持'-'字符，可通过将有中划线的用户绑定到相关角色进行授权 **约束限制:** 长度为1\~49个字符 **取值范围:** 长度为1\~49个字符 **默认取值:** 不涉及 | 表5ResourceInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | catalogs | 否 | Array of [CatalogInfo] objects | **参数解释:** catalog信息 **约束限制:** 数组元素个数为0\~10 **取值范围:** 数组元素个数为0\~10 **默认取值:** 不涉及 | | uris | 否 | Array of strings | **参数解释:** URI，路径地址 **约束限制:** 数组元素个数为0\~10 **取值范围:** 长度为0\~4000个字符，数组元素个数为0\~10 **默认取值:** 不涉及 | | type | 是 | String | **参数解释：** 资源类型 **约束限制：** 长度为0\~4000个字符，可选值为：CATALOG, DATABASE, TABLE, COLUMN, FUNC, MODEL, DATASET, URI，数组元素个数为0\~10 **取值范围：** 长度为0\~4000个字符，数组元素个数为0\~10 DATABASE：数据库 TABLE：表 COLUMN：列 FUNC：函数 MODEL：模型 DATASET：数据集 URI：地址标识符 **默认取值：** 不涉及 | 表6CatalogInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | databases | 否 | Array of [DatabaseInfo] objects | **参数解释:** 子数据库信息 **约束限制:** 数组元素个数为0\~10 **取值范围:** 数组元素个数为0\~10 **默认取值:** 不涉及 | | name | 是 | String | **参数解释:** catalog名 **约束限制:** 长度为0\~256个字符 **取值范围:** 长度为0\~256个字符 **默认取值:** 不涉及 | | models | 否 | Array of [ModelInfo] objects | **参数解释:** 子模型信息 **约束限制:** 数组元素个数为0\~10 **取值范围:** 数组元素个数为0\~10 **默认取值:** 不涉及 | 表7DatabaseInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 是 | String | **参数解释:** 数据库名称。只能包含中文、字母、数字、下划线、中划线，且长度为1\~128个字符 **约束限制:** 不涉及 **取值范围:** 不涉及 **默认取值:** 不涉及 | | tables | 否 | Array of [TableInfo] objects | **参数解释:** 子表信息 **约束限制:** 数组元素个数为0\~10 **取值范围:** 数组元素个数为0\~10 **默认取值:** 不涉及 | | functions | 否 | Array of [FunctionInfo] objects | **参数解释:** 子方法信息 **约束限制:** 数组元素个数为0\~10 **取值范围:** 数组元素个数为0\~10 **默认取值:** 不涉及 | | datasets | 否 | Array of [DatasetInfo] objects | **参数解释:** 子数据集信息 **约束限制:** 数组元素个数为0\~10 **取值范围:** 数组元素个数为0\~10 **默认取值:** 不涉及 | 表8TableInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | columns | 否 | [ColumnInfo] object | **参数解释:** 子列信息 **约束限制:** 不涉及 **取值范围:** 不涉及 **默认取值:** 不涉及 | | name | 是 | String | **参数解释:** 表名称 **约束限制:** 不涉及 **取值范围:** 不涉及 **默认取值:** 不涉及 | 表9ColumnInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | column_name | 是 | Array of strings | **参数解释:** 列名称。只能包含中文、字母、数字和_-+\*(), 特殊字符，且长度为1\~767个字符 **约束限制:** 数组元素个数为0\~2000 **取值范围:** 数组元素个数为0\~2000 **默认取值:** 不涉及 | | filter | 是 | String | **参数解释:** 是否排除：Include包含，Exclude排除 **约束限制:** 可选值为：Include, Exclude **取值范围:** 不涉及 **默认取值:** 不涉及 | 表10FunctionInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 是 | String | **参数解释:** 函数名称 **约束限制:** 长度为0\~256个字符 **取值范围:** 长度为0\~256个字符 **默认取值:** 不涉及 | 表11DatasetInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 是 | String | **参数解释:** description: 数据集名称。只能包含数字、字母、下划线、\*，且长度为1\~256。 **约束限制:** 长度为1\~256个字符 **取值范围:** 长度为1\~256个字符 **默认取值:** 不涉及 | 表12ModelInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 是 | String | **参数解释:** 模型名称。只能包含字母、数字、下划线、中划线，且长度为1\~256个字符 **约束限制:** 长度为1\~256个字符 **取值范围:** 长度为1\~256个字符 **默认取值:** 不涉及 | #### 响应参数 **状态码：200** OK **状态码：201** Created **状态码：400** 表13响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释:** 错误码 | | error_msg | String | **参数解释:** 错误描述 | | solution_msg | String | **参数解释:** 解决方案描述 | **状态码：401** 表14响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释:** 错误码 | | error_msg | String | **参数解释:** 错误描述 | | solution_msg | String | **参数解释:** 解决方案描述 | **状态码：403** 表15响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error | [Error] object | **参数解释:** 错误信息 | | error_code | String | **参数解释:** 错误码 | | error_msg | String | **参数解释:** 错误描述 | | title | String | **参数解释:** 标题 | 表16Error | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释:** 错误码 | | error_msg | String | **参数解释:** 错误描述 | | title | String | **参数解释:** 标题 | | message | String | **参数解释:** 错误信息 | | code | String | **参数解释:** 状态码 | **状态码：404** 表17响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释:** 错误码 | | error_msg | String | **参数解释:** 错误描述 | | solution_msg | String | **参数解释:** 解决方案描述 | **状态码：408** 表18响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释:** 错误码 | | error_msg | String | **参数解释:** 错误描述 | | solution_msg | String | **参数解释:** 解决方案描述 | **状态码：500** 表19响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释:** 错误码 | | error_msg | String | **参数解释:** 错误描述 | | solution_msg | String | **参数解释:** 解决方案描述 | #### 请求示例 ``` POST https://{endpoint}/v1/{project_id}/instances/{instance_id}/policies/revoke { "principal_list" : [ { "principal_type" : "USER", "principal_source" : "IAM", "principal_name" : "user1" } ], "resource" : { "catalogs" : [ { "databases" : [ { "name" : "db1", "tables" : [ { "columns" : { "column_name" : [ ], "filter" : "string" }, "name" : "tb1" } ], "functions" : [ { "name" : "string" } ] } ], "name" : "catalog1" } ], "uris" : [ "string" ], "type" : "CATALOG" }, "effect" : true, "permissions" : [ "ALTER,DROP" ], "grant_able_permissions" : [ "ALTER,DROP" ], "conditions" : "ip=127.0.0.1", "data_filter" : "c1 < 0", "data_mask" : "show last 4", "data_mask_type" : "PARTIAL_MASK" } ``` #### 响应示例 **状态码：400** Bad Request ``` { "error_code" : "common.01000001", "error_msg" : "failed to read http request, please check your input, code: 400, reason: Type mismatch., cause: TypeMismatchException" } ``` **状态码：401** Unauthorized ``` { "error_code" : "APIG.1002", "error_msg" : "Incorrect token or token resolution failed" } ``` **状态码：403** Forbidden ``` { "error" : { "code" : "403", "message" : "X-Auth-Token is invalid in the request", "error_code" : null, "error_msg" : null, "title" : "Forbidden" }, "error_code" : "403", "error_msg" : "X-Auth-Token is invalid in the request", "title" : "Forbidden" } ``` **状态码：404** Not Found ``` { "error_code" : "common.01000001", "error_msg" : "response status exception, code: 404" } ``` **状态码：408** Request Timeout ``` { "error_code" : "common.00000408", "error_msg" : "timeout exception occurred" } ``` **状态码：500** Internal Server Error ``` { "error_code" : "common.00000500", "error_msg" : "internal error" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 201 | Created | | 400 | Bad Request | | 401 | Unauthorized | | 403 | Forbidden | | 404 | Not Found | | 408 | Request Timeout | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-lakeformation/ErrorCode.html)。