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> Virtual Private Network> Referência de API> APIs da VPN da edição profissional> Gateway de VPN> Atualização de um gateway de VPN

Atualizado em 2023-08-04 GMT+08:00

Ver PDF

Atualização de um gateway de VPN

Função

Essa API é usada para atualizar um gateway de VPN com um ID de gateway especificado.

URI

PUT /v5/{project_id}/vpn-gateways/{vgw_id}

**Tabela 1** Descrição do parâmetro
Parâmetro	Tipo	Obrigatório	Descrição
project_id	String	Sim	Especifica um ID do projeto. Você pode obter o ID do projeto, referindo-se a Obtenção do ID do projeto.
vgw_id	String	Sim	Especifica o ID de uma instância de gateway de VPN.

Solicitação

Parâmetros de solicitação

**Tabela 2** Parâmetros de solicitação
Parâmetro	Tipo	Obrigatório	Descrição
vpn_gateway	UpdateVgwRequestBodyContent	Sim	Especifica o objeto de gateway de VPN.

**Tabela 3** UpdateVgwRequestBodyContent
Parâmetro	Tipo	Obrigatório	Descrição
name	String	Não	Especifica o nome do gateway de VPN. O valor é uma cadeia de 1 a 64 caracteres, que pode conter dígitos, letras, sublinhados (_) e hifens (-).
local_subnets	Array of String	Não	Especifica uma sub-rede local. Essa sub-rede é uma sub-rede do lado da nuvem que precisa se comunicar com uma rede local por meio de uma VPN. Por exemplo, uma sub-rede local pode ser 192.168.52.0/24. Você pode definir esse parâmetro somente quando attachment_type estiver definido como vpc. Um máximo de 50 sub-redes locais podem ser configuradas para cada gateway de VPN.
master_eip_id	String	Não	Especifica o ID do novo EIP ativo a ser vinculado ao gateway de VPN. Antes de vincular um novo EIP, desvincule o EIP original do gateway de VPN referindo-se a Atualização de um EIP. O valor é um UUID contendo 36 caracteres. Você pode definir esse parâmetro somente quando network_type for definido como public.
slave_eip_id	String	Não	Especifica o ID do novo EIP em espera a ser vinculado ao gateway de VPN. Antes de vincular um novo EIP, desvincule o EIP original do gateway de VPN referindo-se a Atualização de um EIP. O valor é um UUID contendo 36 caracteres. Você pode definir esse parâmetro somente quando network_type for definido como public.

Exemplo de solicitação

PUT https://{Endpoint}/v5/{project_id}/vpn-gateways/{vgw_id}

{
    "vpn_gateway": {
        "name": "vpngw-4321",
        "local_subnets": [
            "192.168.0.0/24"
        ],
        "master_eip_id": "f1469b4a-****-****-****-bb7de91cf493",
        "slave_eip_id": "6ad8e297-****-****-****-da0f885ccb98"
    }
}

Resposta

Parâmetros de resposta

Código de status 200 retornado: operação bem-sucedida

**Tabela 4** Parâmetros no corpo da resposta
Parâmetro	Tipo	Descrição
vpn_gateway	ResponseVpnGateway	Especifica o objeto de gateway de VPN.
request_id	String	Especifica um ID da solicitação.

