Adición o modificación de una etiqueta

Función

Esta API se utiliza para agregar una etiqueta a una imagen o modificar una etiqueta de una imagen. Con las etiquetas, puede gestionar fácilmente las imágenes.

URI

PUT /v1/cloudimages/tags

Solicitud

• Parámetros de solicitud

  Parámetro	Obligatorio	Tipo	Descripción
  image_id	Sí	String	Especifica el ID de imagen. Para obtener más información sobre cómo obtener el ID de imagen, consulte Consulta de imágenes.
  tag	No	String	Especifica la etiqueta. Usa tag o image_tag.
  image_tag	No	Object	Muestra las etiquetas de imagen. Para una descripción detallada, consulte Formatos de datos de etiquetas de imagen. Este parámetro se deja en blanco por defecto. Usa tag o image_tag.

  Tabla 1 Descripción de la estructura de datos del campo image_tag

  Parámetro	Obligatorio	Tipo	Descripción
  key	Sí	String	Especifica la clave de etiqueta.
  value	Sí	String	Especifica el valor de etiqueta.

• Ejemplo de solicitud
  • Solicitud de ejemplo que contiene parámetro tag

    PUT https://{Endpoint}/v1/cloudimages/tags

    1 2 3 4

    { "image_id": "62a15f6c-9197-44d2-89c7-708981c1bec1", "tag": "aaaa.1111" }

  • Ejemplo de solicitud que contiene parámetro image_tag

    PUT https://{Endpoint}/v1/cloudimages/tags

    1 2 3 4

    { "image_id": "67437ebd-2563-46e0-887e-ad1923977fa1", "image_tag": {"key":"key1","value":"value1"} }

Respuesta

• Parámetros de respuesta

  Ninguno

• Ejemplo de respuesta

  STATUS CODE 204

Valor devuelto

• Normal

  204

• Anormal

  Valor devuelto	Descripción
  400 Bad Request	Error de solicitud.
  401 Unauthorized	Error de autenticación.
  403 Forbidden	Usted no tiene los derechos para realizar la operación.
  404 Not Found	No se encontró el recurso solicitado.
  500 Internal Server Error	Error interno del servicio.
  503 Service Unavailable	El servicio no está disponible.