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.
Computação
Elastic Cloud Server
Bare Metal Server
Auto Scaling
Image Management Service
Dedicated Host
FunctionGraph
Cloud Phone Host
Huawei Cloud EulerOS
Redes
Virtual Private Cloud
Elastic IP
Elastic Load Balance
NAT Gateway
Direct Connect
Virtual Private Network
VPC Endpoint
Cloud Connect
Enterprise Router
Enterprise Switch
Global Accelerator
Gerenciamento e governança
Cloud Eye
Identity and Access Management
Cloud Trace Service
Resource Formation Service
Tag Management Service
Log Tank Service
Config
Resource Access Manager
Simple Message Notification
Application Performance Management
Application Operations Management
Organizations
Optimization Advisor
Cloud Operations Center
Resource Governance Center
Migração
Server Migration Service
Object Storage Migration Service
Cloud Data Migration
Migration Center
Cloud Ecosystem
KooGallery
Partner Center
User Support
My Account
Billing Center
Cost Center
Resource Center
Enterprise Management
Service Tickets
HUAWEI CLOUD (International) FAQs
ICP Filing
Support Plans
My Credentials
Customer Operation Capabilities
Partner Support Plans
Professional Services
Análises
MapReduce Service
Data Lake Insight
CloudTable Service
Cloud Search Service
Data Lake Visualization
Data Ingestion Service
GaussDB(DWS)
DataArts Studio
IoT
IoT Device Access
Outros
Product Pricing Details
System Permissions
Console Quick Start
Common FAQs
Instructions for Associating with a HUAWEI CLOUD Partner
Message Center
Segurança e conformidade
Security Technologies and Applications
Web Application Firewall
Host Security Service
Cloud Firewall
SecMaster
Anti-DDoS Service
Data Encryption Workshop
Database Security Service
Cloud Bastion Host
Data Security Center
Cloud Certificate Manager
Situation Awareness
Managed Threat Detection
Blockchain
Blockchain Service
Serviços de mídia
Media Processing Center
Video On Demand
Live
SparkRTC
Armazenamento
Object Storage Service
Elastic Volume Service
Cloud Backup and Recovery
Cloud Server Backup Service
Storage Disaster Recovery Service
Scalable File Service
Volume Backup Service
Data Express Service
Dedicated Distributed Storage Service
Containers
Cloud Container Engine
SoftWare Repository for Container
Application Service Mesh
Ubiquitous Cloud Native Service
Cloud Container Instance
Bancos de dados
Relational Database Service
Document Database Service
Data Admin Service
Data Replication Service
GeminiDB
GaussDB
Distributed Database Middleware
Database and Application Migration UGO
TaurusDB
Middleware
Distributed Cache Service
API Gateway
Distributed Message Service for Kafka
Distributed Message Service for RabbitMQ
Distributed Message Service for RocketMQ
Cloud Service Engine
EventGrid
Dedicated Cloud
Dedicated Computing Cluster
Aplicações de negócios
ROMA Connect
Message & SMS
Domain Name Service
Edge Data Center Management
Meeting
AI
Face Recognition Service
Graph Engine Service
Content Moderation
Image Recognition
Data Lake Factory
Optical Character Recognition
ModelArts
ImageSearch
Conversational Bot Service
Speech Interaction Service
Huawei HiLens
Developer Tools
SDK Developer Guide
API Request Signing Guide
Terraform
Koo Command Line Interface
Distribuição de conteúdo e computação de borda
Content Delivery Network
Intelligent EdgeFabric
CloudPond
Soluções
SAP Cloud
High Performance Computing
Serviços para desenvolvedore
ServiceStage
CodeArts
CodeArts PerfTest
CodeArts Req
CodeArts Pipeline
CodeArts Build
CodeArts Deploy
CodeArts Artifact
CodeArts TestPlan
CodeArts Check
Cloud Application Engine
MacroVerse aPaaS
KooPhone
KooDrive
Central de ajuda/ Direct Connect/ Referência de API/ API/ Interface virtual/ Consulta da lista de interfaces virtuais

Consulta da lista de interfaces virtuais

Atualizado em 2023-02-20 GMT+08:00

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.

Usamos cookies para aprimorar nosso site e sua experiência. Ao continuar a navegar em nosso site, você aceita nossa política de cookies. Saiba mais

Feedback

Feedback

Feedback

0/500

Conteúdo selecionado

Envie o conteúdo selecionado com o feedback