**Tabela 5** ResponseVpnGateway
Parâmetro	Tipo	Descrição
id	String	Especifica um ID de gateway de VPN. O valor é um UUID contendo 36 caracteres.
name	String	Especifica um nome de gateway de VPN. Se nenhum nome de gateway de VPN for especificado, o sistema gera um automaticamente. O valor é uma cadeia de 1 a 64 caracteres, que pode conter dígitos, letras, sublinhados (_) e hifens (-).
network_type	String	Especifica o tipo de rede do gateway de VPN. O valor pode ser public ou private. O valor padrão é public.
status	String	Especifica o status do gateway de VPN. Intervalo de valores: PENDING_CREATE: criando PENDING_UPDATE: atualizando PENDING_DELETE: excluindo ACTIVE: normal FAULT: anormal FREEZED: congelado
attachment_type	String	Especifica o modo de associação. O valor pode ser vpc ou er.
er_id	String	Especifica o ID da instância do roteador corporativo à qual o gateway de VPN se conecta. Este parâmetro está disponível somente quando attachment_type é definido como er.
vpc_id	String	Quando attachment_type é definido como vpc, vpc_id especifica o ID do serviço VPC associado ao gateway de VPN. Quando attachment_type é definido como er, vpc_id especifica o ID da VPC de acesso usada pelo gateway de VPN.
local_subnets	Array of String	Especifica uma sub-rede local. Essa sub-rede é uma sub-rede do lado da nuvem que precisa se comunicar com uma rede local por meio de uma VPN. Por exemplo, uma sub-rede local pode ser 192.168.52.0/24. Esse parâmetro está disponível somente quando attachment_type é definido como vpc.
connect_subnet	String	Especifica o ID da sub-rede da VPC usada pelo gateway de VPN.
bgp_asn	Long	Especifica o número do sistema autônomo do BGP do gateway de VPN.
flavor	String	Especifica as especificações do gateway de VPN. Intervalo de valores: V1G: a largura de banda máxima de encaminhamento é de 1 Gbit/s. V300: a largura de banda máxima de encaminhamento é de 300 Mbit/s.
availability_zone_ids	Array of String	Especifica a AZ em que o gateway de VPN é implementado. Este parâmetro está disponível quando uma AZ é especificada. Se nenhuma AZ for especificada, esse parâmetro estará disponível somente quando o gateway de VPN estiver no estado ACTIVE.
connection_number	Integer	Especifica o número máximo de conexões de VPN suportadas para o gateway de VPN
used_connection_number	Integer	Especifica o número de conexões de VPN que foram usadas pelo gateway de VPN.
used_connection_group	Integer	Especifica o número de grupos de conexão de VPN que foram usados pelo gateway de VPN. Um grupo de conexão consiste em duas conexões entre um gateway de cliente e um gateway de VPN. Por padrão, 10 grupos de conexão de VPN são incluídos gratuitamente com a compra de um gateway de VPN.
enterprise_project_id	String	Especifica um ID do projeto empresarial. O valor é um UUID contendo 36 caracteres. Se nenhum ID de projeto empresarial for especificado durante a criação do gateway de VPN, 0 será retornado, indicando que o recurso pertence ao projeto empresarial padrão. Observe que 0 não é o ID de um projeto empresarial existente.
master_eip	ResponseEip	Especifica o EIP ativo usado pelo gateway de VPN. Este parâmetro está disponível quando o gateway de VPN está no estado ACTIVE.
slave_eip	ResponseEip	Especifica o EIP em espera usado pelo gateway de VPN. Este parâmetro está disponível quando o gateway de VPN está no estado ACTIVE.
created_at	String	Especifica a hora em que o gateway de VPN é criado. Este parâmetro está disponível quando o gateway de VPN está no estado ACTIVE.
updated_at	String	Especifica a hora da última atualização. Este parâmetro está disponível quando o gateway de VPN está no estado ACTIVE.
access_vpc_id	String	Especifica o ID da VPC ativo usado pelo gateway de VPN. O valor é um UUID contendo 36 caracteres.
access_subnet_id	String	Especifica o ID da sub-rede na VPC de acesso usada pelo gateway de VPN. O valor é um UUID contendo 36 caracteres.
access_private_ips	Array of String	Especifica a lista de endereços IP privados utilizados pelo gateway de VPN para conectar a um gateway de cliente quando o tipo de rede é rede privada. Por exemplo, um único endereço IP privado pode ser 192.168.52.9. Este parâmetro só está disponível quando o network_type está definido como private.

