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.
Actualización más reciente 2026-08-28 GMT+08:00

Consulta de etiquetas de un recurso

Función

Esta API se utiliza para consultar etiquetas de 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

  • GET /v3/sfs/tms/{project_id}/file-systems/{resource_id}/tags
  • 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.

Parámetros de respuesta

Tabla 2 Parámetros del cuerpo de respuesta

Parámetro

Obligatorio

Tipo

Descripción

tags

No

List<resource_tag>

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

sys_tags

No

List<resource_tag>

La lista de etiquetas del sistema. Este parámetro solo está disponible para los usuarios con el permiso op_service.

Actualmente, solo contiene una estructura de resource_tag.

key: _sys_enterprise_project_id

value: El ID de un proyecto de empresa. El valor 0 indica el proyecto de empresa predeterminado.

Para obtener más detalles, consulte Tabla 3.

Ejemplo de solicitud

Consulta de etiquetas de un sistema de archivos de uso general cuyo nombre es bucketName con el ID de proyecto c80a2157ba1d46c0825265947342077c:

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

Ejemplo de respuesta

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

Códigos de estado

  • Normal

Código de estado

Descripción

200

Se consultan las etiquetas de un recurso.

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