用于提交对特定资源的访问权限申请。
接口说明
请求说明
Reason:申请理由,必须提供。
ApplyContents:包含多个资源权限申请内容,每个内容包括资源描述(Resource)、授权主体描述(Grantee)、权限类型(AccessTypes)和权限到期时间(ExpirationTime)。单次最大限制 400 条。
Resource:资源描述,需要指定资源解析依赖的 ResourceSchema.name 和 version,以及资源元数据 MetaData。
Grantee:授权主体描述,需要指定授权主体类型(PrincipalType)和主体 ID(PrincipalId)。
AccessTypes:权限类型列表,支持多种权限组合。
ExpirationTime:权限到期时间,以毫秒时间戳形式提供。
AuthMethod:可选参数,指定授权方式,默认使用系统内置的默认授权方式。
ClientToken:客户端令牌,用于防止重复请求,非必填项。
请确保所有必填字段都已正确填写,并且符合相应的约束条件。例如,Resource中的DefVersion和MetaData应与所选DefSchema相匹配。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| Reason |
string |
是 |
申请理由 |
业务发展需要 |
| ApplyContents |
array<object> |
是 |
资源权限申请内容列表 |
|
|
array<object> |
否 |
|||
| Resource |
object |
否 |
资源描述 |
|
| DefSchema |
string |
是 |
资源类型 枚举值:
|
MaxCompute |
| DefVersion |
string |
否 |
资源解析依赖的 ResourceSchema.version |
v1.0.0 |
| MetaData |
object |
否 |
资源元数据,数据内容受 ResourceSchema 约束 |
|
|
any |
否 |
通过 Map<String,Object>格式声明具体资源,需要符合 ResourceSchema 中具体资源类型的 resource 约束。 注意:
|
{ "workspace": "449656", "project": "sync_destination", "table": "order_table", "threeTierModel": false } |
|
| Grantee |
object |
是 |
授权主体描述 |
|
| PrincipalType |
string |
是 |
授权主体类型。枚举:
枚举值:
|
RamRole |
| PrincipalId |
string |
是 |
授权主体 ID,不同主授权主体类型映射 ID 具有不同语义:
|
ROLE_32237475848545 |
| AccessTypes |
array |
是 |
申请的权限列表。 注意:不同资源层级能够支持的权限申请类型不同,统一受对应资源类型的 ResourceSchema 的约束。 |
|
|
string |
否 |
资源权限 |
select |
|
| ExpirationTime |
integer |
否 |
权限到期时间,毫秒时间戳 |
1785835708000 |
| AuthMethod |
string |
否 |
授权方式。 注意:只有 SEVERLESS_STARROCKS 支持指定授权方式:ranger、starrocksManager 枚举值:
|
ranger |
| ClientToken |
string |
否 |
幂等参数。用于避免多次调用导致操作重复。 |
ABFUOEUOTRTRJKE |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回结果。 |
||
| RequestId |
string |
请求 ID。用于定位日志,排查问题。 |
0bc5df3a17***903790e8e8a |
| Data |
array |
申请单 ID 列表。 |
|
|
string |
申请单/审批流程 ID |
332066440109224007 |
示例
正常返回示例
JSON格式
{
"RequestId": "0bc5df3a17***903790e8e8a",
"Data": [
"332066440109224007"
]
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。