**Tabela 6** ResponseEip
Parâmetro	Tipo	Descrição
id	String	Especifica um ID do EIP. O valor é um UUID contendo 36 caracteres. Se o projeto da empresa padrão for usado, 0 será retornado.
ip_version	Integer	Especifica a versão do EIP. O valor só pode ser 4, indicando endereço IPv4.
ip_billing_info	String	Especifica as informações do pedido do EIP. Este parâmetro está disponível apenas para EIPs anuais/mensais. O valor está no formato order_id:product_id:region_id:project_id, por exemplo: CS22******LIBIV:00301-**-0--0:br-iaas-odin1:0605768a**********c006c7e484aa
type	String	Especifica o tipo do EIP. Para o intervalo de valores, consulte o campo type na Tabela 7 em Atribuição de um EIP.
ip_address	String	Especifica um EIP, ou seja, um endereço IPv4 público. O valor é um endereço IPv4, por exemplo, 88.*.*.11.
charge_mode	String	Especifica o modo de cobrança de largura de banda de um EIP. Intervalo de valores: bandwidth: cobrado pela largura de banda traffic: cobrado pelo tráfego
bandwidth_id	String	Especifica o ID de largura de banda de um EIP. O valor é um UUID contendo 36 caracteres.
bandwidth_size	Integer	Especifica a largura de banda (Mbit/s) de um EIP. A largura de banda máxima do EIP varia de acordo com as regiões e depende do serviço EIP. Você pode enviar um tíquete de serviço para aumentar a largura de banda máxima do EIP em sua conta. O valor pode ser 5, 10, 20, 50, 100, 200, 300, 500 ou 1000.
bandwidth_name	String	Especifica o nome da largura de banda de um EIP. O valor é uma cadeia de 1 a 64 caracteres que pode conter dígitos, letras, sublinhados (_), hifens (-) e pontos (.).
bandwidth_billing_info	String	Especifica as informações de pedido de largura de banda do EIP. Este parâmetro está disponível apenas para EIPs anuais/mensais. O valor está no formato order_id:product_id:region_id:project_id, por exemplo: CS22******LIBIV:00301-**-0--0:br-iaas-odin1:0605768a**********c006c7e484aa

Exemplo de respostas

1. Resposta à solicitação de atualizar um gateway de VPN

{
    "vpn_gateway": {
        "id": "620d99b8-****-****-****-200b868f2d7d",
        "name": "vpngw-4321",
        "attachment_type": "vpc",
        "network_type": "public",
        "vpc_id": "cb4a631d-****-****-****-ca3fa348c36c",
        "local_subnets": [
            "192.168.0.0/24"
        ],
        "connect_subnet": "f5741286-****-****-****-2c82bd9ee114",
        "bgp_asn": 64512,
        "flavor": "V300",
        "availability_zone_ids": ["cn-south-1f", "cn-south-1e"],
        "connection_number": 200,
        "used_connection_number": 0,
        "used_connection_group": 0,
        "enterprise_project_id": "0",
        "master_eip": {
            "id": "f1469b4a-****-****-****-bb7de91cf493",
            "ip_version": 4,
            "type": "5_bgp",
            "ip_address": "88.***.***.102",
            "charge_mode": "bandwidth",
            "bandwidth_id": "cff40e5e-****-****-****-7366077bf097",
            "bandwidth_size": 300,
            "bandwidth_name": "vpngw-bandwidth-1391"
        },
        "slave_eip": {
            "id": "6ad8e297-****-****-****-da0f885ccb98",
            "ip_version": 4,
            "type": "5_bgp",
            "ip_address": "88.***.***.188",
            "charge_mode": "bandwidth",
            "bandwidth_id": "d290f1ee-****-****-****-d701748f0851",
            "bandwidth_size": 300,
            "bandwidth_name": "vpngw-bandwidth-1392"
        },
	"create_time": "2022-09-15T08:56:09.386Z",
        "update_time": "2022-09-15T11:13:13.677Z",
        "access_vpc_id": "0cf79a3f-****-****-****-d7ace626b0fa",
        "access_subnet_id": "f5741286-****-****-****-2c82bd9ee114",
    },
    "request_id": "33a2b77a-65f9-4fa0-90bd-4bd42038eb41"
}

2. Resposta retornada quando um gateway de VPN que está sendo criado falha ao ser atualizado

{
    "error_code":"VPN.0003",
    "error_msg":"resource (type=GATEWAY, ID=ff9bdca6-****-****-****-e4bcc1ea52bc) is not ready, currently CREATING",
    "request_id": "abafe41c-7744-41af-bf3d-4452872af799"
}