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/ Image Management Service/ Referencia de la API/ Las API de IMS/ Etiquetado de imagen/ Adición de una etiqueta de imagen

Actualización más reciente 2022-11-07 GMT+08:00

Ver PDF

Adición de una etiqueta de imagen

Función

Esta API se utiliza para agregar una etiqueta a una imagen o actualizar una etiqueta.

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.
Esta API es una API 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á.

URI

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

Tabla 1 enumera los parámetros en el URI.

**Tabla 1** Descripción del parámetro
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	Especifica el ID del proyecto.
image_id	Sí	String	Especifica el ID de imagen.

Solicitud

Parámetros de solicitud

Parámetro	Obligatorio	Tipo	Descripción
tag	Sí	Object	Especifica la etiqueta que se va a agregar o actualizar. Para más detalles, consulte Tabla 2.

**Tabla 2** Descripción de la estructura de datos del campo de etiqueta
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

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

      
           {
   "tag": {
      "value": "value1",
      "key": "key1"
   }
}

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.