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/Gateway virtual/Criação de um gateway virtual
Atualizado em 2023-02-20 GMT+08:00
Ver PDF
Compartilhar

Criação de um gateway virtual

Função

Essa API é usada para criar um gateway virtual.

URI

POST /v3/{project_id}/dcaas/virtual-gateways

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_gateway

Não

CreateVirtualGateway object

Especifica parâmetros para a criação de um gateway virtual.

Tabela 4 CreateVirtualGateway

Parâmetro

Obrigatório

Tipo

Descrição

vpc_id

Sim

String

Especifica o ID da VPC conectada pelo gateway virtual.

name

Não

String

Especifica o nome do gateway virtual.

Mínimo: 0

Máximo: 64

description

Não

String

Fornece informações suplementares sobre o gateway virtual.

Mínimo: 0

Máximo: 128

local_ep_group

Sim

Array of strings

Especifica as sub-redes IPv4 conectadas pelo gateway virtual, que geralmente são os blocos CIDR de uma VPC.

local_ep_group_ipv6

Não

Array of strings

Especifica as sub-redes IPv6 conectadas pelo gateway virtual, que geralmente são os blocos CIDR de uma VPC. Este é um campo reservado.

bgp_asn

Não

Integer

Especifica o número do sistema autônomo (ASN) do BGP local do gateway virtual.

Mínimo: 1

Máximo: 4294967295

enterprise_project_id

Não

String

Especifica o ID do projeto empresarial ao qual o gateway virtual 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

virtual_gateway

VirtualGateway object

Especifica parâmetros para a criação de um gateway virtual.

request_id

String

Especifica o ID da solicitação.

Tabela 7 VirtualGateway

Parâmetro

Tipo

Descrição

id

String

Especifica o ID do gateway virtual.

vpc_id

String

Especifica o ID da VPC conectada pelo gateway virtual.

tenant_id

String

Especifica o ID do projeto ao qual a instância pertence.

Mínimo: 32

Máximo: 32

name

String

Especifica o nome do gateway virtual.

Mínimo: 0

Máximo: 64

description

String

Fornece informações suplementares sobre o gateway virtual.

Mínimo: 0

Máximo: 128

type

String

Especifica o tipo de gateway virtual. O valor só pode ser default.

Padrão: default

Valores de enumeração:

  • default

local_ep_group

Array of strings

Especifica as sub-redes IPv4 conectadas pelo gateway virtual, que geralmente são os blocos CIDR de uma VPC.

local_ep_group_ipv6

Array of strings

Especifica as sub-redes IPv6 conectadas pelo gateway virtual, que geralmente são os blocos CIDR de uma VPC. Este é um campo reservado.

admin_state_up

Boolean

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

Padrão: true

status

String

Especifica o status do gateway virtual, que pode ser ACTIVE, DOWN, BUILD, ERROR, PENDING_CREATE, PENDING_UPDATE ou PENDING_DELETE.

bgp_asn

Integer

Especifica o ASN do BGP local do gateway virtual.

Mínimo: 1

Máximo: 4294967295

enterprise_project_id

String

Especifica o ID do projeto empresarial ao qual o gateway virtual pertence.

Mínimo: 36

Máximo: 36

tags

Array of Tag objects

Especifica as tags.

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

Exemplos de solicitações

Criação de um gateway virtual

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

{
  "virtual_gateway" : {
    "name" : "vgw-c7b22",
    "description" : "",
    "vpc_id" : "6592c28e-95d7-4b0a-9f61-004fdf03420c",
    "bgp_asn" : 64512,
    "local_ep_group" : [ "192.168.1.0/24" ]
  }
}

Exemplo de respostas

Código de status: 201

CREATED

{
  "virtual_gateway" : {
    "id" : "20082c1b-3c99-48d8-8e8c-116af5d7e9f0",
    "name" : "vgw-c7b22",
    "description" : "",
    "tenant_id" : "0605768a3300d5762f82c01180692873",
    "vpc_id" : "6592c28e-95d7-4b0a-9f61-004fdf03420c",
    "type" : "default",
    "status" : "ACTIVE",
    "admin_state_up" : true,
    "bgp_asn" : 64512,
    "local_ep_group" : [ "192.168.1.0/24" ],
    "enterprise_project_id" : "0",
    "create_time" : "2022-08-19T11:28:06.000Z"
  },
  "request_id" : "765f7aaf8f2edd0e719de564ef72e2de"
}

Códigos de status

Código de status

Descrição

201

CREATED

Códigos de erro

Consulte Códigos de erro.

Tópico principal:Gateway virtual