全部產品
Search

搜尋本產品

    Resource Access Management：UpdateUser

    文件中心

    Resource Access Management：UpdateUser

    更新時間：Jul 31, 2026

    呼叫 UpdateUser 修改 RAM 使用者資訊。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ram:UpdateUser

    update

    *User

    acs:ram::{#accountId}:user/{#UserName}

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    UserPrincipalName

    string

    否

    指定的 RAM 使用者登入名稱。

    說明

    UserPrincipalName 與 UserId 參數，必須指定一個，但不能同時指定。

    test@example.onaliyun.com
    UserId

    string

    否

    指定的 RAM 使用者 ID。

    說明

    UserPrincipalName 與 UserId 參數，必須指定一個，但不能同時指定。

    20732900249392****
    NewUserPrincipalName

    string

    否

    RAM 使用者的新登入名稱。

    格式為 <username>@<AccountAlias>.onaliyun.com，其中 <username> 為 RAM 使用者名稱，<AccountAlias>.onaliyun.com 為預設網域。

    UserPrincipalName 長度為 1~128 個字元，可包含英文字母、數字、半形句號（.）、連字號（-）和底線（_）。其中 <username> 的長度為 1~64 個字元。

    new@example.onaliyun.com
    NewDisplayName

    string

    否

    RAM 使用者的新顯示名稱。

    長度為 1~24 個字元。

    new
    NewMobilePhone

    string

    否

    RAM 使用者的新手機號碼。

    格式：國際區號-號碼。

    說明

    該參數僅適用於中國站。

    86-1868888****
    NewEmail

    string

    否

    RAM 使用者的新電子郵箱。

    說明

    該參數僅適用於中國站。

    alice@example.com
    NewComments

    string

    否

    新備註。

    長度為 1~128 個字元。

    This is a cloud computing engineer.

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回參數。

    User

    object

    RAM 使用者資訊。

    DisplayName

    string

    RAM 使用者的顯示名稱。

    new
    UserPrincipalName

    string

    RAM 使用者的登入名稱。

    new@example.onaliyun.com
    Email

    string

    RAM 使用者的電子郵箱。

    說明

    該參數僅適用於中國站。

    alice@example.com
    UpdateDate

    string

    RAM 使用者的更新時間。

    格式：RFC 3339（UTC），例如：2020-10-13T09:19:49Z。

    2020-10-13T09:19:49Z
    MobilePhone

    string

    RAM 使用者的手機號碼。

    說明

    該參數僅適用於中國站。

    86-1868888****
    UserId

    string

    RAM 使用者 ID。

    20732900249392****
    Comments

    string

    備註。

    This is a cloud computing engineer.
    LastLoginDate

    string

    RAM 使用者最近一次登入主控台的時間。

    格式：RFC 3339（UTC），例如：2020-10-12T09:12:00Z。

    2020-10-12T09:12:00Z
    CreateDate

    string

    RAM 使用者的建立時間。

    格式：RFC 3339（UTC），例如：2020-10-12T09:12:00Z。

    2020-10-12T09:12:00Z
    ProvisionType

    string

    同步類型。取值：

    • Manual：在 RAM 中手動建立的 RAM 使用者。

    • SCIM：透過 SCIM 協定同步建立的 RAM 使用者。

    • CloudSSO：透過雲端 SSO 同步建立的使用者。

    Manual
    RequestId

    string

    請求 ID。

    1B56DD42-6962-4F89-A19C-079EED1F0FE3

    樣本

    正常返回樣本

    JSON格式

    {
  "User": {
    "DisplayName": "new",
    "UserPrincipalName": "new@example.onaliyun.com",
    "Email": "alice@example.com",
    "UpdateDate": "2020-10-13T09:19:49Z",
    "MobilePhone": "86-1868888****",
    "UserId": "20732900249392****",
    "Comments": "This is a cloud computing engineer.",
    "LastLoginDate": "2020-10-12T09:12:00Z",
    "CreateDate": "2020-10-12T09:12:00Z",
    "ProvisionType": "Manual"
  },
  "RequestId": "1B56DD42-6962-4F89-A19C-079EED1F0FE3"
}

    錯誤碼

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

    變更歷史

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