Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda> VPC Endpoint> Referencia de la API> API> Servicios de punto de conexión de VPC> Esta API se utiliza para actualizar la descripción de la conexión de punto de conexión de VPC.

Actualización más reciente 2023-01-06 GMT+08:00

Ver PDF

Esta API se utiliza para actualizar la descripción de la conexión de punto de conexión de VPC.

Función

Esta API se utiliza para actualizar la descripción de un punto de conexión de VPC.

URI

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

**Tabla 1** Parámetros de ruta
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	Especifica el ID del inquilino. Mínimo: 36 Máximo: 64
vpc_endpoint_service_id	Sí	String	Especifica el ID del servicio de punto de conexión de VPC. Mínimo: 36 Máximo: 64

Parámetros de solicitud

**Tabla 2** Parámetros del cuerpo de solicitud
Parámetro	Obligatorio	Tipo	Descripción
connections	Sí	Matriz de objetos de ConnectionsDesc	Especifica los campos de descripción de la administración de conexiones.

**Tabla 3** ConnectionsDesc
Parámetro	Obligatorio	Tipo	Descripción
id	Sí	String	Especifica el ID de punto de conexión de VPC en formato UUID.
description	Sí	String	Especifica el campo de descripción. El valor puede contener caracteres como letras y dígitos, pero no puede contener signos menores que (<) ni mayores que (>).

Parámetros de respuesta

Código de estado: 200

**Tabla 4** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
connections	Matriz de objetos de ConnectionEndpoints	Lista de conexiones

**Tabla 5** ConnectionEndpoints
Parámetro	Tipo	Descripción
id	String	Especifica el ID único del punto de conexión de VPC.
marker_id	Integer	Especifica el ID de paquete del punto de conexión de VPC.
created_at	String	Especifica la hora de creación del punto de conexión de VPC. El formato de hora UTC aplicado es AAAA-MMDDTHH:MM:SSZ.
updated_at	String	Especifica la hora de actualización del punto de conexión de VPC. El formato de hora UTC aplicado es AAAA-MMDDTHH:MM:SSZ.
domain_id	String	ID de dominio de un usuario.
error	Matriz de objetos de QueryError	Especifica el mensaje de error. Este campo se devuelve cuando el punto de conexión de VPC es anormal, es decir, el valor de status es failed.
status	String	Especifica el estado de conexión del punto de conexión de VPC. ● pendingAcceptance: La conexión de punto de conexión de VPC debe ser aceptada. ● creating: Se está creando la conexión de punto de conexión de VPC. ● accepted: Se ha aceptado la conexión de punto de conexión de VPC. ● rechazado: Se ha rechazado la conexión de punto de conexión de VPC. ● failed: Error en la conexión de punto de conexión de VPC. ● deleting: se está eliminando la conexión de punto de conexión de VPC.
description	String	Especifica la descripción de una conexión de punto de conexión de VPC.

**Tabla 6** QueryError
Parámetro	Tipo	Descripción
error_code	String	Código de error.
error_message	String	Mensaje de error.

Código de estado: 400

**Tabla 7** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error	Objeto de Error	Especifica el mensaje de error devuelto cuando se produce una excepción de envío de tareas.

**Tabla 8** Error
Parámetro	Tipo	Descripción
message	String	Descripción de error de tarea
code	String	Código de error de una excepción de tarea.

Código de estado: 401

**Tabla 9** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error	Objeto de Error	Especifica el mensaje de error devuelto cuando se produce una excepción de envío de tareas.

**Tabla 10** Error
Parámetro	Tipo	Descripción
message	String	Descripción de error de tarea
code	String	Código de error de una excepción de tarea.

Código de estado: 403

**Tabla 11** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error	Objeto de Error	Especifica el mensaje de error devuelto cuando se produce una excepción de envío de tareas.

**Tabla 12** Error
Parámetro	Tipo	Descripción
message	String	Descripción de error de tarea
code	String	Código de error de una excepción de tarea.

Código de estado: 404

**Tabla 13** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error	Objeto de Error	Especifica el mensaje de error devuelto cuando se produce una excepción de envío de tareas.

**Tabla 14** Error
Parámetro	Tipo	Descripción
message	String	Descripción de error de tarea
code	String	Código de error de una excepción de tarea.

