DescribeCenBandwidthPackages - Cloud Enterprise Network: Central de Documentação do Alibaba Cloud

Consulta informações sobre instâncias de pacotes de largura de banda chamando a operação DescribeCenBandwidthPackages.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

cen:DescribeCenBandwidthPackages

get

*CenBandwidthPackage

acs:cen:*:{#accountId}:cenbandwidthpackage/*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
IncludeReservationData	boolean	Não	Especifica se os dados de renovação devem ser incluídos. Valores válidos: true: Inclui dados de renovação. false: Não inclui dados de renovação.	true
PageNumber	integer	Não	O número da página da lista. Valor padrão: 1.	1
PageSize	integer	Não	O número de entradas por página para uma consulta paginada. Valor máximo: 50. Valor padrão: 10.	2
IsOrKey	boolean	Não	A relação lógica entre as condições de filtro. Valores válidos: false (padrão): As condições de filtro têm uma relação AND. Um pacote de largura de banda deve corresponder a todas as condições de filtro para ser retornado. true: As condições de filtro têm uma relação OR. Um pacote de largura de banda que corresponder a qualquer condição de filtro será retornado.	false
ResourceGroupId	string	Não	O ID do grupo de recursos.	rg-acfnwjeo4tv****
Filter	array<object>	Não	As informações de filtro.
	object	Não	As informações de filtro.
Key	string	Não	A condição de filtro. Você pode usar condições de filtro para filtrar as instâncias de pacotes de largura de banda a serem consultadas. As seguintes condições de filtro são suportadas: CenId: O ID da instância da Cloud Enterprise Network (CEN). Status: O status da instância do pacote de largura de banda. Valores válidos: Idle: Não associado. InUse: Associado. CenBandwidthPackageId: O ID do pacote de largura de banda. Name: O nome do pacote de largura de banda. Você pode especificar uma ou mais condições de filtro. O valor máximo de N é 5.	CenId
Value	array	Não	Os valores de filtro com base na Key especificada. Você pode especificar vários valores de filtro para uma única Key. Os valores de filtro têm uma relação OR, o que significa que um pacote de largura de banda correspondente a qualquer um dos valores de filtro é considerado uma correspondência para a condição de filtro.	Idle
	string	Não	Os valores de filtro com base na Key especificada. Você pode especificar vários valores de filtro para uma única Key. Os valores de filtro têm uma relação OR, o que significa que um pacote de largura de banda correspondente a qualquer um dos valores de filtro é considerado uma correspondência para a condição de filtro.	cen-xxjsjfkffkfkfjkf****
Tag	array<object>	Não	A lista de informações de tags. Você pode especificar até 20 tags por vez.
	object	Não	As informações da tag. Você pode especificar até 20 tags por vez.
Key	string	Não	A chave da tag do recurso. Uma vez especificada, a chave da tag não pode ser uma string vazia. A chave da tag pode ter até 64 caracteres e não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`. Você pode especificar até 20 chaves de tag por vez.	TagKey
Value	string	Não	O valor da tag do recurso. O valor da tag pode ser vazio ou uma string de até 128 caracteres. Não pode começar com `aliyun` ou `acs:` e não pode conter `http://` ou `https://`. Cada chave de tag corresponde a um valor de tag. Você pode especificar até 20 valores de tag por vez.	TagValue

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
PageSize	integer	O número de entradas por página.	2
RequestId	string	O ID da solicitação.	9D7E2400-2755-4AF5-9B73-12565E4F73A0
PageNumber	integer	O número da página atual.	1
TotalCount	integer	O número total de entradas.	2
CenBandwidthPackages	object
CenBandwidthPackage	array<object>	Os detalhes do pacote de largura de banda.
	array<object>
ReservationActiveTime	string	A hora de expiração do upgrade temporário, no formato ISO 8601 (AAAA-MM-DDThh:mmZ).	2021-08-30T16:00Z
Status	string	Indica se o pacote de largura de banda está associado a uma instância CEN. Idle: Não associado. InUse: Associado.	InUse
CreationTime	string	A hora em que o pacote de largura de banda foi criado, no formato ISO 8601 (AAAA-MM-DDThh:mmZ).	2021-02-01T11:14Z
ReservationOrderType	string	O tipo de renovação com alteração de especificação. Valores válidos: TEMP_UPGRADE: Upgrade temporário. UPGRADE: Upgrade.	UPGRADE
BandwidthPackageChargeType	string	O método de cobrança do pacote de largura de banda.	PREPAY
CenBandwidthPackageId	string	O ID do pacote de largura de banda.	cenbwp-4c2zaavbvh5x****
ReservationInternetChargeType	string	O método de cobrança após a alteração da especificação.	PREPAY
GeographicRegionAId	string	O ID da área conectada a ser consultada. Valores válidos: china: China continental. asia-pacific: Ásia-Pacífico. europe: Europa. north-america: América do Norte.	china
Bandwidth	integer	A largura de banda de pico do pacote de largura de banda.	2
Description	string	A descrição do pacote de largura de banda.	cen
ExpiredTime	string	A hora de expiração do pacote de largura de banda, no formato ISO 8601 (AAAA-MM-DDThh:mmZ).	2021-09-08T16:00Z
ReservationBandwidth	string	A largura de banda que é restaurada após a expiração do upgrade temporário.	10
GeographicSpanId	string	O ID do par de áreas conectadas.	north-america_china
GeographicRegionBId	string	O ID da outra área conectada da instância do pacote de largura de banda. Valores válidos: china: China continental. asia-pacific: Ásia-Pacífico. europe: Europa. north-america: América do Norte.	north-america
ResourceGroupId	string	O ID do grupo de recursos.	rg-aekzoyr5k36****
IsCrossBorder	boolean	Indica se o pacote de largura de banda é um pacote de largura de banda transfronteiriço. false: O pacote de largura de banda não é um pacote de largura de banda transfronteiriço. true: O pacote de largura de banda é um pacote de largura de banda transfronteiriço.	false
BusinessStatus	string	O status do pacote de largura de banda. Normal: Normal. FinancialLocked: Bloqueado devido a pagamento em atraso. SecurityLocked: Bloqueado devido a motivos de segurança.	Normal
Name	string	O nome do pacote de largura de banda.	test
HasReservationData	string	Indica se existem dados de renovação. true: Existem dados de renovação. false: Não existem dados de renovação. Nota Este parâmetro é definido como true somente quando o parâmetro IncludeReservationData é definido como true e há dados de pedido pendentes que ainda não entraram em vigor.	false
OrginInterRegionBandwidthLimits	object
OrginInterRegionBandwidthLimit	array<object>	Os detalhes das regiões conectadas.
	object
BandwidthLimit	string	A largura de banda de pico entre as regiões conectadas.	1
OppositeRegionId	string	O ID da região par.	us-west-1
GeographicSpanId	string	As regiões conectadas.	north-america_china
LocalRegionId	string	O ID da região local.	cn-hangzhou
Tags	object
Tag	array<object>	As informações de tag do pacote de largura de banda.
	object	A lista de tags.
Key	string	A chave da tag.	TagKey
Value	string	O valor da tag.	TagValue
CenIds	object
CenId	array	A lista de instâncias CEN associadas ao pacote de largura de banda.
	string	O ID da instância CEN associada ao pacote de largura de banda.	cen-xxjsjfkffkfkfjkf****

Exemplos

Resposta de sucesso

JSON formato

{
  "PageSize": 2,
  "RequestId": "9D7E2400-2755-4AF5-9B73-12565E4F73A0",
  "PageNumber": 1,
  "TotalCount": 2,
  "CenBandwidthPackages": {
    "CenBandwidthPackage": [
      {
        "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",
        "ResourceGroupId": "rg-aekzoyr5k36****",
        "IsCrossBorder": false,
        "BusinessStatus": "Normal",
        "Name": "test",
        "HasReservationData": "false",
        "OrginInterRegionBandwidthLimits": {
          "OrginInterRegionBandwidthLimit": [
            {
              "BandwidthLimit": "1",
              "OppositeRegionId": "us-west-1",
              "GeographicSpanId": "north-america_china",
              "LocalRegionId": "cn-hangzhou"
            }
          ]
        },
        "Tags": {
          "Tag": [
            {
              "Key": "TagKey",
              "Value": "TagValue"
            }
          ]
        },
        "CenIds": {
          "CenId": [
            "cen-xxjsjfkffkfkfjkf****"
          ]
        }
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IllegalParam.TagValue	The tag values are not valid.	O valor da tag especificado na solicitação é inválido.
400	IllegalParam.TagKey	The tag keys are not valid.	A chave da tag especificada na solicitação é inválida.
400	InvalidParameter	Invalid parameter.	O parâmetro é inválido.
400	Unauthorized	The AccessKeyId is unauthorized.	A conta não tem permissão para realizar esta operação.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.