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