Agregar etiquetas por lotes a un sistema de archivos compartido
Función
Esta API se utiliza para agregar etiquetas por lotes a un sistema de archivos compartido.
Un sistema de archivos compartido puede tener un máximo de 10 etiquetas.
Las claves de varias etiquetas agregadas a un sistema de archivos compartido deben ser únicas.
Esta API es idempotente. Si la clave que se va a agregar ya se ha agregado al sistema de archivos compartido, la etiqueta se actualiza.
URI
- POST /v2/{project_id}/sfs/{share_id}/tags/action
- Descripción del parámetro
Parámetro
Obligatorio
Tipo
Descripción
project_id
Sí
String
Especifica el ID de proyecto del operador. Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.
share_id
Sí
String
Especifica el ID del sistema de archivos compartido.
Request Header
The operation message header is the same as that of a common request. For details, see Tabla 3.
Solicitud
- Descripción del parámetro
Parámetro
Obligatorio
Tipo
Descripción
action
Sí
String
Especifica el identificador de operación. Los valores posibles son create y delete. Utilice create para agregar etiquetas por lotes a un sistema de archivos compartido especificado.
tags
No
Array of resource_tags
Especifica la lista de etiquetas.
Este parámetro es obligatorio cuando se utiliza el permiso de inquilino. Para el permiso op_service, elija este campo o sys_tags.
sys_tags
No
Array of resource_tags
Especifica la lista de etiquetas del sistema.
Este campo solo está disponible para el permiso op_service. Elija este campo o tags.
Solo se utiliza una clave de estructura de etiqueta_recurso, _sys_enterprise_project_id, en las llamadas TMS.
El valor es ID o 0. El valor 0 indica el proyecto de empresa predeterminado.
- Descripción del campo resource_tag
Parámetro
Obligatorio
Tipo
Descripción
key
Sí
String
Especifica la clave de etiqueta. El valor puede contener un máximo de 36 caracteres. La clave no puede dejarse en blanco y no puede contener caracteres ASCII no imprimibles (0-31) o los siguientes caracteres: =*<>\,|/.
value
Sí
String
Especifica el valor de etiqueta. El valor contiene un máximo de 43 caracteres y puede ser una cadena vacía. No puede contener caracteres ASCII no imprimibles (0-31) o los siguientes caracteres: =*<>\,|/.
- Solicitud de ejemplo
{ "action": "create", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ] }
Códigos de estado
- Normal
- Anormal
Código de estado
Descripción
400 Bad Request
Valor no válido.
401 Unauthorized
Error de autenticación.
403 Forbidden
El acceso a la página solicitada está prohibido.
404 Not Found
No se encontró el recurso solicitado.
500 Internal Server Error
La solicitud no se completa debido a un error de servicio.