All Products
Search

This Product

    Virtual Private Cloud:AddIpamMembers

    Document Center

    Virtual Private Cloud:AddIpamMembers

    Last Updated:Dec 23, 2025

    Menambahkan anggota ke layanan tepercaya IPAM.

    Deskripsi operasi

    • Hanya administrator yang didelegasikan dari instans IPAM dalam direktori sumber daya yang dapat melakukan manajemen multi-akun.

    • Administrator yang didelegasikan IPAM hanya dapat menggunakan instans IPAM di satu wilayah untuk manajemen multi-akun. Maksimal 1.000 akun anggota dapat ditambahkan.
      Penting Jika Anda menambahkan folder sebagai anggota, sistem akan menghitung semua akun anggota dari direktori sumber daya yang berada dalam folder tersebut.
    • Anggota dapat berupa tipe Folder atau Account.

      • Folder: Administrator yang didelegasikan IPAM dapat melihat Penggunaan alamat IP dari semua akun anggota direktori sumber daya dalam folder tersebut. Penggunaan tersebut dilihat di wilayah tempat instans IPAM ditempatkan.

      • Account: Administrator yang didelegasikan IPAM dapat melihat Penggunaan alamat IP dari akun anggota tertentu dalam direktori sumber daya. Penggunaan tersebut dilihat di wilayah tempat instans IPAM ditempatkan.

    • Anggota yang dikelola tidak dapat membagikan resource discovery-nya kepada administrator yang didelegasikan IPAM. Administrator yang didelegasikan IPAM tidak dapat menambahkan anggota jika anggota tersebut telah membagikan resource discovery-nya.

    • Penambahan anggota pertama akan mengaktifkan layanan tepercaya IPAM untuk direktori sumber daya.

    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 yang dikelola IPAM.

    Anda dapat memanggil operasi DescribeRegions untuk mendapatkan ID wilayah.

    cn-hangzhou
    DryRun

    boolean

    No

    Menentukan apakah akan melakukan dry run. Nilai yang valid:

    • true: Melakukan dry run. Permintaan diperiksa terhadap parameter yang diperlukan, 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 normal. Jika permintaan lolos 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

    ID anggota.

    • Folder ID: ID folder.

    • Account UID: UID akun anggota dalam direktori sumber daya.

    fd-ccccncASqa
    MemberType

    string

    No

    Tipe anggota. Nilai yang valid:

    • Folder: Folder.

    • Account: Akun anggota dalam direktori sumber daya.

    Valid values:

    • Account :

      Akun anggota dalam direktori sumber daya

    • Folder :

      Folder dalam direktori sumber daya

    Folder

    Elemen respons

    Element

    Type

    Description

    Example

    object

    BaseResult

    RequestId

    string

    ID permintaan.

    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.