All Products
Search

This Product

    Cloud Enterprise Network:CreateCenBandwidthPackage

    Document Center

    Cloud Enterprise Network:CreateCenBandwidthPackage

    Last Updated:Jul 20, 2026

    Membuat paket bandwidth untuk Cloud Enterprise Network (CEN) agar dapat mengaktifkan konektivitas lintas wilayah antar instans jaringan.

    Deskripsi operasi

    • Saat Anda membuat instans paket bandwidth, Anda harus menentukan area terhubung. Area paket bandwidth adalah kumpulan wilayah. Setiap area berisi satu atau beberapa wilayah Alibaba Cloud. Pilih area terhubung berdasarkan wilayah yang ingin Anda hubungkan. Untuk informasi lebih lanjut tentang hubungan antara area dan wilayah, lihat Membeli paket bandwidth.

    • Untuk informasi lebih lanjut tentang detail penagihan paket bandwidth, lihat Tagihan.

    • CreateCenBandwidthPackage adalah operasi asinkron. Setelah Anda memanggil operasi ini, sistem akan mengembalikan ID instans paket bandwidth, tetapi paket bandwidth belum dibuat. Node pembuatan masih berjalan di latar belakang. Anda dapat memanggil operasi DescribeCenBandwidthPackages untuk mengkueri status paket bandwidth. Ketika paket bandwidth berada dalam status Idle atau InUse, paket bandwidth telah dibuat.

    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

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    cen:CreateCenBandwidthPackage

    create

    *CenBandwidthPackage

    acs:cen:*:{#accountId}:cenbandwidthpackage/*

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan.

    Anda dapat menggunakan klien untuk menghasilkan nilai tersebut, tetapi Anda harus memastikan bahwa nilainya unik di antara berbagai permintaan. Token dapat memiliki panjang hingga 64 karakter ASCII.

    02fb3da4-130e-11e9-8e44-001****
    Name

    string

    No

    Nama paket bandwidth.

    Nama dapat kosong atau memiliki panjang 1 hingga 128 karakter, dan tidak boleh dimulai dengan http:// atau https://.

    nametest.
    Description

    string

    No

    Deskripsi paket bandwidth.

    Deskripsi dapat kosong atau memiliki panjang 1 hingga 256 karakter, dan tidak boleh dimulai dengan http:// atau https://.

    namedesc.
    Bandwidth

    integer

    Yes

    Nilai bandwidth maksimum paket bandwidth. Unit: Mbit/s. Nilai valid: 2 hingga 10000.

    2
    GeographicRegionAId

    string

    Yes

    Area tempat instans jaringan berada. Nilai valid:

    • China: Daratan Tiongkok.

    • North-America: Amerika Utara.

    • Asia-Pacific: Asia Pasifik.

    • Europe: Eropa.

    China.
    GeographicRegionBId

    string

    Yes

    Area tempat instans jaringan lainnya berada. Nilai valid:

    • China: Daratan Tiongkok.

    • North-America: Amerika Utara.

    • Asia-Pacific: Asia Pasifik.

    • Europe: Eropa.

    China.
    BandwidthPackageChargeType

    string

    No

    Metode penagihan paket bandwidth. Nilai valid: PREPAY, yang menunjukkan metode penagihan langganan.

    PREPAY.
    Period

    integer

    No

    Durasi langganan paket bandwidth. Nilai default: 1.

    • Jika PricingCycle diatur ke Month, nilai valid untuk Period adalah 1 hingga 3 dan 6.

    • Jika PricingCycle diatur ke Year, nilai valid untuk Period adalah 1 hingga 3.

    Catatan

    Parameter ini wajib diisi ketika BandwidthPackageChargeType diatur ke PREPAY.

    1
    PricingCycle

    string

    No

    Siklus penagihan paket bandwidth. Nilai valid:

    • Month (default): ditagih bulanan.

    • Year: ditagih tahunan.

    Month.
    AutoPay

    boolean

    No

    Apakah akan mengaktifkan pembayaran otomatis untuk tagihan instans paket bandwidth. Nilai valid:

    • true: mengaktifkan pembayaran otomatis.

    • false (default): menonaktifkan pembayaran otomatis.

    Jika Anda mengatur parameter ini ke false, buka Pusat Pesanan di konsol untuk menyelesaikan pembayaran setelah Anda memanggil operasi ini. Jika tidak, instans tidak dapat dibuat.

    false.
    Tag

    array<object>

    No

    Apakah akan mengaktifkan perpanjangan otomatis. Nilai valid:

    • true: diaktifkan.

    • false (default): dinonaktifkan.

    Catatan

    Hanya paket bandwidth langganan yang mendukung perpanjangan otomatis.

    false.

    object

    No

    Key

    string

    No

    Kunci pengatur waktu Sumber daya.

    Kunci tag tidak boleh berupa string kosong. Panjang kunci tag maksimal 64 karakter dan tidak boleh dimulai dengan aliyun atau acs:. Kunci tag tidak boleh mengandung http:// atau https://.

    Anda dapat menentukan hingga 20 kunci tag sekaligus.

    tagtest
    Value

    string

    No

    Nilai pengatur waktu Sumber daya.

    Nilai tag dapat kosong atau memiliki panjang maksimal 128 karakter. Nilai tag tidak boleh dimulai dengan aliyun atau acs: dan tidak boleh mengandung http:// atau https://.

    Setiap kunci tag berkorespondensi dengan satu nilai tag. Anda dapat menentukan hingga 20 nilai tag sekaligus.

    tagtest

    No

    Durasi perpanjangan otomatis. Unit: bulan. Nilai valid: 0 hingga 2147483647. Nilai default: 1.

    1

    No

    Informasi tag.

    Anda dapat menentukan hingga 20 tag sekaligus.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter tanggapan.

    CenBandwidthPackageId

    string

    ID instans paket bandwidth baru.

    cenbwp-4c2zaavbvh5fx****
    CenBandwidthPackageOrderId

    string

    ID pesanan paket bandwidth.

    20156420004****
    RequestId

    string

    ID permintaan.

    E4B345CD-2CBA-4881-AF6D-E5D9BAE1CA7B.

    Contoh

    Respons sukses

    JSONformat

    {
  "CenBandwidthPackageId": "cenbwp-4c2zaavbvh5fx****",
  "CenBandwidthPackageOrderId": "20156420004****",
  "RequestId": "E4B345CD-2CBA-4881-AF6D-E5D9BAE1CA7B"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 UnSupported.ChargeType The charge type is not supported.
    400 ParameterIllegal.BandwidthPackage The parameter of bandwidth packaged is illegal. BandwidthPackage yang ditentukan dalam parameter tidak valid.
    400 OperationInvalid.UserCanNotBuyCrossBorderBwp According to the laws and regulations of the operator and mainland China, you are currently not eligible to purchase or renew a cross-border bandwidth package. Please contact online customer service or your business manager for consultation. Karena persyaratan regulator Penyedia layanan dan Tiongkok Daratan, Anda saat ini tidak memenuhi syarat untuk membeli atau perpanjangan paket bandwidth lintas batas. Hubungi layanan pelanggan online atau manajer akun Anda untuk bantuan.
    400 OperationInvalid.UserCanNotBuyBwp The user can not buy Cen bandwidthPackage.
    400 Order.AccountStatusIllegal Illegal account status for postpay service not opened for this account. Akun belum ditambahkan ke daftar putih bayar sesuai pemakaian. Tambahkan akun ke daftar putih dan coba lagi.
    400 InvalidParameter Invalid parameter. Parameter tidak valid.
    400 Unauthorized The AccessKeyId is unauthorized. Akun tidak memiliki izin untuk melakukan operasi ini.
    400 InvalidParameter.TagValue The specified parameter TagValue is invalid. Parameter Nilai Tag tidak valid.
    500 PayFor.AccountMoneyValidateError Your channel merchant quota is insufficient. Please contact the channel merchant. Batas kredit mitra saluran Anda tidak mencukupi. Hubungi mitra saluran Anda.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.