All Products
Search
Document Center

Data Management:ListUserPermissions

Last Updated:Jun 11, 2026

Memanggil ListUserPermissions untuk menampilkan izin database dan tabel dari pengguna yang ditentukan.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

dms:ListUserPermissions

list

*全部资源

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

Tid

integer

No

ID penyewa.

Catatan

Arahkan pointer ke foto profil di sudut kanan atas konsol untuk melihat ID penyewa. Untuk informasi selengkapnya, lihat Melihat informasi tentang penyewa.

3***

PermType

string

Yes

Tipe izin sumber daya. Nilai yang valid:

  • DATABASE: izin database

  • TABLE: izin tabel

  • COLUMN: izin kolom

  • INSTANCE: izin instans

DATABASE

UserId

string

Yes

ID pengguna. Anda dapat memanggil operasi GetUser atau ListUsers untuk mendapatkan nilai parameter ini.

Catatan

ID pengguna bukan UID Alibaba Cloud dari pengguna.

51****

DatabaseName

string

No

Nama database.

db_name

SearchKey

string

No

Kata kunci yang digunakan untuk melakukan pencarian. Misalnya, ketika Anda mencari izin instans, Anda dapat memasukkan alamat instans di DMS, seperti rm-bp144d5ky4l4r****.

rm-bp144d5ky4l4r****

Logic

boolean

No

Menentukan apakah database adalah database logis. Nilai yang valid:

  • true: database logis

  • false: database fisik

false

EnvType

string

No

Tipe lingkungan tempat database berada. Nilai yang valid:

  • product: lingkungan produksi

  • dev: lingkungan pengembangan

  • pre: lingkungan pra-rilis

  • test: lingkungan pengujian

  • sit: lingkungan SIT

  • uat: lingkungan UAT

  • pet: lingkungan pengujian beban

  • stag: lingkungan STAG

dev

DbType

string

No

Tipe database. Untuk informasi selengkapnya tentang nilai yang valid, lihat Parameter DbType.

polardb

PageNumber

integer

No

Nomor halaman yang akan dikembalikan.

1

PageSize

integer

No

Jumlah entri yang akan dikembalikan pada setiap halaman.

5

Elemen respons

Element

Type

Description

Example

object

TotalCount

integer

Jumlah total entri yang dikembalikan.

1

RequestId

string

ID permintaan.

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

ErrorCode

string

Kode kesalahan.

UnknownError

ErrorMessage

string

Pesan kesalahan.

UnknownError

UserPermissions

object

UserPermission

array<object>

Daftar informasi izin pengguna.

array<object>

DbId

string

The ID of the database.

1860****

TableName

string

The name of the table.

test_table

UserId

string

The ID of the user.

51****

SchemaName

string

The name of the database.

test_db

Logic

boolean

Indicates whether the database is a logical database. Valid values:

  • true: The database is a logical database.

  • false: The database is a physical database.

false

UserNickName

string

The nickname of the user.

nick_name

InstanceId

string

The ID of the instance.

174****

PermDetails

object

PermDetail

array<object>

The details of permissions.

object

OriginFrom

string

The user who grants the permissions.

xxx授权

PermType

string

The type of the permissions. Valid values:

  • QUERY: the query permissions

  • EXPORT: the export permissions

  • CORRECT: the change permissions

QUERY

ExpireDate

string

The time when the permissions expire.

2020-12-12 00:00:00

CreateDate

string

The time when the permissions were granted.

2019-12-12 00:00:00

UserAccessId

string

The ID of the authorization record.

758****

ExtraData

string

This parameter is reserved.

xxx

EnvType

string

The type of the environment to which the database belongs. Valid values:

  • product: production environment

  • dev: development environment

  • pre: staging environment

  • test: test environment

  • sit: SIT environment

  • uat: UAT environment

  • pet: stress testing environment

  • stag: STAG environment

dev

ColumnName

string

The name of the field.

column_name

DbType

string

The type of the database. For more information about the valid values of this parameter, see DbType parameter.

polardb

DsType

string

The permissions on a specific type of objects that are granted to the user. Valid values:

  • DATABASE: permissions on physical databases

  • LOGIC_DATABASE: permissions on logical databases

  • TABLE: permissions on physical tables

  • LOGIC_TABLE: permissions on logical tables

DATABASE

TableId

string

The ID of the table.

13434

SearchName

string

The name that is used to search for the database.

test_db@xxx:3306

Alias

string

The alias of the instance.

instance_alias

Host

string

The endpoint that is used to connect the database.

rm-bp144d5ky4l4r****

Port

integer

The port that is used to connect to the instance.

3306

Success

boolean

Menunjukkan apakah permintaan berhasil. Nilai yang valid:

  • true: Permintaan berhasil.

  • false: Permintaan gagal.

true

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.