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

Ver PDF

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

{
  "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"
}