全部產品
Search

搜尋本產品

    Quick BI：QueryUserInfoByAccount - 根據帳號查詢使用者資訊

    文件中心

    Quick BI：QueryUserInfoByAccount - 根據帳號查詢使用者資訊

    更新時間：Apr 20, 2026

    根據阿里雲ID或阿里雲賬戶名查詢使用者資訊。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    quickbi-public:QueryUserInfoByAccount

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Account

    string

    是

    輸入待查詢的阿里雲帳號名或阿里雲 ID。

    • 當輸入帳號名時：

      • 如果組織使用者是主帳號（例如 main_account），則查詢帳號格式為主帳號。即，要輸入的主帳號 main_account。

      • 如果組織使用者是子帳號（例如 zhangsan@test.onaliyun.com），則查詢帳號格式為子帳號的頭部，即，要輸入的子帳號為 zhangsan。

    • 當輸入阿里雲 ID 時：

      • 輸入完整的帳號 UID，即可查詢到對應的帳號資訊。

    1386587****@163.com
    ParentAccountName

    string

    否

    當查詢子帳號出現重複報錯時，輸入主帳號的帳號名， 例如 zhangsan@test.onaliyun.com。

    zhangsan@test.onaliyun.com

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    D787E1A3-A93C-424A-B626-C2B05DF8D885
    Result

    object

    返回的組織使用者資訊。

    AccountId

    string

    阿里雲帳號 ID。非 Ram 自助讀取添加的使用者，需要登入後才能擷取到阿里雲 ID。

    135****5848
    AccountName

    string

    阿里雲帳號名稱。（子帳號會去除@後面的網域名稱資訊，例如 test@test.com，會返回 test）

    1386587****@163.com
    AdminUser

    boolean

    是否綁定了組織管理員角色。取值範圍：

    • true：是

    • false：否

    重要 參數已到期不推薦使用，以 RoleIdList 參數為準

    true
    AuthAdminUser

    boolean

    是否綁定了許可權管理員角色。取值範圍：

    • true：是

    • false：否

    重要 參數已到期不推薦使用，以 RoleIdList 參數為準

    true
    Email

    string

    郵箱。

    1386587****@163.com
    NickName

    string

    暱稱。

    測試使用者
    Phone

    string

    手機號碼。

    1386587****
    RoleIdList

    array

    使用者綁定的組織角色 ID 列表。

    integer

    組織角色 ID，最多 3 個，包括但不限於組織預置角色：

    • 組織管理員（預置角色）：111111111

    • 許可權管理員（預置角色）：111111112

    • 普通使用者（預置角色）：111111113

    111111111
    UserId

    string

    Quick BI 中的 UserID。

    fe67f61a35a94b7da1a34ba174a7****
    UserType

    integer

    組織成員的使用者類型。取值範圍：

    • 1 ：開發人員

    • 2 ：訪問者

    • 3 ：分析師

    1
    CopilotModules

    array

    所擁有配額的智能化模組

    string

    所擁有配額的智能化模組。

    • qreport --小 Q 報告

    • qExploreNum -- 小 Q 探索版

    • smartQAskNum -- 小 Q 問數

    • smartQDevNum -- 小 Q 搭建

    qreport
    Success

    boolean

    是否請求成功。取值範圍：

    • true：請求成功

    • false：請求失敗

    true

    樣本

    正常返回樣本

    JSON格式

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

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 User.Duplicative Duplicate users found with account name : %s. 查詢到重複的使用者，帳號名為：%s，。

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

    變更歷史

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