All Products
Search
Document Center

Virtual Private Cloud:AddIpamMembers

Last Updated:Jun 10, 2026

Menambahkan anggota ke IP Address Manager (IPAM).

Deskripsi operasi

  • Only the delegated administrator of an IPAM instance in a resource directory can perform multi-account management.

  • An IPAM delegated administrator can use an IPAM instance in only one region for multi-account management. A maximum of 1,000 member accounts can be added.

    Penting

    If you add a folder as a member, the system counts all member accounts of the resource directory that are in the folder.

  • Members can be of the Folder or Account type.

    • Folder: The delegated IPAM administrator can view IP usage in the IPAM effective region for all resource directory member accounts in the folder.

    • Account: The delegated IPAM administrator can view IP usage in the IPAM effective region for the specified resource directory member account.

  • A managed member cannot share its resource discovery with the IPAM delegated administrator. The IPAM delegated administrator cannot add a member if that member has already shared its resource discovery.

  • Adding the first member enables the IPAM trusted service for the resource directory.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Sintaks permintaan

POST  HTTP/1.1

Parameter permintaan

Parameter

Type

Required

Description

Example

RegionId

string

Yes

ID wilayah tempat IPAM dihosting.

Panggil operasi DescribeRegions untuk mendapatkan ID wilayah.

cn-hangzhou

DryRun

boolean

No

Apakah akan menjalankan dry run. Nilai valid:

  • true: Menjalankan dry run. Permintaan diperiksa untuk parameter wajib, format permintaan, dan batas layanan. Anggota tidak ditambahkan ke layanan tepercaya IPAM. Jika pemeriksaan berhasil, kode kesalahan DryRunOperation dikembalikan. Jika pemeriksaan gagal, kesalahan dikembalikan.

  • false (Default): Mengirim permintaan. Jika permintaan lulus pemeriksaan, anggota ditambahkan ke layanan tepercaya IPAM dan kode status HTTP 2xx dikembalikan.

false

ClientToken

string

No

Token klien untuk memastikan idempotensi permintaan.

Buat nilai unik dari klien Anda untuk setiap permintaan. Parameter ClientToken hanya mendukung karakter ASCII.

Catatan

Jika Anda tidak menentukan parameter ini, sistem menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan API.

123e4567-e89b-12d3-a456-426655440000

Members

array<object>

Yes

Anggota yang dikelola oleh layanan tepercaya IPAM.

object

No

MemberId

string

No

The member ID.

  • Folder ID: The ID of the folder.

  • Account UID: The UID of a member account in the resource directory.

fd-ccccncASqa

MemberType

string

No

The member type. Valid values:

  • Folder: A folder.

  • Account: A member account in a resource directory.

Valid values:

  • Account :

    A member account in a resource directory

  • Folder :

    A folder in a resource directory

Folder

Elemen respons

Element

Type

Description

Example

object

BaseResult

RequestId

string

The request ID.

BB2C39DE-CEB8-595A-981A-F2EFCBE7324E

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code

Error code

Error message

Description

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.
400 OperationDenied.MemberExistInIpamRDService The operation is not allowed because %s is under the management of the IPAM.
400 QuotaExceeded.MemberAccount The operation is not allowed because the number of % managed by IPAM has exceeded the limit, %s/%s.
400 OperationDenied.IpamResourceDiscoveryAlreadySharedWithAdmin The operation is not allowed because the resource discovery has been shared with the IPAM delegated administrator by %s.
400 OperationDenied.IpamRDServiceAlreadyEnabledInOtherRegion The operation is not allowed because the IPAM Resource Directory service is already enabled in another region.
400 OperationDenied.AccountNotRDEntity The operation is not allowed because the caller does not belong to the resource directory.
400 OperationDenied.NotDelegatedAdminAccount The operation is not allowed because the caller is not the delegated IPAM admin for the resource directory.
400 OperationDenied.IpamNotExist The operation is not allowed because the IPAM does not exist.
400 OperationDenied.DelegateAdminAsMember The operation is not allowed because the IPAM delegate administrator cannot be a member.
400 OperationDenied.NoServicePrincipalAdminPrivileges The operation is not allowed because the caller is not the delegated IPAM admin for the resource directory.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.