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/TaurusDB/Referência de API/APIs (recomendadas)/Gerenciamento de instâncias/Consulta de um EIP
Atualizado em 2025-05-23 GMT+08:00
Ver PDF
Compartilhar

Consulta de um EIP

Função

Essa API é usada para consultar um EIP. Antes de chamar essa API:

URI

GET /v3/{project_id}/instances/{instance_id}/eip

Tabela 1 Parâmetros de URI

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

ID do projeto de um locatário numa região.

Para obter esse valor, consulte Obtenção de um ID de projeto.

instance_id

Sim

String

ID da instância.

Parâmetros de solicitação

Tabela 2 Parâmetros de cabeçalho de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

X-Auth-Token

Sim

String

Token do usuário.

Para obter o valor, chame a API para obtenção de um token de usuário.

O valor de X-Subject-Token no cabeçalho da resposta é o valor do token.

Content-Type

Sim

String

Tipo de conteúdo.

Valor: application/json

X-Language

Não

String

Linguagem.

Parâmetros de resposta

Código de status: 200

Tabela 3 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

can_enable_public_access

Não

Se o acesso público pode ser ativado.

id

String

ID do EIP.

type

String

Tipo de rede do EIP.

port_id

String

ID da porta.

public_ip_address

String

EIP.

private_ip_address

String

Endereço IP privado.

status

String

Status do EIP.

tenant_id

String

ID do locatário.

create_time

String

Hora de criação.

bandwidth_id

String

ID da largura de banda.

bandwidth_name

String

Nome da largura de banda.

bandwidth_size

String

Tamanho da largura de banda.

bandwidth_share_type

String

Tipo de largura de banda. O valor pode ser PER ou WHOLE.

profile

Object

Parâmetros adicionais, incluindo o ID do pedido e o ID do produto. Se profile não estiver vazio, o EIP será cobrado anualmente/mensalmente.

Código de status: 400

Tabela 4 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Mensagem de erro.

Código de status: 500

Tabela 5 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Mensagem de erro.

Exemplo de solicitação

Consulta de um EIP

GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/12a49c2dc32648df8dd25e2976f70180in07/eip

Exemplo de resposta

Código de status: 200

Bem-sucedido.

{
  "can_enable_public_access" : true,
  "id" : "45a0ed37-cfa7-4403-8aeb-d720b4e831cf",
  "type" : "5_bgp",
  "port_id" : "2c02dc5b-a136-4921-b7ad-27e084548616",
  "public_ip_address" : "10.83.35.151",
  "private_ip_address" : "172.16.1.137",
  "status" : "ACTIVE",
  "tenant_id" : "23a50154cf494ec9ad6883979a12db0a",
  "create_time" : "2024-04-09 13:42:11",
  "bandwidth_id" : "2a4b2bc5-2a0a-42df-8f13-2fbe3d8bbbb2",
  "bandwidth_name" : "bandwidth-d3f4",
  "bandwidth_size" : 1,
  "bandwidth_share_type" : "PER",
  "profile" : { }
}

Código de status

Código de status

Descrição

200

Bem-sucedido.

400

Erro do cliente.

500

Erro no servidor.

Código de erro

Para obter detalhes, consulte Códigos de erro.