Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda> Direct Connect> Referência de API> API> Interface virtual> Consulta da lista de interfaces virtuais
Atualizado em 2023-02-20 GMT+08:00

Consulta da lista de interfaces virtuais

Função

Essa API é usada para consultar todas as interfaces virtuais de um locatário.

URI

GET /v3/{project_id}/dcaas/virtual-interfaces

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

Especifica o ID do projeto.

Tabela 2 Parâmetros de consulta

Parâmetro

Obrigatório

Tipo

Descrição

limit

Não

Integer

Especifica o número de registros retornados em cada página. Intervalo de valores: 1 a 2000

Mínimo: 1

Máximo: 2000

Padrão: 2000

marker

Não

String

Especifica o ID do último registro de recurso na página anterior. Se este parâmetro for deixado em branco, a primeira página será consultada. Este parâmetro deve ser usado junto com limit.

Mínimo: 0

Máximo: 36

fields

Não

Array

Especifica a lista de campos a serem exibidos.

sort_dir

Não

Array

Especifica a ordem de classificação dos resultados retornados, que pode ser asc (ordem crescente) ou desc (ordem decrescente). O valor padrão é asc.

sort_key

Não

String

Especifica o campo de classificação.

Padrão: created_at

Mínimo: 0

Máximo: 36

enterprise_project_id

Não

Array

Especifica o ID do projeto empresarial pela qual as redes centrais são filtradas.

id

Não

Array

Especifica o ID do recurso pelo qual as instâncias são filtradas.

status

Não

Array

Especifica o status pelo qual as instâncias são filtradas.

direct_connect_id

Não

Array

Especifica o ID de conexão pelo qual as conexões são filtradas e consultadas.

vgw_id

Não

Array

Especifica o ID do gateway virtual pelo qual os gateways virtuais são filtrados e consultados.

Parâmetros de solicitação

Tabela 3 Parâmetros do cabeçalho de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

X-Auth-Token

Sim

String

Especifica o token do usuário. Para obter o token, consulte a seção "Obtenção do token do usuário" na Referência de API do Identity and Access Management. O token é o valor de X-Subject-Token no cabeçalho de resposta.

Mínimo: 0

Máximo: 10240

Parâmetros de resposta

Código de status: 200

Tabela 4 Parâmetros de corpo de resposta

Parâmetro

Tipo

Descrição

request_id

String

Especifica o ID da solicitação.

virtual_interfaces

Array of VirtualInterface objects

Especifica parâmetros para criar uma interface virtual.

page_info

PageInfo object

Especifica as informações de consulta de paginação.

Tabela 5 VirtualInterface

Parâmetro

Tipo

Descrição

id

String

Especifica o ID da interface virtual.

Máximo: 36

name

String

Especifica o nome da interface virtual.

Máximo: 64

admin_state_up

Boolean

Especifica o status administrativo, que pode ser true ou false.

bandwidth

Integer

Especifica a largura de banda da interface virtual.

Mínimo: 2

Máximo: 2147483647

create_time

String

Especifica quando a interface virtual foi criada.

Máximo: 255

update_time

String

Especifica quando a interface virtual foi atualizada.

description

String

Fornece informações complementares sobre a interface virtual.

Máximo: 128

direct_connect_id

String

Especifica o ID de conexão.

Máximo: 36

service_type

String

Especifica o tipo de gateway, que pode ser VGW, GDGW ou LGW.

Valores de enumeração:

  • vpc
  • VGW
  • GDWW
  • LGW

status

String

Especifica o status operacional, que pode ser ACTIVE, DOWN, BUILD, ERROR, PENDING_CREATE, PENDING_UPDATE, PENDING_DELETE, DELETED, AUTHORIZATION ou REJECTED.

tenant_id

String

Especifica o ID do projeto.

Mínimo: 32

Máximo: 32

type

String

Especifica o tipo da interface virtual. O valor é private.

Padrão: private

Máximo: 255

Valores de enumeração:

  • private
  • public

vgw_id

String

Especifica o ID do gateway virtual.

Mínimo: 36

Máximo: 36

vlan

Integer

Especifica a VLAN para conexão com o gateway do usuário. O valor varia de 0 a 3999.

Mínimo: 0

Máximo: 3999

route_limit

Integer

Especifica as configurações de rota de sub-rede remota da interface virtual.

Mínimo: 1

Máximo: 200

Padrão: 50

enable_nqa

Boolean

Especifica se o NQA deve ser ativado. O valor pode ser true ou false.

enable_bfd

Boolean

Especifica se o BFD deve ser ativado. O valor pode ser true ou false.

lag_id

String

Especifica a ID do LAG associado à interface virtual.

Mínimo: 36

Máximo: 36

device_id

String

Especifica o ID do dispositivo ao qual a interface virtual pertence.

enterprise_project_id

String

Especifica o ID do projeto corporativo ao qual a interface virtual pertence.

Mínimo: 36

Máximo: 36

tags

Array of Tag objects

Especifica as tags.

vif_peers

Array of VifPeer objects

Especifica as informações de par da interface virtual.

extend_attribute

VifExtendAttribute object

Especifica informações de detecção de confiabilidade, como BFD ou NQA, sobre a interface virtual.

Tabela 6 Tag

Parâmetro

Tipo

Descrição

key

String

Especifica a chave de tag. A chave pode conter no máximo 36 caracteres Unicode, incluindo letras, dígitos, hifens (-) e sublinhados (_).

Mínimo: 0

Máximo: 36

value

String

Especifica o valor de tag. O valor pode conter no máximo 43 caracteres Unicode, incluindo letras, dígitos, hifens (-) sublinhados (_) e pontos (.).