Código de estado: 405

**Tabla 15** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error	Objeto de Error	Especifica el mensaje de error devuelto cuando se produce una excepción de envío de tareas.

**Tabla 16** Error
Parámetro	Tipo	Descripción
message	String	Descripción de error de tarea
code	String	Código de error de una excepción de tarea.

Código de estado: 406

**Tabla 17** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error	Objeto de Error	Especifica el mensaje de error devuelto cuando se produce una excepción de envío de tareas.

**Tabla 18** Error
Parámetro	Tipo	Descripción
message	String	Descripción de error de tarea
code	String	Código de error de una excepción de tarea.

Código de estado: 407

**Tabla 19** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error	Objeto de Error	Especifica el mensaje de error devuelto cuando se produce una excepción de envío de tareas.

**Tabla 20** Error
Parámetro	Tipo	Descripción
message	String	Descripción de error de tarea
code	String	Código de error de una excepción de tarea.

Código de estado: 408

**Tabla 21** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error	Objeto de Error	Especifica el mensaje de error devuelto cuando se produce una excepción de envío de tareas.

**Tabla 22** Error
Parámetro	Tipo	Descripción
message	String	Descripción de error de tarea
code	String	Código de error de una excepción de tarea.

Código de estado: 409

**Tabla 23** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error	Objeto de Error	Especifica el mensaje de error devuelto cuando se produce una excepción de envío de tareas.

**Tabla 24** Error
Parámetro	Tipo	Descripción
message	String	Descripción de error de tarea
code	String	Código de error de una excepción de tarea.

Código de estado: 500

**Tabla 25** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error	Objeto de Error	Especifica el mensaje de error devuelto cuando se produce una excepción de envío de tareas.

**Tabla 26** Error
Parámetro	Tipo	Descripción
message	String	Descripción de error de tarea
code	String	Código de error de una excepción de tarea.

Código de estado: 501

**Tabla 27** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error	Objeto de Error	Especifica el mensaje de error devuelto cuando se produce una excepción de envío de tareas.

**Tabla 28** Error
Parámetro	Tipo	Descripción
message	String	Descripción de error de tarea
code	String	Código de error de una excepción de tarea.

Código de estado: 502

**Tabla 29** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error	Objeto de Error	Especifica el mensaje de error devuelto cuando se produce una excepción de envío de tareas.

**Tabla 30** Error
Parámetro	Tipo	Descripción
message	String	Descripción de error de tarea
code	String	Código de error de una excepción de tarea.

Código de estado: 503

**Tabla 31** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error	Objeto de Error	Especifica el mensaje de error devuelto cuando se produce una excepción de envío de tareas.

**Tabla 32** Error
Parámetro	Tipo	Descripción
message	String	Descripción de error de tarea
code	String	Código de error de una excepción de tarea.

Código de estado: 504

**Tabla 33** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error	Objeto de Error	Especifica el mensaje de error devuelto cuando se produce una excepción de envío de tareas.

**Tabla 34** Error
Parámetro	Tipo	Descripción
message	String	Descripción de error de tarea
code	String	Código de error de una excepción de tarea.

Ejemplo de solicitudes

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"
}

Ejemplo de respuestas

Código de estado: 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 estado

Código de estado	Descripción
200	El servidor ha procesado correctamente la solicitud.
400	Se produjo un error en el servidor al procesar la solicitud.
401	Se requieren nombre de usuario y contraseña para acceder a la página solicitada.
403	El acceso a la página solicitada está prohibido.
404	El servidor no pudo encontrar la página solicitada.
405	El método especificado en la solicitud no está permitido.
406	El cliente no pudo aceptar la respuesta generada por el servidor.
407	Se requiere autenticación de proxy antes de procesar la solicitud.
408	Finalizó el tiempo de espera de la solicitud.
409	La solicitud no se pudo procesar debido a un conflicto.
500	Error de solicitud. Se ha producido un error de servicio.
501	Error de solicitud. El servidor no admite la función solicitada.
502	Error de solicitud. El servidor ha recibido una respuesta no válida del servidor ascendente.
503	Error de solicitud. El sistema no está disponible.
504	Finalizó el tiempo de espera del gateway.