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/ Scalable File Service/ Referencia de la API/ Las API/ Gestión de etiquetas/ Adición por lotes de las etiquetas a un recurso
Actualización más reciente 2026-08-28 GMT+08:00

Adición por lotes de las etiquetas a un recurso

Función

Esta API se utiliza para agregar etiquetas por lotes a un sistema de archivos de uso general. Puede agregar hasta 20 etiquetas a un recurso.

Autorización

Cada cuenta tiene todos los permisos necesarios para invocar todas las API, pero los usuarios de IAM deben tener los permisos requeridos específicamente asignados. Para conocer los permisos específicos requeridos, consulte Políticas de permisos y acciones admitidas.

URI

  • POST /v3/sfs/tms/{project_id}/file-systems/{resource_id}/tags/create
  • Descripción del parámetro

    Parámetro

    Obligatorio

    Tipo

    Descripción

    project_id

    Sí

    String

    El ID del proyecto. Para obtener más información, consulte Obtención de un ID de proyecto.

    resource_id

    Sí

    String

    El ID del recurso, que es el nombre de un sistema de archivos de uso general.

Parámetros de solicitud

Tabla 1 Parámetros de encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

Content-type

Sí

String

El tipo MIME del cuerpo de la solicitud.

Ejemplo: application/json

X-Auth-Token

No

String

El token de usuario.

Tabla 2 Parámetros del cuerpo de solicitud

Parámetro

Obligatorio

Tipo

Descripción

tags

No

List<resource_tag>

La lista de etiquetas. Para obtener más detalles, consulte Tabla 3.

Este parámetro es obligatorio para los tenants comunes.

Utilice tags o sys_tags si tiene los permisos op_service.

sys_tags

No

List<resource_tag>

La lista de etiquetas del sistema. Este parámetro solo está disponible para los permisos op_service.

Utilice tags o sys_tags si tiene los permisos op_service.

Actualmente, solo se utiliza una estructura resource_tag al invocar TMS.

La clave se fija en _sys_enterprise_project_id.

El valor puede ser UUID o 0. 0 indica el proyecto de empresa predeterminado.

Solo se pueden agregar etiquetas del sistema.

Para obtener más detalles, consulte Tabla 3.

Tabla 3 resource_tag

Parámetro

Obligatorio

Tipo

Descripción

key

Sí

String

La clave de la etiqueta. Una clave de etiqueta puede contener un máximo de 128 caracteres. Puede contener letras, dígitos y espacios representables en UTF-8 y caracteres especiales (_.:=+-@). No puede comenzar ni finalizar con un espacio y no puede estar vacío. Las claves de etiqueta que comienzan con _sys_ son etiquetas del sistema y no puede comenzar una clave de etiqueta con _sys_.

value

Sí

String

El valor de la etiqueta. Un valor de etiqueta puede contener un máximo de 255 caracteres. Puede contener letras, dígitos y espacios representables en UTF-8 y caracteres especiales (_.:=+-@) y puede estar vacío. No puede comenzar ni finalizar con un espacio.

Parámetros de respuesta

Ninguno

Ejemplo de solicitud

Adición de etiquetas por lotes a un sistema de archivos de uso general cuyo nombre es bucketName con el ID de proyecto c80a2157ba1d46c0825265947342077c:

POST https://{endpoint}/v3/sfs/tms/c80a2157ba1d46c0825265947342077c/file-systems/bucketName/tags/create

Ejemplo de cuerpo de solicitud:

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

Ejemplo de respuesta

Ninguno

Códigos de estado

  • Normal

Código de estado

Descripción

204

Etiquetas de recursos agregadas en lote.

  • Anormal

Código de estado

Descripción

400

Parámetro de etiqueta no válido.

401

Error de certificación.

403

Error de autenticación.

404

Recurso no encontrado.

500

Error del sistema.