全部產品
Search
文件中心

Virtual Private Cloud:AddIpamMembers - 添加IPAM可信服務納管成員

更新時間:Dec 23, 2025

添加IPAM可信服務納管成員。

介面說明

  • IPAM 多帳號管理僅支援資來源目錄 IPAM 委派管理員進行操作。

  • 僅允許 IPAM 委派管理員選擇一個地區的 IPAM 進行多帳號管理,支援納管的成員帳號總計不超過 1000。
    重要 當納管成員為 Folder 類型時,按 Folder 下包含的資來源目錄成員帳號計數。
  • 納管成員類型包含 Folder 和 Account
    • Folder:IPAM 委派管理員可查看 Folder 下所有資來源目錄成員帳號在 IPAM 生效地區的 IP 使用方式;

    • Account:IPAM 委派管理員可查看指定資來源目錄帳號在 IPAM 生效地區的 IP 使用方式。

  • 已納管成員不允許將資摘要搜索共用給 IPAM 委派管理員,IPAM 委派管理員也不允許納管已將資摘要搜索共用給自己的成員。

  • IPAM 委派管理員首次添加納管成員後,資來源目錄 IPAM 可信服務開啟。

調試

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

調試

授權資訊

當前API暫無授權資訊透出。

請求文法

POST  HTTP/1.1

請求參數

名稱

類型

必填

描述

樣本值

RegionId

string

IPAM 託管地區 ID。

您可以通過調用 DescribeRegions 介面擷取地區 ID。

cn-hangzhou

DryRun

boolean

是否只預檢此次請求。取值:

  • true:發送檢查請求,不會添加 IPAM 可信服務納管成員。檢查項包括是否填寫了必需參數、請求格式、業務限制。如果檢查不通過,則返回對應錯誤。如果檢查通過,則返回錯誤碼 DryRunOperation。

  • false(預設值):發送正常請求,通過檢查後返回 HTTP 2xx 狀態代碼並添加 IPAM 可信服務納管成員。

false

ClientToken

string

用戶端 Token,用於保證請求的等冪性。

從您的用戶端產生一個參數值,確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。

說明

若您未指定,則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 可能不一樣。

123e4567-e89b-12d3-a456-426655440000

Members

array<object>

IPAM 可信服務納管成員。

object

MemberId

string

成員 ID。

  • Folder ID:資源夾 ID。

  • Account UID:資來源目錄成員帳號 UID。

fd-ccccncASqa

MemberType

string

成員類型,取值:

  • Folder:資源夾。

  • Account:資來源目錄成員帳號。

枚舉值:

  • Account :

    資來源目錄成員帳號

  • Folder :

    資源夾

Folder

返回參數

名稱

類型

描述

樣本值

object

BaseResult

RequestId

string

請求 ID。

BB2C39DE-CEB8-595A-981A-F2EFCBE7324E

樣本

正常返回樣本

JSON格式

{
  "RequestId": "BB2C39DE-CEB8-595A-981A-F2EFCBE7324E"
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 OperationDenied.MemberIdNotMatchMemberType The operation is not allowed because the Member ID and Member Type of members [%s] in the input parameters do not match. 入參Members中[%s]的Member Id和Member Type不匹配。
400 OperationDenied.MemberExistInIpamRDService The operation is not allowed because %s is under the management of the IPAM. 入參中%s已經被IPAM可信服務納管,不允許重複納管相同的member。
400 QuotaExceeded.MemberAccount The operation is not allowed because the number of % managed by IPAM has exceeded the limit, %s/%s. IPAM可信服務納管的成員帳號超過Quota限制。
400 OperationDenied.IpamResourceDiscoveryAlreadySharedWithAdmin The operation is not allowed because the resource discovery has been shared with the IPAM delegated administrator by %s. IPAM可信服務不允許納管已經將自己的資摘要搜索共用給委派管理員的帳號。
400 OperationDenied.IpamRDServiceAlreadyEnabledInOtherRegion The operation is not allowed because the IPAM Resource Directory service is already enabled in another region. 只允許選擇一個地區的一個IPAM執行個體納管資來源目錄成員。
400 OperationDenied.AccountNotRDEntity The operation is not allowed because the caller does not belong to the resource directory. 調用者不屬於任何資來源目錄,不允許納管IPAM可信服務成員。
400 OperationDenied.NotDelegatedAdminAccount The operation is not allowed because the caller is not the delegated IPAM admin for the resource directory. 調用者不是所在資來源目錄的IPAM可信服務委派管理員,不允許納管IPAM可信服務成員。
400 OperationDenied.IpamNotExist The operation is not allowed because the IPAM does not exist. 當前地區IPAM不存在,不允許納管IPAM可信服務成員。
400 OperationDenied.DelegateAdminAsMember The operation is not allowed because the IPAM delegate administrator cannot be a member. IPAM委派管理員不能添加自己作為IPAM可信服務的成員。
400 OperationDenied.NoServicePrincipalAdminPrivileges The operation is not allowed because the caller is not the delegated IPAM admin for the resource directory. 調用者不是所在資來源目錄的IPAM可信服務委派管理員,不允許納管IPAM可信服務成員。

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

變更歷史

更多資訊,參考變更詳情