Tüm Ürünler
Search
Belge Merkezi

:DescribeCommonBandwidthPackages

Son Güncelleme:Oct 16, 2026

Belirtilen bir bölgedeki Paylaşımlı İnternet Bant Genişliği örneklerinin listesini ve ayrıntılarını sorgular.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

vpc:DescribeCommonBandwidthPackages

get

*CommonBandwidthPackage

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

None None

Request parameters

Parameter

Type

Required

Description

Example

IncludeReservationData

boolean

No

Yürürlüğe girmemiş abonelik verilerinin dahil edilip edilmeyeceğini belirtir. Geçerli değerler:

  • false (varsayılan): Yürürlüğe girmemiş abonelik verilerini dahil etmez.

  • true: Yürürlüğe girmemiş abonelik verilerini dahil eder.

false

RegionId

string

Yes

Paylaşımlı İnternet Bant Genişliği örneğinin bölge kimliği. Bölge kimliğini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.

cn-hangzhou

BandwidthPackageId

string

No

Paylaşımlı İnternet Bant Genişliği örneğinin kimliği.

cbwp-2ze2ic1xd2qeqk145****

ResourceGroupId

string

No

Kaynak grubunun kimliği.

rg-acfmxazb4ph****

Name

string

No

Paylaşımlı İnternet Bant Genişliği örneğinin adı. Ad 0 ila 128 karakter uzunluğunda olmalıdır ve http:// veya https:// ile başlayamaz.

test123

PageNumber

integer

No

Sayfa numarası. Varsayılan değer: 1.

1

PageSize

integer

No

Her sayfadaki giriş sayısı. Maksimum değer: 50. Varsayılan değer: 10.

10

DryRun

boolean

No

Yalnızca isteğin ön kontrolünün yapılıp yapılmayacağını belirtir. Geçerli değerler:

  • true: Örnek bilgilerini sorgulamadan isteğin ön kontrolünü yapar. Sistem, gerekli parametrelerin belirtilip belirtilmediğini, istek biçimini ve örnek durumunu kontrol eder. İstek ön kontrolden geçemezse, ilgili hata döndürülür. İstek ön kontrolden geçerse, DryRunOperation hata kodu döndürülür.

  • false (varsayılan): İsteği gönderir. İstek ön kontrolden geçerse, HTTP 2xx durum kodu döndürülür ve işlem gerçekleştirilir.

false

Tag

array<object>

No

Paylaşımlı İnternet Bant Genişliği örneğinin etiketleri.

object

No

Paylaşımlı İnternet Bant Genişliği örneğinin etiketleri.

Key

string

No

Kaynağın etiket anahtarı. En fazla 20 etiket anahtarı belirtebilirsiniz. Bu parametreyi belirtirseniz, boş bir dize belirtemezsiniz.

Bir etiket anahtarı en fazla 128 karakter uzunluğunda olabilir. aliyun veya acs: ile başlayamaz ve http:// veya https:// içeremez.

KeyTest

Value

string

No

Kaynağın etiket değeri. En fazla 20 etiket değeri belirtebilirsiniz. Bu parametreyi belirtirseniz, boş bir dize belirtebilirsiniz.

Bir etiket değeri en fazla 128 karakter uzunluğunda olabilir. aliyun veya acs: ile başlayamaz ve http:// veya https:// içeremez.

ValueTest

SecurityProtectionEnabled

boolean

No

Anti-DDoS (Enhanced) özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

  • false: Anti-DDoS (Enhanced) özelliğini etkinleştirmez.

  • true: Anti-DDoS (Enhanced) özelliğini etkinleştirir.

[Kullanımdan Kaldırıldı]

false

Response elements

Element

Type

Description

Example

object

Yanıt parametreleri.

PageSize

integer

Her sayfadaki giriş sayısı.

10

RequestId

string

İstek kimliği.

20E6FD1C-7321-4DAD-BDFD-EC8769E4AA33

PageNumber

integer

Sayfa numarası.

1

TotalCount

integer

Toplam giriş sayısı.

1

CommonBandwidthPackages

object

CommonBandwidthPackage

array<object>

Paylaşımlı İnternet Bant Genişliği örneklerinin ayrıntıları.

array<object>

Paylaşımlı İnternet Bant Genişliği örneklerinin ayrıntıları.

ReservationActiveTime

string

Yenileme yürürlük dönemi. Zaman YYYY-MM-DDThh:mm:ssZ biçimini izler.

2018-08-30T16:00:00Z

Status

string

Paylaşımlı İnternet Bant Genişliği örneğinin durumu. Geçerli değerler:

  • Available: Örnek kullanılabilir durumdadır.

  • Modifying: Örnek değiştiriliyor.

Available

CreationTime

string

Paylaşımlı İnternet Bant Genişliği örneğinin oluşturulduğu zaman. Zaman YYYY-MM-DDThh:mm:ssZ biçimini izler.

2017-06-28T06:39:20Z

ReservationOrderType

