Todos os produtos
Search
Central de documentação

:DescribeCenBandwidthPackages

Última atualização: Jul 03, 2026

Consulta detalhes sobre planos de largura de banda da Cloud Enterprise Network (CEN) na conta Alibaba Cloud atual.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
IncludeReservationData Boolean Não true

Define se os dados de renovação devem ser incluídos. Valores válidos:

  • true: sim
  • false: não
Action String Sim DescribeCenBandwidthPackages

Operação a executar. Defina o valor como DescribeCenBandwidthPackages.

PageNumber Integer Não 1

Número da página a retornar. Valor padrão: 1.

PageSize Integer Não 2

Quantidade de entradas a retornar por página. Valor máximo: 50. Valor padrão: 10.

IsOrKey Boolean Não false

Operador lógico entre as condições de filtro. Valores válidos:

  • false (padrão): AND. Retorna planos de largura de banda que atendem a todas as condições de filtro.
  • true: OR. Retorna planos de largura de banda que atendem a pelo menos uma das condições de filtro.
Filter.N.Key String Não CenId

Condição de filtro.

Use condições de filtro para refinar a consulta dos planos de largura de banda. As seguintes condições têm suporte:

  • CenId: ID da instância CEN
  • Status: status do plano de largura de banda. Valores válidos:
    • Idle: não associado a uma instância CEN.
    • InUse: associado a uma instância CEN.
  • CenBandwidthPackageId: ID do plano de largura de banda
  • Name: nome do plano de largura de banda

    Especifique uma ou mais condições de filtro. O valor máximo de N é 5.

Filter.N.Value.N String Não cen-xxjsjfkffkfkfjkf****

Especifique um valor de filtro com base no parâmetro Key.

Defina vários valores para uma chave de filtro. A relação lógica entre múltiplos valores de filtro é OR. Se um plano de largura de banda corresponder a qualquer um dos valores especificados, ele atenderá à condição de filtro.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
PageSize Integer 2

Quantidade de entradas retornadas por página.

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

ID da solicitação.

PageNumber Integer 1

Número da página retornada.

TotalCount Integer 2

Total de entradas retornadas.

CenBandwidthPackages Array of CenBandwidthPackage

Detalhes do plano de largura de banda.

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

Horário de expiração do upgrade temporário.

Status String InUse

Indica se o plano de largura de banda está associado a uma instância CEN.

  • Idle: não
  • InUse: sim
CreationTime String 2021-02-01T11:14Z

Momento de criação do plano de largura de banda. O horário segue o padrão ISO8601 no formato YYYY-MM-DDThh:mmZ.

ReservationOrderType String UPGRADE

Método de renovação.

  • TEMP_UPGRADE: upgrade temporário
  • UPGRADE: upgrade
BandwidthPackageChargeType String PREPAY

Método de faturamento do plano de largura de banda.

CenBandwidthPackageId String cenbwp-4c2zaavbvh5x****

ID do plano de largura de banda.

ReservationInternetChargeType String PREPAY

Novo método de faturamento.

GeographicRegionAId String china

ID da área a consultar. Valores válidos:

  • china: China continental.
  • asia-pacific: Ásia-Pacífico
  • europe: Europa
  • australia: Austrália
  • north-america: América do Norte
Bandwidth Long 2

Largura de banda máxima do plano.

Description String cen

Descrição do plano de largura de banda.

ExpiredTime String 2021-09-08T16:00Z

Período de expiração do plano de largura de banda.

ReservationBandwidth String 10

Valor de largura de banda para o qual o plano retorna após o término do upgrade temporário.

GeographicSpanId String north-america_china

ID da área conectada.

GeographicRegionBId String north-america

ID da outra área conectada do plano de largura de banda. Valores válidos:

  • china: China continental.
  • asia-pacific: Ásia-Pacífico
  • europe: Europa
  • australia: Austrália
  • north-america: América do Norte
IsCrossBorder Boolean false

Indica se o plano é de largura de banda transfronteiriça.

  • false: não
  • true: sim
BusinessStatus String Normal

Status do plano de largura de banda. Valores válidos:

  • Normal: normal
  • FinancialLocked: bloqueado por pagamentos atrasados
  • SecurityLocked: bloqueado por motivos de segurança
Name String test

Nome do plano de largura de banda.

HasReservationData String false

Indica se há dados de renovação incluídos.

  • true: sim
  • false: não
Nota Este parâmetro retorna true apenas quando o parâmetro IncludeReservationData está definido como true e um pedido ainda não entrou em vigor.
OrginInterRegionBandwidthLimits Array of OrginInterRegionBandwidthLimit

Detalhes das regiões conectadas.

OrginInterRegionBandwidthLimit
BandwidthLimit String 1

Valor máximo de largura de banda para a conexão inter-regional.

OppositeRegionId String us-west-1

ID da região par.

GeographicSpanId String north-america_china

Regiões conectadas.

LocalRegionId String cn-hangzhou

ID da região de origem.

CenIds Array of String cen-xxjsjfkffkfkfjkf****

Lista de instâncias CEN associadas ao plano de largura de banda.

Exemplos

Solicitações de exemplo

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

Respostas de exemplo

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 erro

Para obter uma lista de códigos de erro, visite o API Error Center.