全部產品
Search

搜尋本產品

    Data Management：ListAuthorizedInstancesForUser - 擷取使用者有許可權的執行個體

    文件中心

    Data Management：ListAuthorizedInstancesForUser - 擷取使用者有許可權的執行個體

    更新時間：Mar 21, 2026

    調用此API可以擷取指定使用者有許可權的執行個體列表。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    dms:ListAuthorizedInstancesForUser

    none

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    UserId

    string

    是

    使用者識別碼。您可通過調用 GetUser 介面擷取該參數的值。

    說明

    當 IdentityType 參數的值選擇 USER 時需要填寫。

    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
    SearchKey

    string

    否

    搜尋索引鍵。

    policy_test

    PageNumber

    string

    否

    第幾頁。

    1
    PageSize

    string

    否

    每頁記錄數。

    20
    Tid

    integer

    否

    租戶的 ID。

    說明

    取自系統右上方頭像處懸停展示的租戶 ID 資訊，詳情請參見查看租戶資訊。

    3***

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    RequestId

    string

    請求 ID。用於定位日誌，排查問題。

    B7DB89CC-017D-5503-8953-38FFE241A618
    Instances

    array<object>

    有許可權的執行個體列表。

    array<object>

    執行個體列表。

    InstanceId

    string

    執行個體 ID。

    21****
    Host

    string

    執行個體串連地址。

    rm-2zex9lrc0gz0****.mysql.rds.aliyuncs.com
    Port

    string

    執行個體串連連接埠。

    3306
    DbType

    string

    資料庫類型。

    MySQL
    UserId

    string

    使用者識別碼。

    51****
    UserName

    string

    使用者名稱。

    user_test
    InstanceAlias

    string

    執行個體別名。

    DMS_TEST
    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": "B7DB89CC-017D-5503-8953-38FFE241A618",
  "Instances": [
    {
      "InstanceId": "21****",
      "Host": "rm-2zex9lrc0gz0****.mysql.rds.aliyuncs.com",
      "Port": "3306",
      "DbType": "MySQL",
      "UserId": "51****",
      "UserName": "user_test",
      "InstanceAlias": "DMS_TEST",
      "EnvType": "product",
      "PermissionDetail": {
        "DsType": "DATABASE",
        "PermType": "CORRECT",
        "ExpireDate": "2024-12-06 10:00:00\n",
        "Message": "權限原則通過，策略名稱：INSTANCE_OWNER，被允許的操作：instance:InstanceQuery"
      }
    }
  ]
}

    錯誤碼

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

    變更歷史

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