全部產品
Search
文件中心

Data Management:ListUserPermissions - 查詢指定使用者擁有的庫表許可權

更新時間:Mar 21, 2026

調用ListUserPermissions展示指定使用者所具備的庫表許可權。

調試

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

調試

授權資訊

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

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

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

dms:ListUserPermissions

list

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

Tid

integer

租戶 ID。

說明

滑鼠移動到介面右上方的頭像處,查看租戶 ID。具體操作,請參見查看租戶資訊

3***

PermType

string

資源權限類別型,取值如下:

  • DATABASE: 庫許可權

  • TABLE:表許可權

  • COLUMN:列許可權

  • INSTANCE: 執行個體許可權

DATABASE

UserId

string

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

說明

使用者識別碼 不是使用者的阿里雲 Uid。

51****

DatabaseName

string

資料庫名。

db_name

SearchKey

string

搜尋關鍵詞。例如,搜尋執行個體許可權,此處可填入 DMS 中的執行個體地址,如:rm-bp144d5ky4l4r****。

rm-bp144d5ky4l4r****

Logic

boolean

是否邏輯庫,取值:

  • true:邏輯庫

  • false:物理庫

false

EnvType

string

環境類型,取值如下:

  • product:生產環境

  • dev:開發環境

  • pre:預發環境

  • test:測試環境

  • sit:SIT 環境

  • uat:UAT 環境

  • pet:壓測環境

  • stag:STAG 環境

dev

DbType

string

資料庫類型,取值請參見 DbType 參數說明

polardb

PageNumber

integer

第幾頁。

1

PageSize

integer

每頁資料量。

5

返回參數

名稱

類型

描述

樣本值

object

TotalCount

integer

滿足條件記錄總數。

1

RequestId

string

請求 ID。

C51420E3-144A-4A94-B473-8662FCF4AD10

ErrorCode

string

錯誤碼。

UnknownError

ErrorMessage

string

錯誤資訊。

UnknownError

UserPermissions

object

UserPermission

array<object>

使用者權限資訊列表。

array<object>

DbId

string

庫 ID。

1860****

TableName

string

表名。

test_table

UserId

string

使用者識別碼。

51****

SchemaName

string

資料庫名。

test_db

Logic

boolean

是否邏輯庫,取值:

  • true:邏輯庫

  • false:物理庫

false

UserNickName

string

使用者名稱。

nick_name

InstanceId

string

執行個體 ID。

174****

PermDetails

object

PermDetail

array<object>

許可權詳情。

object

許可權詳情

OriginFrom

string

許可權授予來源資訊。

xxx授權

PermType

string

權限類別型,傳回值如下:

  • QUERY:查詢

  • EXPORT:匯出

  • CORRECT:變更

QUERY

ExpireDate

string

授權到期時間。

2020-12-12 00:00:00

CreateDate

string

許可權授予時間。

2019-12-12 00:00:00

UserAccessId

string

授權記錄 ID。

758****

ExtraData

string

額外資料,預留參數。

xxx

EnvType

string

資料庫所屬環境類型,傳回值如下:

  • product:生產環境

  • dev:開發環境

  • pre:預發環境

  • test:測試環境

  • sit:SIT 環境

  • uat:UAT 環境

  • pet:壓測環境

  • stag:STAG 環境

dev

ColumnName

string

欄位名。

column_name

DbType

string

資料庫類型,傳回值請參見 DbType 參數說明

polardb

DsType

string

權限類別型,取值如下:

  • DATABASE: 物理庫許可權

  • LOGIC_DATABASE:邏輯庫許可權

  • TABLE:物理表許可權

  • LOGIC_TABLE:邏輯表許可權

DATABASE

TableId

string

表 ID。

13434

SearchName

string

庫搜尋名。

test_db@xxx:3306

Alias

string

執行個體別名。

instance_alias

Host

string

執行個體地址。

rm-bp144d5ky4l4r****

Port

integer

執行個體連接埠。

3306

Success

boolean

請求是否成功,傳回值如下:

  • true:請求成功

  • false:請求失敗

true

樣本

正常返回樣本

JSON格式

{
  "TotalCount": 1,
  "RequestId": "C51420E3-144A-4A94-B473-8662FCF4AD10",
  "ErrorCode": "UnknownError",
  "ErrorMessage": "UnknownError",
  "UserPermissions": {
    "UserPermission": [
      {
        "DbId": "1860****",
        "TableName": "test_table",
        "UserId": "51****",
        "SchemaName": "test_db",
        "Logic": false,
        "UserNickName": "nick_name",
        "InstanceId": "174****",
        "PermDetails": {
          "PermDetail": [
            {
              "OriginFrom": "xxx授權",
              "PermType": "QUERY",
              "ExpireDate": "2020-12-12 00:00:00",
              "CreateDate": "2019-12-12 00:00:00",
              "UserAccessId": "758****",
              "ExtraData": "xxx"
            }
          ]
        },
        "EnvType": "dev",
        "ColumnName": "column_name",
        "DbType": "polardb",
        "DsType": "DATABASE",
        "TableId": "13434",
        "SearchName": "test_db@xxx:3306",
        "Alias": "instance_alias",
        "Host": "rm-bp144d5ky4l4r****",
        "Port": 3306
      }
    ]
  },
  "Success": true
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情