string

Yenileme ve teknik özellik değiştirme yöntemi. Geçerli değerler:

  • RENEWCHANGE: Teknik özellik değişikliği ile yenileme.

  • TEMP_UPGRADE: Geçici yükseltme.

  • UPGRADE: Yükseltme.

RENEWCHANGE

DeletionProtection

boolean

Silme korumasının etkin olup olmadığını gösterir. Geçerli değerler:

  • true: Silme koruması etkindir.

  • false: Silme koruması devre dışıdır.

true

ReservationInternetChargeType

string

Teknik özellik değişikliğinden sonraki faturalandırma yöntemi.

**PayByTraffic**: Veri aktarımına göre ödeme.

PayByBandwidth

Ratio

integer

Paylaşımlı İnternet Bant Genişliği örneğinin garanti edilen yüzdesi. Yalnızca 20 döndürülür.

Bu parametre yalnızca Çin sitesinde desteklenir.

20

InstanceChargeType

string

Paylaşımlı İnternet Bant Genişliği örneğinin faturalandırma yöntemi.

**PostPaid**: Kullandıkça öde.

PostPaid

RegionId

string

Paylaşımlı İnternet Bant Genişliği örneğinin bölge kimliği.

cn-hangzhou

BandwidthPackageId

string

Paylaşımlı İnternet Bant Genişliği örneğinin kimliği.

cbwp-bp1t3sm1ffzmshdki****

ServiceManaged

integer

Kaynağın bir hizmet hesabı tarafından oluşturulup oluşturulmadığını gösterir. Geçerli değerler:

  • 0: Kaynak bir hizmet hesabı tarafından oluşturulmamıştır.

  • 1: Kaynak bir hizmet hesabı tarafından oluşturulmuştur.

1

Bandwidth

string

Paylaşımlı İnternet Bant Genişliği örneğinin en yüksek bant genişliği. Birim: Mbit/s.

20

Description

string

Paylaşımlı İnternet Bant Genişliği örneğinin açıklaması.

none

ExpiredTime

string

Paylaşımlı İnternet Bant Genişliği örneğinin sona erme zamanı. Zaman YYYY-MM-DDThh:mm:ssZ biçimini izler.

2019-01-15T03:08:37Z

ReservationBandwidth

string

Teknik özellik değişikliğinden sonraki bant genişliği değeri. Birim: Mbit/s.

1000

ResourceGroupId

string

Kaynak grubunun kimliği.

rg-acfmxazb4ph****

InternetChargeType

string

Paylaşımlı İnternet Bant Genişliği örneğinin faturalandırma yöntemi.

  • PayByBandwidth: Bant genişliğine göre ödeme.

  • PayByDominantTraffic: Baskın veri aktarımına göre ödeme. PayByTraffic: Veri aktarımına göre ödeme.

PayByBandwidth

BusinessStatus

string

Paylaşımlı İnternet Bant Genişliği örneğinin iş durumu. Geçerli değerler:

  • Normal: Örnek normal bir durumdadır.

  • FinancialLocked: Örnek gecikmiş bir ödeme nedeniyle kilitlenmiştir.

  • Unactivated: Örnek etkinleştirilmemiştir.

Normal

Name

string

Paylaşımlı İnternet Bant Genişliği örneğinin adı.

abc

ISP

string

Hat türü. Geçerli değerler:

  • BGP: BGP (çoklu ISP) hattı. BGP (çoklu ISP) hatları tüm bölgelerde desteklenir.

  • BGP_PRO: BGP (çoklu ISP) Pro hattı. BGP (çoklu ISP) Pro hatları, Paylaşımlı İnternet Bant Genişliği için yalnızca Hong Kong (Çin), Singapur, Japonya (Tokyo), Filipinler (Manila), Malezya (Kuala Lumpur), Endonezya (Cakarta) ve Tayland (Bangkok) bölgelerinde desteklenir.

Tek ISP'li bant genişliği için beyaz listeye alınmış bir kullanıcıysanız, aşağıdaki değerler de döndürülebilir:

  • ChinaTelecom: China Telecom

  • ChinaUnicom: China Unicom

  • ChinaMobile: China Mobile

  • ChinaTelecom_L2: China Telecom L2

  • ChinaUnicom_L2: China Unicom L2

  • ChinaMobile_L2: China Mobile L2

Hangzhou bölgesinde bir Alibaba Finance Cloud kullanıcısıysanız, BGP_FinanceCloud döndürülür.

BGP

HasReservationData

string

Bekleyen siparişler olup olmadığını gösterir. Geçerli değerler:

  • false: Bekleyen sipariş yoktur.

  • true: Bekleyen siparişler vardır.

false

PublicIpAddresses

object

PublicIpAddresse

array<object>

Paylaşımlı İnternet Bant Genişliği örneğindeki genel IP adresları.

object

Paylaşımlı İnternet Bant Genişliği örneğindeki genel IP adresları.

IpAddress

string

Genel IP adresi.