Mínimo: 0

Máximo: 43

Tabela 7 VifPeer

Parâmetro

Tipo

Descrição

id

String

Especifica o ID do recurso.

Mínimo: 36

Máximo: 36

tenant_id

String

Especifica o ID do projeto ao qual o par de interface virtual pertence.

Mínimo: 36

Máximo: 36

name

String

Especifica o nome de par de interface virtual.

Mínimo: 0

Máximo: 64

description

String

Fornece informações suplementares sobre um par de interface virtual.

Mínimo: 0

Máximo: 128

address_family

String

Especifica o tipo de família de endereços da interface virtual, que pode ser IPv4 ou IPv6.

local_gateway_ip

String

Especifica o endereço do par de interface virtual usado na nuvem.

remote_gateway_ip

String

Especifica o endereço do par de interface virtual usado no data center local.

route_mode

String

Especifica o modo de roteamento, que pode ser static ou bgp.

Máximo: 255

Valores de enumeração:

  • bgp
  • static

bgp_asn

Integer

Especifica o ASN do par BGP.

Mínimo: 1

Máximo: 4294967295

bgp_md5

String

Especifica a senha de MD5 do par BGP.

remote_ep_group

Array of strings

Especifica a lista de sub-redes remotas, que registra os blocos CIDR usados no data center local.

service_ep_group

Array of strings

Especifica a lista de endereços de rede pública que podem ser acedidos pelo data center no local. Este campo é obrigatório nas APIs de conexões de rede públicas.

device_id

String

Especifica o ID do dispositivo ao qual o correspondente da interface virtual pertence.

bgp_route_limit

Integer

Especifica a configuração da rota BGP.

bgp_status

String

Especifica o status do protocolo BGP do correspondente da interface virtual. Se o par da interface virtual usar roteamento estático, o status será null.

Máximo: 10

status

String

Especifica o status do par da interface virtual.

vif_id

String

Especifica o ID da interface virtual correspondente ao par da interface virtual.

Mínimo: 36

Máximo: 36

Tabela 8 VifExtendAttribute

Parâmetro

Tipo

Descrição

ha_type

String

Especifica o tipo de detecção de disponibilidade da interface virtual.

Valores de enumeração:

  • nqa
  • bfd

ha_mode

String

Especifica o modo de detecção de disponibilidade.

Valores de enumeração:

  • auto_single
  • auto_multi
  • static_single
  • static_multi
  • enhance_nqa

detect_multiplier

Integer

Especifica o número de tentativas de detecção.

Padrão: 5

min_rx_interval

Integer

Especifica o intervalo para receber pacotes de detecção.

Padrão: 1000

min_tx_interval

Integer

Especifica o intervalo para o envio de pacotes de detecção.

Padrão: 1000

remote_disclaim

Integer

Especifica o identificador remoto da sessão BFD estática.

local_disclaim

Integer

Especifica o identificador local da sessão BFD estática.

Tabela 9 PageInfo

Parâmetro

Tipo

Descrição

previous_marker

String

Especifica o marcador da página anterior. O valor é o UUID do recurso.

Mínimo: 0

Máximo: 36

current_count

Integer

Especifica o número de recursos na lista atual.

Mínimo: 0

Máximo: 2000

next_marker

String

Especifica o marcador da próxima página. O valor é o UUID do recurso. Se o valor estiver vazio, o recurso está na última página.

Mínimo: 0

Máximo: 36

Exemplos de solicitações

Consulta da lista de interfaces virtuais

GET https://{dc_endpoint}/v3/0605768a3300d5762f82c01180692873/dcaas/virtual-interfaces

Exemplo de respostas

Código de status: 200

OK

{
  "virtual_interfaces" : [ {
    "id" : "0d0fdf63-f2c4-491c-8866-d504796189be",
    "name" : "vif-0819",
    "description" : "mytest",
    "tenant_id" : "0605768a3300d5762f82c01180692873",
    "direct_connect_id" : "4673e339-8412-4ee1-b73e-2ba9cdfa54c1",
    "vgw_id" : "8a47064a-f34c-4f94-b7fe-cac456c9b37b",
    "type" : "private",
    "service_type" : "VGW",
    "vlan" : 332,
    "bandwidth" : 2,
    "status" : "ACTIVE",
    "create_time" : "2022-08-19T11:28:06.000Z",
    "admin_state_up" : true,
    "enable_bfd" : false,
    "route_limit" : 50,
    "enable_nqa" : false,
    "vif_peers" : [ {
      "id" : "c768eb52-12a8-4859-9b43-81194643040c",
      "tenant_id" : "0605768a3300d5762f82c01180692873",
      "name" : "vif-0819",
      "description" : "",
      "address_family" : "ipv4",
      "local_gateway_ip" : "1.1.1.1/30",
      "remote_gateway_ip" : "1.1.1.2/30",
      "route_mode" : "static",
      "bgp_asn" : null,
      "bgp_md5" : null,
      "device_id" : "18.9.215.131",
      "bgp_route_limit" : 100,
      "bgp_status" : null,
      "status" : "ACTIVE",
      "vif_id" : "0d0fdf63-f2c4-491c-8866-d504796189be",
      "remote_ep_group" : [ "1.1.2.0/30" ],
      "service_ep_group" : null
    } ],
    "enterprise_project_id" : "0"
  } ],
  "request_id" : "5633df7af874576d819a481c76673236"
}

Códigos de status

Código de status

Descrição

200

OK

Códigos de erro

Consulte Códigos de erro.