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/ VPC Endpoint/ Referência de API/ API/ Pontos de extremidade da VPC/ Consulta de detalhes de um ponto de extremidade da VPC
Atualizado em 2023-02-20 GMT+08:00

Consulta de detalhes de um ponto de extremidade da VPC

Função

Função Essa API é usada para consultar detalhes sobre um ponto de extremidade da VPC.

URI

GET /v1/{project_id}/vpc-endpoints/{vpc_endpoint_id}

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatoriedade

Tipo

Descrição

project_id

Sim

String

ID do projeto.

Mínimo: 1

Máximo: 64

vpc_endpoint_id

Sim

String

Especifica o ID do ponto de extremidade da VPC.

Mínimo: 1

Máximo: 64

Parâmetros de solicitação

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

Parâmetro

Obrigatoriedade

Tipo

Descrição

X-Auth-Token

Sim

String

Especifica o token do usuário. Ele pode ser obtido chamando a API do IAM. O valor de X-Subject-Token no cabeçalho da resposta é o token do usuário.

Mínimo: 1

Máximo: 2048

Content-Type

Sim

String

Especifica o tipo MIME do corpo da solicitação. O valor padrão application/json é recomendado. Para as API usadas para carregar objetos ou imagens, o tipo MIME pode variar dependendo do tipo de fluxo.

Mínimo: 1

Máximo: 64

Parâmetros de resposta

Código de estado: 200

Tabela 3 Parâmetros de corpo da resposta

Parâmetro

Tipo

Descrição

id

String

Especifica o ID exclusivo do ponto de extremidade da VPC.

service_type

String

Especifica o tipo de serviço do ponto de extremidade da VPC associado ao ponto de extremidade da VPC. ● gateway: configurado pelo pessoal de O&M. Você pode usá-los diretamente sem criá-los por si mesmos. ● interface: inclui serviços em nuvem configurados pela equipe de O&M e serviços privados criados pelos usuários. Você não pode configurar esses serviços de nuvem, mas pode usá-los. Você pode consultar serviços públicos do ponto de extremidade da VPC para visualizar os serviços do ponto de extremidade da VPC visíveis e acessíveis a todos os usuários configurados pela equipe de O&M. Você também pode criar um serviço do ponto de extremidade da VPC de interface criando um do ponto de extremidade da VPC de VPC.

status

String

Especifica o status da conexão do ponto de extremidade da VPC. ●pendingAcceptance: a conexão do ponto de extremidade da VPC deve ser aceita. ● creating: a conexão do ponto de extremidade da VPC está sendo criada. ●accepted: a conexão do ponto de extremidade da VPC foi aceita. ● failed: a conexão do ponto de extremidade da VPC falhou.

active_status

Array of strings

Especifica o status da conta. ● frozen: a conta está congelada. ● active: a conta está descongelada.

enable_status

String

Especifica se o ponto de extremidade da VPC está disponível. ● enable: o ponto de extremidade da VPC está habilitado. ● disable: o ponto de extremidade da VPC está desativado.

specification_name

String

Especifica o nome da especificação do serviço do ponto de extremidade da VPC.

endpoint_service_name

String

Especifica o nome do serviço do ponto de extremidade da VPC.

marker_id

Integer

Especifica o ID do pacote do ponto de extremidade da VPC.

endpoint_service_id

String

Especifica o ID do serviço do ponto de extremidade da VPC.

enable_dns

Boolean

Especifica se deve ou não criar um nome de domínio. ● true: um nome de domínio é necessário. ● false: um nome de domínio não é necessário. Observação: quando você cria um ponto de extremidade da VPC para conectar um serviço de gateway do ponto de extremidade da VPC, nenhum nome de domínio é criado se enable_dns estiver definido como true ou false.

dns_names

Array of strings

Especifica o nome de domínio para acessar o serviço do ponto de extremidade da VPC associado. Este parâmetro só está disponível quando enable_dns é definido como true.

ip

String

Especifica o endereço IP para acessar o serviço do ponto de extremidade da VPC associado. Este parâmetro é retornado somente quando as seguintes condições são atendidas: ● Você consulta um ponto de extremidade da VPC para acessar um serviço de interface de ponto de extremidade da VPC. ● A função de aprovação de conexão está habilitada para o serviço do ponto de extremidade da VPC, e a conexão foi aprovada. O status do ponto de extremidade da VPC pode ser accepted ou rejected. O status rejected aparece apenas quando o ponto de extremidade da VPC é aceito e, em seguida, rejeitado.

vpc_id

String

Especifica o ID da VPC em que o ponto de extremidade da VPC será criado.

subnet_id

String

Especifica o ID da sub-rede na VPC com base em vpc_id. O ID está no formato UUID.

created_at

String

