All Products
Search

This Product

    Internet Shared Bandwidth:AddCommonBandwidthPackageIps

    Document Center

    Internet Shared Bandwidth:AddCommonBandwidthPackageIps

    Last Updated:Jun 12, 2026

    Menambahkan alamat IP elastis (EIP) ke paket bandwidth EIP dengan memanggil operasi AddCommonBandwidthPackageIps.

    Deskripsi operasi

    • Saat Anda memanggil operasi ini untuk menambahkan EIP ke paket bandwidth EIP, EIP harus memenuhi persyaratan berikut:

      • EIP menggunakan metode penagihan pay-as-you-go.

      • EIP dan paket bandwidth EIP tempat EIP ditambahkan berada di region yang sama.

      • Tipe jalur EIP sama dengan tipe jalur paket bandwidth EIP tempat EIP ditambahkan.

    • AddCommonBandwidthPackageIps adalah operasi asinkron. Setelah permintaan dikirim, sistem mengembalikan ID permintaan dan menjalankan tugas di latar belakang. EIP tidak langsung ditambahkan ke paket bandwidth EIP. Anda dapat memanggil operasi DescribeCommonBandwidthPackages untuk mengkueri status asosiasi paket bandwidth EIP dan EIP.

      • Jika paket bandwidth EIP berada dalam status BINDING, EIP sedang diasosiasikan dengan paket bandwidth EIP. Dalam status ini, Anda hanya dapat mengkueri paket bandwidth EIP dan tidak dapat melakukan operasi lain.

      • Jika paket bandwidth EIP berada dalam status BINDED, EIP diasosiasikan dengan paket bandwidth EIP.

    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.

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID region paket bandwidth EIP.

    Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar region terbaru.

    cn-shanghai
    BandwidthPackageId

    string

    Yes

    ID paket bandwidth EIP.

    cbwp-2ze2ic1xd2qeqasdf****
    IpType

    string

    No

    Tipe alamat IP. Nilai yang valid: EIP, yang menunjukkan bahwa EIP ditambahkan ke paket bandwidth EIP.

    EIP
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan.

    Anda dapat menggunakan klien untuk menghasilkan nilainya, tetapi Anda harus memastikan bahwa nilai tersebut unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII.

    Catatan

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

    123e4567-e89b-12d3-a456-426655440000
    IpInstanceIds

    array

    Yes

    Daftar ID instans EIP yang akan ditambahkan.

    Anda dapat menambahkan paling banyak 10 ID instans EIP sekaligus.

    string

    No

    Daftar ID instans EIP yang akan ditambahkan.

    Anda dapat menambahkan paling banyak 10 ID instans EIP sekaligus.

    eip-2zeerraiwb7uqwed****

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Daftar parameter respons.

    RequestId

    string

    ID permintaan.

    01FDDD49-C4B7-4D2A-A8E5-A93915C450A6

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "01FDDD49-C4B7-4D2A-A8E5-A93915C450A6"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 OperationDenied.SecurityProtectionTypesInconsistent The operation is not allowed because of SecurityProtectionTypesInconsistent.
    400 InvalidIpInstanceId.NotFound The specified Eip InstanceId does not exist in our records.
    400 EIP_ALREADY_IN_BANDWIDTHPACKAGE The Eip already in bandwidthPackage.
    400 InvalidRegionId.NotFound The specified RegionId does not exist in our records.
    400 InvalidBandwidthPackageId.NotFound The specified bandwidthPackageId does not exist in our records.
    400 IpInstanceId.AlreadyInBandwidthPackage The specified Eip InstanceId already in bandwidthPackage.
    400 IpInstanceId.BizStatusInvalid The specified Eip BizStatus is Disable, Cannot add to bandwidthPackage.
    400 IpInstanceId.ChargeType.NotSupport The specified Eip instance is PrePaid type, Cannot add to BandwidthPackage.
    400 BandwidthPackageId.InvalidBizStatus The specified BandwidthPackageId has been FinancialLocked, Cannot add Ip.
    400 IpInstanceId.QuotaExceeded The specified BandwidthPackageId has too many ip in it. exceed the quota , Cannot add more.
    400 EipOperation.TooFrequently The specified Eip add into bandwidthPackage too frequently. please add later.
    400 IpInstanceId.InvalidIpInternetChargeType The hybrid type eip not support add into bandwidthPackage of PayBytraffic type.
    400 TaskConflict The operation is too frequent, TaskConflict.
    400 IncorrectStatus.Eip Eip status error.
    400 OperationUnsupported.IpType Ip type does not support the operation.
    400 ParamExclusive.IpInstanceIdAndBandwidthPackageId %s
    400 InvalidBandwidthPackage.NotExist Eip bandwidth package not exist.
    400 OperationFailed.DistibuteLock Distibute lock fail.
    400 BandwidthPackageId.InvalidBandwidth The hybrid type eip can not add into low bandwidth bandwidthPackage.
    400 OperationFailed.ZoneIdInconsistent %s
    400 AttrMismatching.BandwidthPackageIpVersion %s
    400 InvalidEIPStatus.BizDisabled The EIP has been locked.
    400 Forbidden.FinancialLocked The ip business status is invalid.
    400 Mismatch.CloudBoxCbwpZoneAndEipZone The CbwpZone and EipZone are mismatched.
    400 InvalidInstanceId.NotFound The InstanceId is not found.
    400 MissingParam.BandwidthPackageId The parameter bandwidthPackageId is mandatory.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.