All Products
Search

This Product

    Internet Shared Bandwidth:AddCommonBandwidthPackageIp

    Document Center

    Internet Shared Bandwidth:AddCommonBandwidthPackageIp

    Last Updated:Jun 12, 2026

    Memanggil operasi AddCommonBandwidthPackageIp untuk menambahkan EIP ke instans Internet Shared Bandwidth.

    Deskripsi operasi

    Sebelum memanggil operasi ini, perhatikan hal-hal berikut:

    • Saat Anda memanggil operasi ini untuk menambahkan EIP ke instans Internet Shared Bandwidth, EIP harus memenuhi kondisi berikut:

      • Metode penagihan EIP adalah pay-as-you-go.

      • EIP berada di wilayah yang sama dengan instans Internet Shared Bandwidth.

      • Jenis jalur EIP sama dengan instans Internet Shared Bandwidth.

    • AddCommonBandwidthPackageIp adalah operasi asinkron. Setelah Anda mengirimkan permintaan, sistem akan mengembalikan ID permintaan, tetapi EIP belum ditambahkan ke instans Internet Shared Bandwidth. Node penambahan masih berjalan di latar belakang. Anda dapat memanggil DescribeCommonBandwidthPackages untuk mengkueri status asosiasi antara instans Internet Shared Bandwidth dan EIP.

      • Jika status asosiasi adalah BINDING, instans Internet Shared Bandwidth sedang diasosiasikan dengan EIP. Dalam status ini, Anda hanya dapat menjalankan operasi kueri.

      • Jika status asosiasi adalah BINDED, instans Internet Shared Bandwidth telah diasosiasikan dengan 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 wilayah instans Internet Shared Bandwidth.

    Anda dapat memanggil DescribeRegions untuk mengkueri ID wilayah.

    cn-hangzhou
    BandwidthPackageId

    string

    Yes

    ID instans Internet Shared Bandwidth.

    cbwp-2ze2ic1xd2qeqasdf****
    IpInstanceId

    string

    Yes

    ID instans EIP.

    Anda dapat memanggil DescribeEipAddresses untuk mengkueri ID instans EIP.

    eip-2zeerraiwb7uqwed****
    IpType

    string

    No

    Tipe IP. Nilai valid: EIP, yang menunjukkan bahwa EIP ditambahkan ke instans Internet Shared Bandwidth.

    EIP
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan.

    Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Nilai ClientToken hanya dapat berisi karakter ASCII.

    Catatan

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

    0c593ea1-3bea-11e9-b96b-88e9fe637760
    DryRun

    boolean

    No

    Apakah akan menjalankan dry run, tanpa menjalankan permintaan aktual.

    false

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter tanggapan.

    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 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 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 OperationFailed.ZoneIdInconsistent %s
    400 AttrMismatching.BandwidthPackageIpVersion %s
    400 InvalidBandwidthPackageId.NotFound The specified BandwidthPackageId not exist.
    400 InvalidInstanceId.NotFound The InstanceId is not found.
    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 MissingParam.BandwidthPackageId The parameter bandwidthPackageId is mandatory.
    404 InvalidRegionId.NotFound The specified RegionId does not exist in our records.
    404 InvalidBandwidthPackageId.NotFound The specified bandwidthPackageId does not exist in our records.
    404 InvalidIpInstanceId.NotFound The specified Eip InstanceId does not exist in our records.
    404 IpInstanceId.InvalidIpInternetChargeType The hybrid type eip not support add into bandwidthPackage of PayBytraffic type.
    404 BandwidthPackageId.InvalidBandwidth The hybrid type eip can not add into low bandwidth bandwidthPackage.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.