全部產品
Search

搜尋本產品

    Internet Shared Bandwidth：CreateCommonBandwidthPackage

    文件中心

    Internet Shared Bandwidth：CreateCommonBandwidthPackage

    更新時間：Jun 19, 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

    否

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

    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（按流量計費）。

    中国站示例值：PayByBandwidth，国际站示例值：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.
    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.
    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.
    404 InvalidZoneId.NotFound Specified value of ZoneId is not exists.

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

    變更歷史

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