All Products
Search
Document Center

Quick BI:QueryUserInfoByAccount

Last Updated:Jun 11, 2026

Membuat kelompok pengguna. Anda dapat menentukan kelompok pengguna induk.

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

quickbi-public:QueryUserInfoByAccount

get

*全部资源

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

Account

string

Yes

ID unik kelompok pengguna.

  • Jika Anda tidak menentukan parameter UserGroupId, sistem akan membuat ID kelompok pengguna secara otomatis. Jika Anda menentukan parameter UserGroupId, nilai yang ditentukan akan digunakan sebagai ID kelompok pengguna. Anda harus memastikan bahwa ID tersebut unik dalam organisasi.

  • Verifikasi format: panjang maksimum 64 karakter. Nilai tidak boleh -1.

1386587****@163.com

ParentAccountName

string

No

Nama kelompok pengguna.

  • Verifikasi format: panjang maksimum 255 karakter.

  • Verifikasi format khusus: karakter Tionghoa, huruf Inggris, angka, _ \ / | () ] [.

zhangsan@test.onaliyun.com

Elemen respons

Element

Type

Description

Example

object

RequestId

string

The ID of the request.

D787E1A3-A93C-424A-B626-C2B05DF8D885

Result

object

The ID of the added user group is returned. An empty string '' is returned if the add fails.

AccountId

string

The ID of the Alibaba Cloud account.

135****5848

AccountName

string

The name of the Alibaba Cloud account that corresponds to the member. (If you use a RAM user, the domain name information that follows @ is removed. For example, if you use a test@test.com, test is returned.)

1386587****@163.com

AdminUser

boolean

Whether you are an administrator of the organization. Valid values:

  • true

  • false

true

AuthAdminUser

boolean

Whether you are a permission administrator. Valid values:

  • true

  • false

true

Email

string

The email address of the user.

1386587****@163.com

NickName

string

The nickname of the account.

测试用户

Phone

string

The phone number of the alert contact.

1386587****

RoleIdList

array

List of organization role IDs bound to the user.

integer

Organization role IDs, up to 3, including but not limited to the pre-defined organization roles:

  • Organization Administrator (pre-defined role): 111111111 - Permission Administrator (pre-defined role): 111111112 - Regular User (pre-defined role): 111111113

111111111

UserId

string

The UserID in the Quick BI.

fe67f61a35a94b7da1a34ba174a7****

UserType

integer

The role type of the organization member. Valid values:

  • 1 : developer

  • 2 : visitors

  • 3 : Analyst

1

CopilotModules

array

string

qreport

Success

boolean

Indicates whether the request is successful. Valid values:

  • true: The request was successful.

  • false: The request failed.

true

Contoh

Respons sukses

JSONformat

{
  "RequestId": "D787E1A3-A93C-424A-B626-C2B05DF8D885",
  "Result": {
    "AccountId": "135****5848",
    "AccountName": "1386587****@163.com",
    "AdminUser": true,
    "AuthAdminUser": true,
    "Email": "1386587****@163.com",
    "NickName": "测试用户",
    "Phone": "1386587****",
    "RoleIdList": [
      111111111
    ],
    "UserId": "fe67f61a35a94b7da1a34ba174a7****",
    "UserType": 1,
    "CopilotModules": [
      "qreport"
    ]
  },
  "Success": true
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 User.Duplicative Duplicate users found with account name : %s.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.