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/ Cloud Backup and Recovery/ Referencia de la API/ APIs de CBR/ Etiquetas/ Adición o eliminación por lotes de etiquetas de un almacén

Actualización más reciente 2023-02-03 GMT+08:00

Ver PDF

Adición o eliminación por lotes de etiquetas de un almacén

Función

Esta API se utiliza para agregar o eliminar etiquetas por lotes para una instancia especificada. TMS utiliza esta API para gestionar etiquetas de recursos de servicio. Un recurso puede tener un máximo de 10 etiquetas. Esta API es idempotente. Si hay claves duplicadas en el cuerpo de la solicitud al agregar etiquetas, se notifica un error. Si una etiqueta por agregar tiene la misma clave que una etiqueta existente, la etiqueta se agregará y sobrescribirá la etiqueta existente. Al eliminar etiquetas, puede cargar claves duplicadas. Al eliminar etiquetas, si algunas no existen, se considera que la eliminación se realiza correctamente por defecto. El conjunto de caracteres de las etiquetas no se verificará. Una clave y un valor pueden consistir individualmente en hasta 127 y 255 caracteres. Cuando elimina etiquetas, no puede faltar la estructura de etiquetas y la clave no puede dejarse en blanco ni ser una cadena vacía.

URI

POST /v3/{project_id}/vault/{vault_id}/tags/action

**Tabla 1** Parámetros de path
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	ID de proyecto
vault_id	Sí	String	ID de recurso

Parámetros de solicitud

**Tabla 2** Parámetros de body de solicitud
Parámetro	Obligatorio	Tipo	Descripción
tags	No	Array of Tag objects	Lista de etiquetas Esta lista no puede ser una lista vacía. La lista puede contener hasta 10 claves. Las claves de esta lista deben ser únicas.
sys_tags	No	Array of SysTag objects	Lista de etiquetas del sistema Este campo sólo está disponible para el permiso op_service. Elija este campo o tags. Actualmente, las llamadas TMS contienen solamente una estructura resource_tag. La clave se fija en as _sys_enterprise_project_id. El valor es el UUID o 0. El valor 0 indica el proyecto de empresa predeterminado. Actualmente, solo se admite la operación de creación.
action	Sí	String	Operación a realizar. El valor se puede establecer en create o delete solamente. Valores de enumeración: create delete

**Tabla 3** Tag
Parámetro	Obligatorio	Tipo	Descripción
key	Sí	String	Clave Puede contener un máximo de 36 caracteres. No puede ser una cadena vacía. Los espacios antes y después de una clave serán descartados. No puede contener los siguientes caracteres: ASCII (0-31), signos iguales (=), asteriscos (*), corchetes angulares izquierdos (<), corchetes angulares rectos (>), barras invertidas (), comas (,), barras verticales (\|), y barras inclinadas (/) Puede contener solo letras, dígitos, guiones (-) y guiones bajos (_).
value	No	String	Valor Es obligatorio cuando se agrega una etiqueta y opcional cuando se elimina una etiqueta. Puede contener un máximo de 43 caracteres. Puede ser una cadena vacía. Los espacios antes y después de un valor serán descartados. No puede contener los siguientes caracteres: ASCII (0-31), signos iguales (=), asteriscos (*), corchetes angulares izquierdos (<), corchetes angulares rectos (>), barras invertidas (), comas (,), barras verticales (\|), y barras inclinadas (/) Puede contener solo letras, dígitos, guiones (-) y guiones bajos (_).

**Tabla 4** SysTag
Parámetro	Obligatorio	Tipo	Descripción
key	Sí	String	Clave. Clave de la etiqueta del sistema, que se obtiene de la lista blanca y no se puede definir aleatoriamente. Actualmente, solo se admite el campo _sys_enterprise_project_id y el value correspondiente indica el ID del proyecto de empresa.
value	Sí	String	Valor. Actualmente, solo se utiliza el ID del proyecto de empresa. El ID predeterminado del proyecto de empresa es 0.

Parámetros de respuesta

Código de estado: 400

**Tabla 5** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_code	String	Para obtener más información, consulte Códigos de error.
error_msg	String	Mensaje de error

Solicitudes de ejemplo

Solicitud de ejemplo

POST  https://{endpoint}/v3/{project_id}/vault/{vault_id}/tags/action

{
  "tags" : [ {
    "key" : "string",
    "value" : "string"
  }, {
    "key" : "string1",
    "value" : "string2"
  } ],
  "action" : "create"
}