Todos los productos
Search
Centro de documentos

:DescribeCenBandwidthPackages

Última actualización: Sep 02, 2026

Consulta los detalles de los planes de ancho de banda de Cloud Enterprise Network (CEN) en la cuenta actual de Alibaba Cloud.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, se recomienda llamar a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro Tipo Obligatorio Ejemplo Descripción
IncludeReservationData Boolean No true

Especifica si se incluyen datos de renovación. Valores válidos:

  • true: sí
  • false: no
Action String Sí DescribeCenBandwidthPackages

La operación que desea ejecutar. Establezca el valor en DescribeCenBandwidthPackages.

PageNumber Integer No 1

Número de página a devolver. Valor predeterminado: 1.

PageSize Integer No 2

Número de entradas a devolver por página. Valor máximo: 50. Valor predeterminado: 10.

IsOrKey Boolean No false

Operador lógico entre las condiciones de filtro. Valores válidos:

  • false (predeterminado): AND. Se devuelven los planes de ancho de banda que cumplen todas las condiciones de filtro.
  • true: OR. Se devuelven los planes de ancho de banda que cumplen al menos una condición de filtro.
Filter.N.Key String No CenId

Condición de filtro.

Use condiciones de filtro para filtrar los planes de ancho de banda que desea consultar. A continuación se muestran las condiciones compatibles:

  • CenId: ID de la instancia de CEN.
  • Status: estado del plan de ancho de banda. Valores válidos:
    • Idle: no asociado con una instancia de CEN.
    • InUse: asociado con una instancia de CEN.
  • CenBandwidthPackageId: ID del plan de ancho de banda.
  • Name: nombre del plan de ancho de banda.

    Puede especificar una o más condiciones de filtro. El valor máximo de N es 5.

Filter.N.Value.N String No cen-xxjsjfkffkfkfjkf****

Especifique un valor de filtro según el parámetro Key.

Puede especificar varios valores para una clave de filtro. La relación lógica entre múltiples valores de filtro es OR. Si un plan de ancho de banda coincide con alguno de los valores especificados, cumple la condición de filtro.

Parámetros de respuesta

Parámetro Tipo Ejemplo Descripción
PageSize Integer 2

Número de entradas devueltas por página.

RequestId String 9D7E2400-2755-4AF5-9B73-12565E4F73A0

ID de la solicitud.

PageNumber Integer 1

Número de la página devuelta.

TotalCount Integer 2

Número total de entradas devueltas.

CenBandwidthPackages Array of CenBandwidthPackage

Detalles del plan de ancho de banda.

CenBandwidthPackage
ReservationActiveTime String 2021-08-30T16:00Z

Hora de vencimiento de la actualización temporal.

Status String InUse

Indica si el plan de ancho de banda está asociado con una instancia de CEN.

  • Idle: no
  • InUse: sí
CreationTime String 2021-02-01T11:14Z

Hora de creación del plan de ancho de banda. Se muestra en formato ISO8601: AAAA-MM-DDThh:mmZ.

ReservationOrderType String UPGRADE

Método de renovación.

  • TEMP_UPGRADE: actualización temporal
  • UPGRADE: actualización
BandwidthPackageChargeType String PREPAY

Método de facturación del plan de ancho de banda.

CenBandwidthPackageId String cenbwp-4c2zaavbvh5x****

ID del plan de ancho de banda.

ReservationInternetChargeType String PREPAY

Nuevo método de facturación.

GeographicRegionAId String china

ID del área que desea consultar. Valores válidos:

  • china: China continental.
  • asia-pacific: Asia Pacífico
  • europe: Europa
  • australia: Australia
  • north-america: Norteamérica
Bandwidth Long 2

Ancho de banda máximo del plan.

Description String cen

Descripción del plan de ancho de banda.

ExpiredTime String 2021-09-08T16:00Z

Fecha de caducidad del plan de ancho de banda.

ReservationBandwidth String 10

Valor de ancho de banda al que revierte el plan cuando finaliza la actualización temporal.

GeographicSpanId String north-america_china

ID del área conectada.

GeographicRegionBId String north-america

ID de la otra área conectada del plan de ancho de banda. Valores válidos:

  • china: China continental.
  • asia-pacific: Asia Pacífico
  • europe: Europa
  • australia: Australia
  • north-america: Norteamérica
IsCrossBorder Boolean false

Indica si el plan es transfronterizo.

  • false: no
  • true: sí
BusinessStatus String Normal

Estado del plan de ancho de banda. Valores válidos:

  • Normal: normal
  • FinancialLocked: bloqueado por pagos pendientes
  • SecurityLocked: bloqueado por motivos de seguridad
Name String test

Nombre del plan de ancho de banda.

HasReservationData String false

