全部產品
Search

搜尋本產品

    Identity as a Service：CreateUser - 建立一個EIAM賬戶

    文件中心

    Identity as a Service：CreateUser - 建立一個EIAM賬戶

    更新時間：Dec 24, 2025

    在指定EIAM執行個體下建立一個EIAM賬戶

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    eiam:CreateUser

    create

    *User

    acs:eiam:{#regionId}:{#accountId}:instance/{#InstanceId}/user/*

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    InstanceId

    string

    是

    執行個體 ID。

    idaas_ue2jvisn35ea5lmthk267xxxxx
    Username

    string

    是

    賬戶名稱，可包含英文字母、數字、符號“_” 、“ .”、“@”、“-”，長度最大限制 128 字元。

    user_001
    DisplayName

    string

    否

    賬戶展示名稱，長度最大限制 128 字元。

    name_001
    Password

    string

    否

    密碼，具體格式要求參考密碼原則。

    123456
    PhoneRegion

    string

    否

    手機區號，格式為 1～6 位元字，不含"+"。

    86
    PhoneNumber

    string

    否

    手機號，格式為 6～15 位元字。

    12345678901
    PhoneNumberVerified

    boolean

    否

    手機號是否驗證，為可信手機號，手機號若設定此欄位必須設定，無特殊業務可直接設定為 true。

    true
    Email

    string

    否

    郵箱，郵箱首碼可包含大寫英文字母、小寫英文字母、數字、點、底線或中劃線，長度限制最長為 128 字元。

    example@example.com
    EmailVerified

    boolean

    否

    郵箱是否已驗證，為可信郵箱，郵箱若設定此欄位必須設定，無特殊業務可直接設定為 true。

    true
    UserExternalId

    string

    否

    賬戶外部 ID，用於與外部系統的關聯，最大長度限制 128 字元，若不設定，預設設定為賬戶 ID。

    user_d6sbsuumeta4h66ec3il7yxxxx
    PrimaryOrganizationalUnitId

    string

    是

    主組織 ID。

    ou_wovwffm62xifdziem7an7xxxxx
    OrganizationalUnitIds

    array

    否

    從屬組織 ID 列表，賬戶可從屬於多個組織。

    string

    否

    組織 ID。

    ou_adz2vmgiwpo4tu6jtss3mynjji
    Description

    string

    否

    描述，最大長度限制 256 字元。

    description text
    CustomFields

    array<object>

    否

    擴充欄位列表。

    description

    object

    否

    擴充欄位對象。

    FieldName

    string

    否

    擴充欄位標識，需提前建立相關擴充欄位，參考控制台擴充欄位模組。

    age
    FieldValue

    string

    否

    擴充欄位值，該值遵循對應擴充欄位的相關屬性限制。

    10
    PasswordInitializationConfig

    object

    否

    密碼初始化配置。

    PasswordInitializationPolicyPriority

    string

    否

    密碼初始化策略優先順序，預設不生效，取值可選範圍：

    • global：全域優先，採用執行個體層級的密碼初始化策略，即本次設定的密碼初始化策略均無效，參考密碼相關策略的密碼初始化策略。

    • custom：自訂優先，以當前定義的密碼初始化策略為準，包括是否開啟強制改密、密碼初始化方式以及通知渠道。

    global
    PasswordForcedUpdateStatus

    string

    否

    強制修改密碼狀態，預設不啟用，取值可選範圍：

    • enabled：開啟。

    • disabled：禁用。

    enabled
    UserNotificationChannels

    array

    否

    密碼通知渠道列表。

    sms

    string

    否

    密碼通知渠道，取值可選範圍：

    • email：郵件。

    • sms：簡訊。

    sms
    PasswordInitializationType

    string

    否

    密碼初始化方式，取值可選範圍：

    • random：隨機。

    random
    ClientToken

    string

    否

    保證請求等冪性。從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元，且不能超過 64 個字元。更多資訊，請參考文檔《如何保證等冪性》。

    client-token-example

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    0441BD79-92F3-53AA-8657-F8CE4A2B912A
    UserId

    string

    賬戶 ID。

    user_d6sbsuumeta4h66ec3il7yxxxx

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "0441BD79-92F3-53AA-8657-F8CE4A2B912A",
  "UserId": "user_d6sbsuumeta4h66ec3il7yxxxx"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    403 ResourceDuplicated.Username The specified resource: Username already exist. 使用者名稱已重複

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

    變更歷史

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