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.

Nesta página

Mostrar todos

Central de ajuda/ VPC Endpoint/ Referência de API/ API/ Serviços do VPC Endpoint/ Essa API é usada para atualizar a descrição da conexão do ponto de extremidade da VPC.

Essa API é usada para atualizar a descrição da conexão do ponto de extremidade da VPC.

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

Ver PDF

Função

Função Essa API é usada para atualizar a descrição de um ponto de extremidade de VPC.

URI

PUT /v1/{project_id}/vpc-endpoint-services/{vpc_endpoint_service_id}/connections/description

**Tabela 1** Parâmetros de caminho
Parâmetro	Obrigatório	Tipo	Descrição
project_id	Sim	String	Especifica o ID do locatário. Mínimo: 36 Máximo: 64
vpc_endpoint_service_id	Sim	String	Especifica o ID do serviço do ponto de extremidade da VPC. Mínimo: 36 Máximo: 64

Parâmetros de solicitação

**Tabela 2** Parâmetros de corpo de solicitação
Parâmetro	Obrigatório	Tipo	Descrição
connections	Sim	Array of ConnectionsDesc objects	Especifica os campos de descrição do gerenciamento de conexão.

**Tabela 3** ConnectionsDesc
Parâmetro	Obrigatório	Tipo	Descrição
id	Sim	String	Especifica o ID do ponto de extremidade da VPC no formato UUID.
description	Sim	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 (>).

Parâmetros de resposta

Código de status: 200

**Tabela 4** Parâmetros de corpo de resposta
Parâmetro	Tipo	Descrição
connections	Array of ConnectionEndpoints objects	Lista de conexões

**Tabela 5** ConnectionEndpoints
Parâmetro	Tipo	Descrição
id	String	Especifica o ID exclusivo do ponto de extremidade da VPC.
marker_id	Integer	Especifica o ID do pacote do ponto de extremidade da VPC.
created_at	String	Especifica o horário de criação de ponto de extremidade da VPC. O formato de hora UTC aplicado é AAAA-MMDDTHH: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-MMDDTHH:MM:SSZ.
domain_id	String	ID de domínio de um usuário.
error	Array of QueryError objects	Especifica a mensagem de erro. Esse campo é retornado quando o ponto de extremidade da VPC é anormal, ou seja, o valor de status é failed.
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. ● rejected: a conexão do ponto de extremidade da VPC foi rejeitada. ● failed: a conexão do ponto de extremidade da VPC falhou. ● deleting: a conexão do ponto de extremidade da VPC está sendo criada.
description	String	Especifica a descrição de uma conexão do ponto de extremidade da VPC.

**Tabela 6** QueryError
Parâmetro	Tipo	Descrição
error_code	String	Código de erro.
error_message	String	Mensagem de erro.

Código de status: 400

**Tabela 7** Parâmetros de corpo de 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 8** 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 status: 401

**Tabela 9** Parâmetros de corpo de 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 10** 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 status: 403

**Tabela 11** Parâmetros de corpo de 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 12** 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 status: 404

**Tabela 13** Parâmetros de corpo de 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 14** 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 status: 405

**Tabela 15** Parâmetros de corpo de 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 16** 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 status: 406

**Tabela 17** Parâmetros de corpo de 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 18** 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 status: 407

**Tabela 19** Parâmetros de corpo de 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 20** 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 status: 408

**Tabela 21** Parâmetros de corpo de 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 22** 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 status: 409

**Tabela 23** Parâmetros de corpo de 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 24** 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 status: 500

**Tabela 25** Parâmetros de corpo de 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 26** 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 status: 501

**Tabela 27** Parâmetros de corpo de 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 28** 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 status: 502

**Tabela 29** Parâmetros de corpo de 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 30** 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 status: 503

**Tabela 31** Parâmetros de corpo de 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 32** 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 status: 504

**Tabela 33** Parâmetros de corpo de 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 34** 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.

Exemplos de solicitações

https://{endpoint}/v1/{project_id}/vpc-endpoint-services/813d9300-8473-405b-bfcd-f711117bad65/connections/description

{
  "connections" : [ {
    "id" : "0df78897-35b0-4a93-ad17-0bc0585f546b",
    "description" : "Specifies the VPC endpoint 2, which belongs to account [0605767a3300d5762fb7c0186d9e1779]iaas_commonnet_odin_26."
  }, {
    "id" : "0d837f75-90d5-4528-bd11-5d974238ebca",
    "description" : "Specifies the VPC endpoint 2, which belongs to account [7876999999999]iaas_commonnet_odin_26."
  } ]
}

{
  "endpoint_service_name" : "test222_name_23432"
}

Exemplo de respostas

Código de status: 200

{
  "connections" : [ {
    "id" : "0d837f75-90d5-4528-bd11-5d974238ebca",
    "status" : "accepted",
    "description" : "Specifies the VPC endpoint 2, which belongs to account [0605767a3300d5762fb7c0186d9e1779]iaas_commonnet_odin_26.",
    "marker_id" : 302008767,
    "domain_id" : "05b5408a0a80d2b10f06c0184a774460",
    "created_at" : "2022-04-14T02:09:08Z",
    "updated_at" : "2022-04-14T07:55:40Z"
  }, {
    "id" : "0df78897-35b0-4a93-ad17-0bc0585f546b",
    "status" : "accepted",
    "description" : "Specifies the VPC endpoint 2, which belongs to account [0605767a3300d5762fb7c0186d9e1779]iaas_commonnet_odin_26.",
    "marker_id" : 302001833,
    "domain_id" : "05b5408a0a80d2b10f06c0184a774460",
    "created_at" : "2022-04-14T01:59:31Z",
    "updated_at" : "2022-04-14T07:57:39Z"
  } ]
}

Códigos de status

Código de status	Descrição
200	O servidor processou a solicitação com sucesso.
400	O servidor falhou ao processar a solicitação.
401	Nome de usuário e senha são necessários para acessar a página solicitada.
403	O acesso à página solicitada é proibido.
404	O servidor não conseguiu encontrar a página solicitada.
405	O método especificado na solicitação não é permitido.
406	A resposta gerada pelo servidor não poderia ser aceita pelo cliente.
407	A autenticação de proxy é necessária antes que a solicitação seja processada.
408	A solicitação expirou o tempo limite.
409	A solicitação não pôde ser processada devido a um conflito.
500	Falhou na solicitação. Ocorreu um erro de serviço.
501	Falhou na solicitação. O servidor não suporta a função solicitada.
502	Falhou na solicitação. O servidor recebeu uma resposta inválida do servidor upstream.
503	Falhou na solicitação. O sistema não está disponível.
504	Gateway expirou o tempo limite.