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. Utilice tag u 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. Utilice tag u 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

• Adición o modificación de una etiqueta (parámetro: tags)

  1 2 3 4 5

  PUT https://{Endpoint}/v1/cloudimages/tags { "image_id": "62a15f6c-9197-44d2-89c7-708981c1bec1", "tag": "aaaa.1111" }

• Adición o modificación de una etiqueta (parámetro: image_tag)

  1 2 3 4 5

  PUT https://{Endpoint}/v1/cloudimages/tags { "image_id": "67437ebd-2563-46e0-887e-ad1923977fa1", "image_tag": {"key":"key1","value":"value1"} }

Respuesta

• Parámetros de respuesta

  Ninguna

• Ejemplo de respuesta.

  STATUS CODE 204

Valores devueltos

• 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.