全部產品
Search

搜尋本產品

    Internet Shared Bandwidth：CreateCommonBandwidthPackage

    文件中心

    Internet Shared Bandwidth：CreateCommonBandwidthPackage

    更新時間：Sep 07, 2026

    呼叫CreateCommonBandwidthPackage介面建立共享頻寬執行個體。

    介面說明

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    vpc:CreateCommonBandwidthPackage

    create

    *CommonBandwidthPackage

    acs:vpc:{#regionId}:{#accountId}:combandwidthpackage/*

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    是

    共享頻寬所在的地域 ID。

    您可以透過呼叫 DescribeRegions 介面取得地域 ID。

    cn-hangzhou
    Zone

    string

    否

    共享頻寬的可用區。 建立 CloudBox 共享頻寬時，該參數必填。

    ap-southeast-1-lzdvn-cb
    ISP

    string

    否

    線路類型。取值：

    • BGP（預設值）：BGP（多線）線路。目前全部地域都支援 BGP（多線）線路。

    • BGP_PRO：BGP（多線）_精品線路。目前僅中國香港、新加坡、日本（東京）、菲律賓（馬尼拉）、馬來西亞（吉隆坡）、印度尼西亞（雅加達）和泰國（曼谷）地域支援 BGP（多線）_精品線路共享頻寬。

    如果您是單線頻寬的白名單使用者，您還可以選擇以下類型：

    • ChinaTelecom：中國電信

    • ChinaUnicom：中國聯通

    • ChinaMobile：中國移動

    • ChinaTelecom_L2：中國電信 L2

    • ChinaUnicom_L2：中國聯通 L2

    • ChinaMobile_L2：中國移動 L2

    如果您是杭州金融雲使用者，該欄位必填，取值：BGP_FinanceCloud。

    BGP
    Name

    string

    否

    共享頻寬的名稱。

    長度為 0-128 個字元，不能以http://或https://開頭。

    test123
    Description

    string

    否

    共享頻寬的描述資訊。

    長度為 0-256 個字元，不能以http://或https://開頭。

    abc
    ClientToken

    string

    否

    用戶端 Token，用於保證請求的冪等性。

    從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken 僅支援 ASCII 字元。

    說明

    若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 識別碼。每次 API 請求的 RequestId 不一樣。

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

    string

    否

    資源群組 ID。

    rg-acfmxazdjdhd****
    Bandwidth

    integer

    是

    共享頻寬的頻寬峰值。單位：Mbps。

    預設取值範圍：1~1000。預設值：1。

    1000
    Ratio

    integer

    否

    共享頻寬的保底百分比，僅取值為 20。

    說明

    僅中國站支援該參數。

    20
    InternetChargeType

    string

    否

    共享頻寬的計費方式，取值： PayByTraffic（按流量計費）。

    For China site: PayByBandwidth, for International site: PayByTraffic
    SecurityProtectionTypes

    array

    否

    安全防護等級。

    • 配置為空時，預設為 DDoS 防護（基礎版）。

    • 配置為AntiDDoS_Enhanced時，表示 DDoS 防護（增強版）。

    最多支援新增 10 個安全防護等級。

    說明

    該參數已廢棄。

    AntiDDoS_Enhanced

    string

    否

    安全防護等級。

    • 配置為空時，預設為 DDoS 防護（基礎版）。

    • 配置為AntiDDoS_Enhanced時，表示 DDoS 防護（增強版）。

    N 的取值範圍：1~10。目前僅支援新增 1 個安全防護等級，新增多個可能無法成功呼叫該介面。

    說明

    該參數已廢棄。

    AntiDDoS_Enhanced
    Tag

    array<object>

    否

    共享頻寬執行個體的標籤清單。

    object

    否

    Key

    string

    否

    資源的標籤鍵。最多支援輸入 20 個標籤鍵。如需傳入該值，則不能輸入空字串。

    一個標籤鍵最多支援 128 個字元，不能以aliyun和acs:開頭，不能包含http://或者https://。

    FinanceDept
    Value

    string

    否

    資源的標籤值。最多支援輸入 20 個標籤值。如需傳入該值，可以輸入空字串。

    最多支援 128 個字元，不能以aliyun和acs:開頭，不能包含http://或者https://。

    FinanceJoshua

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    傳回資訊清單。

    BandwidthPackageId

    string

    共享頻寬執行個體的 ID。

    cbwp-bp1vevu8h3ieh****
    RequestId

    string

    請求 ID。

    FF39F653-033E-4CD9-9EDF-3CCA5A71FBC3
    ResourceGroupId

    string

    資源群組 ID。

    rg-acfmxazdjdhd****

    樣本

    正常返回樣本

    JSON格式

    {
  "BandwidthPackageId": "cbwp-bp1vevu8h3ieh****",
  "RequestId": "FF39F653-033E-4CD9-9EDF-3CCA5A71FBC3",
  "ResourceGroupId": "rg-acfmxazdjdhd****"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 ResourceNotEnough.Bandwidth The specified resource of Bandwidth is not enough. 頻寬資源不足。
    400 MissingParameter Miss mandatory parameter.
    400 InvalidParameter.Name.Malformed The specified Name is not valid.
    400 InvalidParameter.Description.Malformed The specified Description is not valid.
    400 BandwidthPackageOperation.conflict BandwidthPackage operation conflict, please wait a moment and try again.
    400 InvalidParameter.Bandwidth The specified bandwidth is not valid.
    400 BandwidthPackage.QuotaExceeded Create BandwidthPackage has exceeded quota.
    400 IllegalParam.Zone Zone is illegal.
    400 InvalidParameter.InvalidChargeType The specified chargeType is not valid.
    400 InvalidResourceGroupId The specified ResourceGroupId does not exist. 資源群組 ID 不存在。
    400 OperationFailed.SaleValidate Validate sale condition with subArticle failed. 使用子專案驗證銷售條件失敗。
    400 OperationFailed.SyncOrderToSub SyncOrderToSub error. 操作失敗。
    400 IllegalParam.Ratio The specified ratio is not valid.
    400 OperationUnsupported.InvalidZone It is not allowed to create CBWP in the specified zone.
    400 IllegalParam.AvailableZone %s
    400 MissingParam.NameOrDescription %s
    400 UnsupportedRegion.CloudBoxInternet The region does not support cloud box public network. 該地域不支援 CloudBox 公網。
    400 ResourceNotEnough.CommonBandWidthPackage The specified resource commonBandWidthPackage is not enough. 共享頻寬包資源不足。
    404 InvalidRegionId.NotFound The specified RegionId does not exist in our records.
    404 InvalidVpcId.NotFound Specified value of VpcId is not found in our record. 該 VPC 不存在，請您檢查輸入的 VPC 是否正確。
    404 InvalidZoneId.NotFound Specified value of ZoneId is not exists.

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。