47.95.XX.XX

AllocationId

string

Genel IP adresinin örnek kimliği.

eip-bp13e9i2qst4g6jzi****

BandwidthPackageIpRelationStatus

string

Paylaşımlı İnternet Bant Genişliği örneği ile EIP arasındaki ilişkilendirme durumu. Geçerli değerler:

  • BINDED: EIP, Paylaşımlı İnternet Bant Genişliği örneği ile ilişkilendirilmiştir.

  • BINDING: EIP, Paylaşımlı İnternet Bant Genişliği örneği ile ilişkilendiriliyor.

BINDED

SecurityProtectionTypes

object

SecurityProtectionType

array

Güvenlik koruma seviyesi. Geçerli değerler:

  • Bu parametre boşsa, varsayılan Anti-DDoS Basic kullanılır.

  • AntiDDoS_Enhanced: Anti-DDoS (Enhanced) kullanılır.

[Kullanımdan Kaldırıldı]

string

Güvenlik koruma seviyesi. Geçerli değerler:

  • Bu parametre boşsa, varsayılan Anti-DDoS Basic kullanılır.

  • AntiDDoS_Enhanced: Anti-DDoS (Enhanced) kullanılır.

[Kullanımdan Kaldırıldı]

AntiDDoS_Enhanced

Tags

object

Tag

array<object>

Paylaşımlı İnternet Bant Genişliği örneğinin etiketleri.

object

Paylaşımlı İnternet Bant Genişliği örneğinin etiketleri.

Key

string

Paylaşımlı İnternet Bant Genişliği örneğinin etiket anahtarı.

KeyTest

Value

string

Paylaşımlı İnternet Bant Genişliği örneğinin etiket değeri.

ValueTest

BizType

string

Paylaşımlı İnternet Bant Genişliği örneğinin iş türü. Geçerli değerler:

  • CloudBox: CloudBox. Bu tür yalnızca CloudBox kullanıcıları için desteklenir.

  • Default (varsayılan): Özel bir tür olmadığını belirten varsayılan tür.

CloudBox

Zone

string

Paylaşımlı İnternet Bant Genişliği örneğinin bölgesi.

Bölgedeki kaynaklar aşırı yüklendiğinde, hizmet kararlılığını sağlamak için Paylaşımlı İnternet Bant Genişliği örneği başka bir bölgeye zamanlanabilir.

ap-southeast-1-lzdvn-cb

Examples

Success response

JSON format

{
  "PageSize": 10,
  "RequestId": "20E6FD1C-7321-4DAD-BDFD-EC8769E4AA33",
  "PageNumber": 1,
  "TotalCount": 1,
  "CommonBandwidthPackages": {
    "CommonBandwidthPackage": [
      {
        "ReservationActiveTime": "2018-08-30T16:00:00Z",
        "Status": "Available",
        "CreationTime": "2017-06-28T06:39:20Z",
        "ReservationOrderType": "RENEWCHANGE",
        "DeletionProtection": true,
        "ReservationInternetChargeType": "PayByBandwidth",
        "Ratio": 20,
        "InstanceChargeType": "PostPaid",
        "RegionId": "cn-hangzhou",
        "BandwidthPackageId": "cbwp-bp1t3sm1ffzmshdki****",
        "ServiceManaged": 1,
        "Bandwidth": "20",
        "Description": "none",
        "ExpiredTime": "2019-01-15T03:08:37Z",
        "ReservationBandwidth": "1000",
        "ResourceGroupId": "rg-acfmxazb4ph****",
        "InternetChargeType": "PayByBandwidth",
        "BusinessStatus": "Normal",
        "Name": "abc",
        "ISP": "BGP",
        "HasReservationData": "false",
        "PublicIpAddresses": {
          "PublicIpAddresse": [
            {
              "IpAddress": "47.95.XX.XX",
              "AllocationId": "eip-bp13e9i2qst4g6jzi****",
              "BandwidthPackageIpRelationStatus": "BINDED"
            }
          ]
        },
        "SecurityProtectionTypes": {
          "SecurityProtectionType": [
            "AntiDDoS_Enhanced"
          ]
        },
        "Tags": {
          "Tag": [
            {
              "Key": "KeyTest",
              "Value": "ValueTest"
            }
          ]
        },
        "BizType": "CloudBox",
        "Zone": "ap-southeast-1-lzdvn-cb"
      }
    ]
  }
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidBandwidthPackageIdNumber.NotSupported The number of BandwidthPackageIds exceeds the limit. İnternet Paylaşımlı Bant Genişliği örneklerinin sayısı kota sınırını aşar.
400 InvalidResourceGroupId The specified ResourceGroupId does not exist. Kaynak grubu kimliği mevcut değil.
400 OperationUnsupported.ResourceGroupId ResourceGroup is not supported in this region. Kaynak grubu özelliği etkinleştirilmemiştir.
404 InvalidRegionId.NotFound The specified RegionId does not exist in our records.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.