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/ Consulta de detalhes sobre um gateway virtual

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

Ver PDF

Consulta de detalhes sobre um gateway virtual

Função

Essa API é usada para consultar detalhes sobre um gateway virtual especificado.

URI

GET /v3/{project_id}/dcaas/virtual-gateways/{virtual_gateway_id}

**Tabela 1** Parâmetros de caminho
Parâmetro	Obrigatório	Tipo	Descrição
project_id	Sim	String	Especifica o ID do projeto.
virtual_gateway_id	Sim	String	Especifica o ID do gateway virtual.

**Tabela 2** Parâmetros de consulta
Parâmetro	Obrigatório	Tipo	Descrição
fields	Não	Array	Especifica a lista de campos a serem exibidos.

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
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 5** 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 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

Exemplos de solicitações

Consulta de um gateway virtual

GET https://{dc_endpoint}/v3/0605768a3300d5762f82c01180692873/dcaas/virtual-gateways/20082c1b-3c99-48d8-8e8c-116af5d7e9f0

Exemplo de respostas

Código de status: 200

{
  "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"
  },
  "request_id" : "765f7aaf8f2edd0e719de564ef72e2de"
}