ListAuthorizedDatabasesForUser - 获取用户有权限的数据库列表 - 数据管理 DMS

调用此API可以获取用户有权限的数据库列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

dms:ListAuthorizedDatabasesForUser

none

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
UserId	string	是	用户 ID。您可通过调用 GetUser 接口获取该参数的值。	51****
EnvType	string	否	环境类型，取值如下： product：生产环境。 dev：开发环境。 pre：预发环境。 test：测试环境。 sit：SIT 环境。 uat：UAT 环境。 pet：压测环境。 stag：STAG 环境。	product
DbType	string	否	数据库类型，取值为： MySQL SQLServer PostgreSQL Oracle DRDS OceanBase Mongo Redis	MySQL
Logic	boolean	否	是否为逻辑库，取值： true：逻辑库。 false：物理库。	false
SearchKey	string	否	搜索关键字。	policy_test
PageNumber	string	否	第几页。	1
PageSize	string	否	每页数据量。	20
Tid	integer	否	租户的 ID。	3***

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。用于定位日志，排查问题。	012AE0B5-4B52-532F-BD7C-1EE9F182089B
Databases	array<object>	有权限的数据库列表。
	array<object>	数据库。
DbId	string	数据库 ID。	254****
SchemaName	string	数据库名称。	poc_testdb
SearchName	string	数据库搜索名称。	poc
InstanceId	string	实例 ID。	235****
Logic	boolean	是否为逻辑库，取值如下： true：逻辑库。 false：物理库。	false
DbType	string	数据库类型。	MYSQL
UserId	string	用户 ID。	51****
EnvType	string	数据库环境类型。	product
PermissionDetail	object	权限详情。根据权限来源不同，权限详情格式有所不同。下面以权限来源为普通权限为示例。
DsType	string	操作对象类型。	DATABASE
PermType	string	权限类型，取值如下： QUERY：查询。 EXPORT：导出。 CORRECT：变更。	CORRECT
ExpireDate	string	权限到期时间。	2024-12-06 10:00:00
Message	string	如果权限来源为权限策略，该字段会包括权限策略的名称以及允许用户进行的操作信息。	权限策略通过，策略名：INSTANCE_OWNER，被允许的操作：instance:InstanceQuery

示例

正常返回示例

JSON格式

{
  "RequestId": "012AE0B5-4B52-532F-BD7C-1EE9F182089B",
  "Databases": [
    {
      "DbId": "254****",
      "SchemaName": "poc_testdb",
      "SearchName": "poc",
      "InstanceId": "235****",
      "Logic": false,
      "DbType": "MYSQL",
      "UserId": "51****",
      "EnvType": "product",
      "PermissionDetail": {
        "DsType": "DATABASE",
        "PermType": "CORRECT",
        "ExpireDate": "2024-12-06 10:00:00",
        "Message": "权限策略通过，策略名：INSTANCE_OWNER，被允许的操作：instance:InstanceQuery"
      }
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。