全部產品
Search

搜尋本產品

    Data Management：ListAuthorizedDatabasesForUser - 擷取使用者有許可權的資料庫列表

    文件中心

    Data Management：ListAuthorizedDatabasesForUser - 擷取使用者有許可權的資料庫列表

    更新時間：Mar 21, 2026

    調用此API可以擷取使用者有許可權的資料庫列表。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    dms:ListAuthorizedDatabasesForUser

    none

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    UserId

    string

    是

    使用者識別碼。您可通過調用 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

    使用者識別碼。

    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"
      }
    }
  ]
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。