更新时间:2024-05-27 GMT+08:00

查询委托的权限列表

功能介绍

根据源库类型,目标库类型,是否自建,获取委托所需要的权限

URI

GET /v5/{project_id}/agency/permissions

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户在某一Region下的Project ID。

获取方法请参见获取项目ID

表2 Query参数

参数

是否必选

参数类型

描述

source_type

String

源库类型。

  • mysql:MySQL
  • sqlserver:Microsoft SQL Server
  • postgresql:PostgreSQL
  • mongodb:MongoDB、DDS
  • dws:GaussDB(DWS)
  • oracle:Oracle
  • taurus:GaussDB(for MySQL)
  • ddm:DDM
  • kafka:Kafka
  • gaussdbv5:GaussDB分布式版
  • gaussdbv5ha:GaussDB主备版
  • gaussmongodb:GeminiDB Mongo
  • elasticsearch:CSS/ES
  • db2:DB2
  • tidb:TiDB
  • redis:Redis
  • rediscluster:Redis集群
  • gaussredis:GeminiDB Redis
  • mariadb:MariaDB
  • informix:Informix
  • dynamo:Dynamo

target_type

String

目标库类型。

  • mysql:MySQL
  • sqlserver:Microsoft SQL Server
  • postgresql:PostgreSQL
  • mongodb:MongoDB、DDS
  • dws:GaussDB(DWS)
  • oracle:Oracle
  • taurus:GaussDB(for MySQL)
  • ddm:DDM
  • kafka:Kafka
  • gaussdbv5:GaussDB分布式版
  • gaussdbv5ha:GaussDB主备版
  • gaussmongodb:GeminiDB Mongo
  • elasticsearch:CSS/ES
  • db2:DB2
  • tidb:TiDB
  • redis:Redis
  • rediscluster:Redis集群
  • gaussredis:GeminiDB Redis
  • mariadb:MariaDB
  • informix:Informix
  • dynamo:Dynamo

is_non_dbs

Boolean

是否自建。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

发送的实体的MIME类型。推荐用户默认使用application/json,如果API是对象、镜像上传等接口,媒体类型可按照流类型的不同进行确定。

缺省值:application/json

X-Auth-Token

String

从IAM服务获取的用户Token。

用户Token也就是调用获取用户Token接口的响应值,该接口是唯一不需要认证的接口。

请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

X-Language

String

请求语言类型。

缺省值:en-us

枚举值:

  • en-us
  • zh-cn

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

common_permissions

Array of strings

  • DRS FullAccess:数据复制服务所有权限

engine_permissions

Array of strings

  • GaussDB ReadOnlyAccess:云数据库 GaussDB服务的只读访问权限。
  • GeminiDB ReadOnlyAccess:分布式多模NoSQL数据库服务只读权限。
  • GaussDBforMSQLReadOnlyAccess:云数据库HUAWEIGaussDBforMSQL服务的只读访问权限。
  • DWS ReadOnlyAccess:数据仓库服务只读权限。
  • DDM ReadOnlyAccess:分布式数据库中间件服务只读权限。
  • DDS ReadOnlyPolicy:文档数据库服务资源只读权限。
  • RDS ReadOnlyAccess:关系型数据库服务资源只读权限。
  • MRS ReadOnlyAccess:MapReduce服务只读权限,包括集群查询操作、基础服务弹性云服务器、裸金属服务器、云硬盘、虚拟私有云只读权限。

请求示例

根据源库类型,目标库类型,是否自建,获取委托所需要的权限

https://{endpoint}/v5/054ba152d480d55b2f5dc0069e7ddef0/agency/permissions?source_type=mysql&target_type=taurus&non_dbs=false

响应示例

状态码: 200

{
"common_permissions": [
    "DRS FullAccess",
  ],
  "engine_permissions": [
    "RDS ReadOnlyAccess",
    "GaussDBforMSQLReadOnlyAccess"
  ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码