Indica si se incluyen datos de renovación.

  • true: sí
  • false: no
Nota Este parámetro devuelve true solo cuando el parámetro IncludeReservationData se establece en true y un pedido aún no ha entrado en vigor.
OrginInterRegionBandwidthLimits Array of OrginInterRegionBandwidthLimit

Detalles de las regiones conectadas.

OrginInterRegionBandwidthLimit
BandwidthLimit String 1

Valor máximo de ancho de banda para la conexión interregional.

OppositeRegionId String us-west-1

ID de la región par.

GeographicSpanId String north-america_china

Regiones conectadas.

LocalRegionId String cn-hangzhou

ID de la región de origen.

CenIds Array of String cen-xxjsjfkffkfkfjkf****

Lista de instancias de CEN asociadas con el plan de ancho de banda.

Ejemplos

Solicitudes de ejemplo

http(s)://[Endpoint]/?IncludeReservationData=true
&Action=DescribeCenBandwidthPackages
&PageNumber=1
&PageSize=2
&IsOrKey=false
&Filter=[{"Key":"CenId","Value":["cen-xxjsjfkffkfkfjkf****"]}]
&Common request parameters

Respuestas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeCenBandwidthPackagesResponse>
    <PageSize>2</PageSize>
    <RequestId>9D7E2400-2755-4AF5-9B73-12565E4F73A0</RequestId>
    <PageNumber>1</PageNumber>
    <TotalCount>2</TotalCount>
    <CenBandwidthPackages>
        <ReservationActiveTime>2021-08-30T16:00Z</ReservationActiveTime>
        <Status>InUse</Status>
        <CreationTime>2021-02-01T11:14Z</CreationTime>
        <ReservationOrderType>UPGRADE</ReservationOrderType>
        <BandwidthPackageChargeType>PREPAY</BandwidthPackageChargeType>
        <CenBandwidthPackageId>cenbwp-4c2zaavbvh5x****</CenBandwidthPackageId>
        <ReservationInternetChargeType>PREPAY</ReservationInternetChargeType>
        <GeographicRegionAId>china</GeographicRegionAId>
        <Bandwidth>2</Bandwidth>
        <Description>cen</Description>
        <ExpiredTime>2021-09-08T16:00Z</ExpiredTime>
        <ReservationBandwidth>10</ReservationBandwidth>
        <GeographicSpanId>north-america_china</GeographicSpanId>
        <GeographicRegionBId>north-america</GeographicRegionBId>
        <IsCrossBorder>false</IsCrossBorder>
        <BusinessStatus>Normal</BusinessStatus>
        <Name>test</Name>
        <HasReservationData>false</HasReservationData>
        <OrginInterRegionBandwidthLimits>
            <BandwidthLimit>1</BandwidthLimit>
            <OppositeRegionId>us-west-1</OppositeRegionId>
            <GeographicSpanId>north-america_china</GeographicSpanId>
            <LocalRegionId>cn-hangzhou</LocalRegionId>
        </OrginInterRegionBandwidthLimits>
        <CenIds>cen-xxjsjfkffkfkfjkf****</CenIds>
    </CenBandwidthPackages>
</DescribeCenBandwidthPackagesResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "PageSize" : 2,
  "RequestId" : "9D7E2400-2755-4AF5-9B73-12565E4F73A0",
  "PageNumber" : 1,
  "TotalCount" : 2,
  "CenBandwidthPackages" : [ {
    "ReservationActiveTime" : "2021-08-30T16:00Z",
    "Status" : "InUse",
    "CreationTime" : "2021-02-01T11:14Z",
    "ReservationOrderType" : "UPGRADE",
    "BandwidthPackageChargeType" : "PREPAY",
    "CenBandwidthPackageId" : "cenbwp-4c2zaavbvh5x****",
    "ReservationInternetChargeType" : "PREPAY",
    "GeographicRegionAId" : "china",
    "Bandwidth" : 2,
    "Description" : "cen",
    "ExpiredTime" : "2021-09-08T16:00Z",
    "ReservationBandwidth" : "10",
    "GeographicSpanId" : "north-america_china",
    "GeographicRegionBId" : "north-america",
    "IsCrossBorder" : false,
    "BusinessStatus" : "Normal",
    "Name" : "test",
    "HasReservationData" : "false",
    "OrginInterRegionBandwidthLimits" : [ {
      "BandwidthLimit" : "1",
      "OppositeRegionId" : "us-west-1",
      "GeographicSpanId" : "north-america_china",
      "LocalRegionId" : "cn-hangzhou"
    } ],
    "CenIds" : [ "cen-xxjsjfkffkfkfjkf****" ]
  } ]
}

Códigos de error

Para obtener una lista de códigos de error, visite el Centro de errores de API.