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/ Criação de uma interface virtual

Criação de uma interface virtual

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

Função

Essa API é usada para criar uma interface virtual.

URI

POST /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.

Parâmetros de solicitação

Tabela 2 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

Tabela 3 Parâmetros de corpo de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

virtual_interface

Sim

CreateVirtualInterface object

Especifica parâmetros para criar uma interface virtual.

Tabela 4 CreateVirtualInterface

Parâmetro

Obrigatório

Tipo

Descrição

name

Não

String

Especifica o nome da interface virtual.

Mínimo: 0

Máximo: 64

description

Não

String

Fornece informações complementares sobre a interface virtual.

Mínimo: 0

Máximo: 128

direct_connect_id

Não

String

Especifica o ID da conexão associada à interface virtual.

type

Sim

String

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

Valores de enumeração:

  • private
  • public

service_type

Não

String

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

Valores de enumeração:

  • vpc
  • VGW
  • GDWW
  • LGW

vlan

Sim

Integer

Especifica a VLAN do cliente a ser conectada.

Mínimo: 0

Máximo: 3999

bandwidth

Sim

Integer

Especifica a largura de banda da interface virtual.

Mínimo: 2

Máximo: 2147483647

local_gateway_v4_ip

Não

String

Especifica o endereço da interface IPv4 do gateway na nuvem. Este parâmetro é obrigatório se address_family estiver definido como um endereço IPv4.

remote_gateway_v4_ip

Não

String

Especifica o endereço de interface IPv4 do gateway na rede local. Este parâmetro é obrigatório se address_family estiver definido como um endereço IPv4.

address_family

Não

String

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

Padrão: ipv4

local_gateway_v6_ip

Não

String

Especifica o endereço da interface IPv6 do gateway na nuvem. Este parâmetro é obrigatório se address_family estiver definido como um endereço IPv6.

remote_gateway_v6_ip

Não

String

Especifica o endereço de interface IPv6 do gateway na rede local. Este parâmetro é obrigatório se address_family estiver definido como um endereço IPv6.

vgw_id

Sim

String

Especifica o ID do gateway virtual conectado pela interface virtual.

route_mode

Sim

String

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

Padrão: static

Valores de enumeração:

  • static
  • bgp

bgp_asn

Não

Integer

Especifica o ASN do par BGP no lado do cliente.

Mínimo: 1

Máximo: 4294967295

bgp_md5

Não

String

Especifica a senha de MD5 do par BGP.

remote_ep_group

Sim

Array of strings

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

service_ep_group

Não

Array of strings

Especifica as sub-redes que acedem aos serviços da Internet através de uma ligação direta.

enable_bfd

Não

Boolean

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

Padrão: false

enable_nqa

Não

Boolean

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

Padrão: false

lag_id

Não

String

Especifica a ID do LAG associado à interface virtual.

Mínimo: 36

Máximo: 36

resource_tenant_id

Não

String

Especifica o ID do projeto de outro locatário, que é usado para criar interfaces virtuais entre locatários.

enterprise_project_id

Não

String

Especifica o ID do projeto corporativo ao qual o recurso pertence.

Mínimo: 36

Máximo: 36

tags

Não

Array of Tag objects

Especifica as tags.

Tabela 5 Tag

Parâmetro

Obrigatório

Tipo

Descrição

key

Sim

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

Não

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

Parâmetros de resposta

Código de status: 201

Tabela 6 Parâmetros de corpo de resposta

Parâmetro

Tipo

Descrição

request_id

String

Especifica o ID da solicitação.

virtual_interface

VirtualInterface object

Especifica parâmetros para criar uma interface virtual.

Tabela 7 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 8 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 9 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 10 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.

Exemplos de solicitações

Criação de uma interface virtual

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

{
  "virtual_interface" : {
    "name" : "vif-0819",
    "description" : "mytest",
    "direct_connect_id" : "4673e339-8412-4ee1-b73e-2ba9cdfa54c1",
    "vgw_id" : "8a47064a-f34c-4f94-b7fe-cac456c9b37b",
    "vlan" : 332,
    "bandwidth" : 2,
    "local_gateway_v4_ip" : "1.1.1.1/30",
    "remote_gateway_v4_ip" : "1.1.1.2/30",
    "type" : "private",
    "route_mode" : "static",
    "remote_ep_group" : [ "1.1.2.0/30" ]
  }
}

Exemplo de respostas

Código de status: 201

CREATED

{
  "virtual_interface" : {
    "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,
    "device_id" : "18.9.215.131",
    "status" : "ACTIVE",
    "create_time" : "2022-08-19T11:28:06.000Z",
    "admin_state_up" : true,
    "rate_limit" : false,
    "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

201

CREATED

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