Especifica o horário de criação de ponto de extremidade da VPC. O formato de hora UTC aplicado é AAAA-MM-DDTHH:MM:SSZ.

updated_at

String

Especifica o horário de atualização de ponto de extremidade da VPC. O formato de hora UTC aplicado é AAAA-MM-DDTHH:MM:SSZ.

project_id

String

Especifica o ID do projeto. Para obter detalhes sobre como obter o ID de projeto, consulte "Obtenção de um ID de projeto".

tags

Array of TagList objects

Especifica a lista de tags. Se não houver nenhuma tag na lista, as tags serão tomadas como uma matriz vazia.

error

QueryError object

Informações de exceção retornadas durante a consulta de recursos.

whitelist

Array of strings

Especifica a lista branca para controlar o acesso ao ponto de extremidade da VPC. Se você não especificar este parâmetro, uma lista branca vazia é retornada. Esse parâmetro só está disponível quando você cria um ponto de extremidade da VPC para conectar-se a um serviço de gateway do ponto de extremidade da VPC.

enable_whitelist

Boolean

Especifica se deve ativar o isolamento da ACL de rede. ● true: o isolamento da ACL de rede está habilitado. ● false: o isolamento ACL de rede está desabilitado. Se você não especificar esse parâmetro, o isolamento da ACL de rede será desabilitado. Esse parâmetro só está disponível quando você cria um ponto de extremidade da VPC para conectar-se a um serviço de interface do ponto de extremidade da VPC.

routetables

Array of strings

Especifica os IDs das tabelas de rotas. Se você não especificar esse parâmetro, o ID da tabela de rotas da VPC será retornado. Esse parâmetro só está disponível quando você cria um ponto de extremidade da VPC para conectar-se a um serviço de gateway do ponto de extremidade da VPC.

description

String

Especifica o campo de descrição. O valor pode conter caracteres como letras e dígitos, mas não pode conter sinais menores (<) e sinais maiores (>).

policy_statement

Array of strings

Esse campo é exibido no corpo da resposta apenas para habilitar gateway do ponto de extremidade da VPC com portas fixas em ambas as extremidades.

Tabela 4 TagList

Parâmetro

Tipo

Descrição

key

String

Especifica a chave de tag. Uma chave de tag pode conter um máximo de 36 caracteres Unicode. Não pode ser deixado em branco. Não pode conter sinais iguais (=), asteriscos (*), sinais menores (<), sinais maiores (>), barras invertidas (), vírgulas (,), barras verticais (|) e barras (/), e o primeiro e último caracteres não podem ser espaços.

Mínimo: 1

Máximo: 36

value

String

Especifica a chave de tag. Um valor de tag contém um máximo de 43 caracteres Unicode e pode ser uma cadeia vazia. Não pode conter sinais iguais (=), asteriscos (*), sinais menores (<), sinais maiores (>), barras invertidas (), vírgulas (,), barras verticais (|) e barras (/), e o primeiro e último caracteres não podem ser espaços.

Mínimo: 1

Máximo: 43

Tabela 5 QueryError

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_message

String

Mensagem de erro.

Código de estado: 400

Tabela 6 Parâmetros de corpo da resposta

Parâmetro

Tipo

Descrição

error

Error object

Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa.

Tabela 7 Erro

Parâmetro

Tipo

Descrição

message

String

Descrição do erro da tarefa

code

String

Código de erro de uma exceção de tarefa.

Código de estado: 401

Tabela 8 Parâmetros de corpo da resposta

Parâmetro

Tipo

Descrição

error

Error object

Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa.

Tabela 9 Erro

Parâmetro

Tipo

Descrição

message

String

Descrição do erro da tarefa

code

String

Código de erro de uma exceção de tarefa.

Código de estado: 403

Tabela 10 Parâmetros de corpo da resposta

Parâmetro

Tipo

Descrição

error

Error object

Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa.

Tabela 11 Erro

Parâmetro

Tipo

Descrição

message

String

Descrição do erro da tarefa

code

String

Código de erro de uma exceção de tarefa.

Código de estado: 404

Tabela 12 Parâmetros de corpo da resposta

Parâmetro

Tipo

Descrição

error

Error object

Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa.

Tabela 13 Erro

Parâmetro

Tipo

Descrição

message

String

Descrição do erro da tarefa

code

String

Código de erro de uma exceção de tarefa.

Código de estado: 405

Tabela 14 Parâmetros de corpo da resposta

Parâmetro

Tipo

Descrição

error

Error object

Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa.

Tabela 15 Erro

Parâmetro

Tipo

Descrição

message

String

Descrição do erro da tarefa

code

String

Código de erro de uma exceção de tarefa.

Código de estado: 406

Tabela 16 Parâmetros de corpo da resposta

Parâmetro

Tipo

Descrição

error

Error object

Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa.

Tabela 17 Erro

Parâmetro

Tipo

Descrição

message

