全部產品
Search

搜尋本產品

    Agentic Cloud Governance Center：EnrollAccount - 註冊帳號

    文件中心

    Agentic Cloud Governance Center：EnrollAccount - 註冊帳號

    更新時間：Apr 21, 2026

    通過帳號工廠建立一個新的資源帳號或者納管一個已有的資源帳號。

    介面說明

    通過該 API，您可以建立一個新的資源帳號或者納管一個已有的資源帳號，並在該帳號上應用帳號基準。

    註冊帳號是一個非同步過程，建立完資源帳號後，會在該帳號上實施帳號工廠基準。您可以通過 GetEnrolledAccount 查詢帳號詳情，擷取實施結果。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    governance:EnrollAccount

    create

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    AccountNamePrefix

    string

    否

    帳號名稱首碼。

    • 如果是建立資源帳號，則該參數必填。

    • 如果是註冊應用到已有帳號，則該參數不需要填寫。

    test-account
    DisplayName

    string

    否

    帳號顯示名稱。

    • 如果是建立資源帳號，則該參數必填。

    • 如果是註冊應用到已有帳號，則該參數不需要填寫。

    test-account
    FolderId

    string

    否

    父資源夾 ID。

    • 如果是建立資源帳號，該參數不填，則預設建立在 Root 資源夾下。

    • 如果是註冊應用到已有帳號，則該參數不需要填寫。

    fd-5ESoku****
    PayerAccountUid

    integer

    否

    結算帳號 ID。

    • 如果是建立資源帳號，該參數不填，則預設為自主結算。

    • 如果是註冊應用到已有帳號，則該參數不需要填寫。

    19534534552****
    AccountUid

    integer

    否

    註冊帳號 ID。

    • 如果是建立資源帳號，則該參數不需要填寫。

    • 如果是註冊應用到已有帳號，則該參數必填。

    12868156179****
    BaselineItems

    array<object>

    否

    基準項配置數組。

    如果傳遞了該參數，那麼基準項的配置將和指定帳號基準進行合并。相同的基準項將以該參數的配置為準。建議您將該參數置空，通過BaselineId參數指定帳號基準，通過現有基準將配置應用到帳號上。

    object

    否

    基準項配置。

    Config

    string

    否

    基準項配置。

    {\"Notifications\":[{\"GroupKey\":\"account_msg\",\"Contacts\":[{\"Name\":\"aa\"}],\"PmsgStatus\":1,\"EmailStatus\":1,\"SmsStatus\":1}]}
    Name

    string

    否

    基準項名稱。

    ACS-BP_ACCOUNT_FACTORY_VPC
    Skip

    boolean

    否

    是否跳過基準項。取值：

    • false：不跳過。

    • true：跳過。

    false
    Version

    string

    否

    基準項版本。

    1.0
    BaselineId

    string

    否

    基準 ID。

    置空則預設使用系統預設基準。

    afb-bp1durvn3lgqe28v****
    ResellAccountType

    string

    否

    成員的身份類型。取值：

    • resell（預設值）：分銷帳號。建立的成員將自動與您的分銷商建立分銷關係，同時您需要使用管理帳號為新成員付款。

    • non_resell：非分銷帳號。建立的成員為阿里雲普通帳號，與您當前的分銷商無關聯關係，該帳號直接從阿里雲購買資源，需自主付款。

    說明

    該參數僅支援國際站分銷客戶。

    resell
    RegionId

    string

    否

    地區 ID。

    cn-hangzhou
    Tag

    array<object>

    否

    標籤列表，最多包含 20 個子項。

    object

    否

    標籤列表。

    Key

    string

    否

    標籤鍵。

    tagKey
    Value

    string

    否

    標籤值。

    tagValue

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回參數。

    AccountUid

    integer

    註冊帳號 ID。

    143165363236****
    RequestId

    string

    請求 ID。

    7071E5FA-515E-5F53-B335-B87D619C6A66

    樣本

    正常返回樣本

    JSON格式

    {
  "AccountUid": 0,
  "RequestId": "7071E5FA-515E-5F53-B335-B87D619C6A66"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 InvalidParameter The specified parameter %s is not valid. 您的請求中存在參數缺失或者參數無效。
    400 DeployConflict.Blueprint The %s blueprint is being deployed. Please wait for its deployment to complete and try again. 您有正在實施的藍圖，請等待其實施完成後重試。
    400 DependencyViolation.Blueprint The %s blueprint has not been deployed. Please deploy the resource structure first. 您還沒有實施相關依賴的藍圖，請先完成依賴藍圖的實施。
    400 DependencyViolation.BaselineItem The dependency of %s baseline item has not been configured. Please config %s first. 您還沒有配置相關依賴的基準項，請先完成依賴基準項的配置。
    400 IncorrectBlueprintStatus The current status of the blueprint does not support this operation. 藍圖目前狀態不支援該操作，請稍後重試。
    500 InternalError A system error occurred. 系統錯誤。
    403 InvalidUser.NotResourceDirectoryMaster The specified account is not a master account of resource directory. 當前帳號必須是資來源目錄的管理帳號。
    404 InvalidUser.NotFound The specified user does not exist. 使用者不存在。
    404 InvalidBlueprint.NotFound The specified blueprint does not exist. 藍圖執行個體不存在。
    404 InvalidBaselineItem.NotFound The specified baseline item named %s does not exist. 指定的基準項不存在。
    404 InvalidEnterpriseRealName.NotFound The specified account has not passed enterprise real name verification. Please complete the verification for the account first. 當前帳號未進行企業實名認證，請您先完成企業實名認證。

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

    變更歷史

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