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