Adición o eliminación de etiquetas de imagen en lotes

Función

Esta API se utiliza para agregar etiquetas a, actualizar etiquetas de, o eliminar etiquetas de una imagen en lotes.

Restricciones

• Cada etiqueta consta de una clave y un valor. La clave contiene como máximo 36 caracteres, y el valor contiene como máximo 43 caracteres. La clave no se puede dejar en blanco ni una cadena de caracteres vacía. El valor no se puede dejar en blanco, sino que puede ser una cadena de caracteres vacía.
• Una imagen puede tener un máximo de 10 etiquetas.
• Las claves de varias etiquetas en el cuerpo de la solicitud deben ser únicas.
• Esta API es idempotente.

  Si una etiqueta que se va a agregar tiene la misma clave que una etiqueta existente, pero los valores de la etiqueta son diferentes, esta etiqueta se agregará y sobrescribirá la existente. Si una etiqueta que se va a agregar tiene la misma clave y valor que una etiqueta existente, esta etiqueta no se agregará.

  Si la etiqueta especificada no existe, la eliminación se considera correcta de forma predeterminada.

• Restricciones en claves y valores de etiquetas durante la eliminación por lotes

  Durante la eliminación, el sistema no verificará el rango de juego de caracteres de la clave y el valor. La clave no se puede dejar en blanco ni una cadena de caracteres vacía. El valor es opcional y no se verificará. Si la etiqueta que se va a eliminar no existe, la eliminación se considera exitosa y no se reporta ningún error. Además, el sistema no verificará la longitud de la clave y el valor. La clave puede contener un máximo de 127 caracteres y el valor contiene un máximo de 255 caracteres.

URI

POST /v2/{project_id}/images/{image_id}/tags/action

Solicitud

• Parámetros de solicitud

  Parámetro	Obligatorio	Tipo	Descripción
  tags	Sí	Array of objects	Muestra las etiquetas que se van a agregar o eliminar. Para más detalles, consulte Tabla 2.
  action	Sí	String	Especifica la operación de etiqueta que se va a realizar. El valor distingue entre mayúsculas y minúsculas y se puede create o delete. create indica que las etiquetas se agregarán o actualizarán, mientras que delete indica que las etiquetas se eliminarán.

  Tabla 2 Descripción de la estructura de datos del campo de etiquetas

  Parámetro	Obligatorio	Tipo	Descripción
  key	Sí	String	Especifica la clave de etiqueta. La clave de etiqueta no se puede dejar en blanco.
  value	Sí	String	Especifica el valor de etiqueta.

• Ejemplo de solicitud
  • Adición de etiquetas de imagen por lotes

    POST https://{Endpoint}/v2/fd73a4a14a4a4dfb9771a8475e5198ea/images/67e17426-359e-49fb-aa12-0bd1756ec240/tags/action

    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

    { "tags": [{ "value": "value1", "key": "key1" }, { "value": "value2", "key": "key2" }, { "value": "", "key": "key3" }], "action": "create" }

  • Eliminación de etiquetas de imagen por lotes

    POST https://{Endpoint}/v2/fd73a4a14a4a4dfb9771a8475e5198ea/images/67e17426-359e-49fb-aa12-0bd1756ec240/tags/action

    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

    { "tags": [{ "value": "value1", "key": "key1" }, { "value": "value2", "key": "key2" }, { "value": "", "key": "key3" }], "action": "delete" }

Respuesta

• Parámetros de respuesta

  Ninguno

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