String

Descrição do erro da tarefa

code

String

Código de erro de uma exceção de tarefa.

Código de estado: 407

Tabela 18 Parâmetros de corpo da resposta

Parâmetro

Tipo

Descrição

error

Error object

Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa.

Tabela 19 Erro

Parâmetro

Tipo

Descrição

message

String

Descrição do erro da tarefa

code

String

Código de erro de uma exceção de tarefa.

Código de estado: 408

Tabela 20 Parâmetros de corpo da resposta

Parâmetro

Tipo

Descrição

error

Error object

Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa.

Tabela 21 Erro

Parâmetro

Tipo

Descrição

message

String

Descrição do erro da tarefa

code

String

Código de erro de uma exceção de tarefa.

Código de estado: 409

Tabela 22 Parâmetros de corpo da resposta

Parâmetro

Tipo

Descrição

error

Error object

Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa.

Tabela 23 Erro

Parâmetro

Tipo

Descrição

message

String

Descrição do erro da tarefa

code

String

Código de erro de uma exceção de tarefa.

Código de estado: 500

Tabela 24 Parâmetros de corpo da resposta

Parâmetro

Tipo

Descrição

error

Error object

Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa.

Tabela 25 Erro

Parâmetro

Tipo

Descrição

message

String

Descrição do erro da tarefa

code

String

Código de erro de uma exceção de tarefa.

Código de estado: 501

Tabela 26 Parâmetros de corpo da resposta

Parâmetro

Tipo

Descrição

error

Error object

Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa.

Tabela 27 Erro

Parâmetro

Tipo

Descrição

message

String

Descrição do erro da tarefa

code

String

Código de erro de uma exceção de tarefa.

Código de estado: 502

Tabela 28 Parâmetros de corpo da resposta

Parâmetro

Tipo

Descrição

error

Error object

Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa.

Tabela 29 Erro

Parâmetro

Tipo

Descrição

message

String

Descrição do erro da tarefa

code

String

Código de erro de uma exceção de tarefa.

Código de estado: 503

Tabela 30 Parâmetros de corpo da resposta

Parâmetro

Tipo

Descrição

error

Error object

Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa.

Tabela 31 Erro

Parâmetro

Tipo

Descrição

message

String

Descrição do erro da tarefa

code

String

Código de erro de uma exceção de tarefa.

Código de estado: 504

Tabela 32 Parâmetros de corpo da resposta

Parâmetro

Tipo

Descrição

error

Error object

Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa.

Tabela 33 Erro

Parâmetro

Tipo

Descrição

message

String

Descrição do erro da tarefa

code

String

Código de erro de uma exceção de tarefa.

Exemplo de solicitações

GET https://{endpoint}/v1/{project_id}/vpc-endpoints/4189d3c2-8882-4871-a3c2- d380272eed83

Exemplo de respostas

Código de estado: 200

O servidor processou a solicitação com sucesso.

{ "id" : "4189d3c2-8882-4871-a3c2-d380272eed83", "service_type" : "interface", "marker_id" : 16777337, "status" : "accepted", "vpc_id" : "4189d3c2-8882-4871-a3c2-d380272eed83", "enable_dns" : false, "endpoint_service_name" : "test123", "endpoint_service_id" : "test123", "project_id" : "6e9dfd51d1124e8d8498dce894923a0d", "whitelist" : [ "127.0.0.1" ], "enable_whitelist" : true, "created_at" : "2022-04-14T09:35:47Z", "updated_at" : "2022-04-14T09:36:47Z" }

Códigos de estado

Código de estado

Descrição

200

O servidor processou a solicitação com sucesso.

400

A solicitação não pôde ser entendida pelo servidor devido à sintaxe mal formada.

401

A página solicitada requer um nome de usuário e senha.

403

O servidor entendeu o pedido, mas está se recusando a cumpri-lo.

404

A página solicitada não foi encontrada.

405

O método especificado na linha de solicitação não é permitido para o recurso identificado pelo URI da solicitação.

406

O recurso identificado pela solicitação só é capaz de gerar entidades de resposta que tenham características de conteúdo não aceitáveis de acordo com os cabeçalhos de aceitação enviados na solicitação.

407

O cliente deve primeiro autenticar-se com o proxy.

408

O cliente não produziu uma solicitação dentro do tempo que o servidor estava preparado para esperar.

409

A solicitação não pôde ser concluída devido a um conflito com o estado atual do recurso.

500

Falhou ao concluir a solicitação. Anormalidade de serviço.

501

Falhou ao concluir a solicitação. O servidor não suporta a função solicitada.

502

Falhou ao concluir a solicitação. porque o servidor recebe uma resposta inválida.

503

Falhou ao concluir a solicitação. porque o sistema não está disponível.

504

Gateway expirou o tempo limite

Códigos de erro

Consulte Códigos de erro.