Adición o eliminación de etiquetas en lotes
Función
Esta API se utiliza para agregar o eliminar etiquetas de una instancia de base de datos especificada en lotes. Antes de invocar a esta API:
- Aprender cómo autorizar y autenticarla.
- Obtenga la región y el punto de conexión requeridos.
URI
POST /v3/{project_id}/instances/{instance_id}/tags/action
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
project_id |
Sí |
String |
ID de proyecto de un tenant en una región. Para obtener este valor, vea Obtención de un ID de proyecto. |
instance_id |
Sí |
String |
ID de instancia, que es compatible con el formato UUID. |
Parámetros de solicitud
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
X-Auth-Token |
Sí |
String |
Token de usuario. Para obtener este valor, invoque a la API de IAM para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el valor del token. |
X-Language |
No |
String |
Tipo de idioma de solicitud. El valor predeterminado es en-us. Valores:
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
action |
Sí |
String |
Acción. Valores:
|
tags |
Sí |
Array of TagItem objects |
Lista de etiquetas. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
key |
Sí |
String |
Clave de etiqueta. Contiene un máximo de 36 caracteres Unicode y no puede ser nulo, una cadena vacía o un espacio. Solo se permiten dígitos, letras mayúsculas, letras minúsculas, guiones bajos (_), y guiones (-). |
value |
No |
String |
Valor de etiqueta. Contiene un máximo de 43 caracteres Unicode. Puede ser una cadena vacía pero no puede ser un espacio. Solo se permiten dígitos, letras mayúsculas, letras minúsculas, guiones bajos (_), puntos y guiones (-).
|
Parámetros de respuesta
Código de estado: 400
Parámetro |
Tipo |
Descripción |
---|---|---|
error_code |
String |
Código de error. |
error_msg |
String |
Mensaje de error. |
Código de estado: 500
Parámetro |
Tipo |
Descripción |
---|---|---|
error_code |
String |
Código de error. |
error_msg |
String |
Mensaje de error. |
Solicitud de ejemplo
- Adición de etiquetas en lotes
POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/61a4ea66210545909d74a05c27a7179ein07/tags/action { "action" : "create", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key2", "value" : "value2" } ] }
- Eliminación de etiquetas en lotes
POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/61a4ea66210545909d74a05c27a7179ein07/tags/action { "action" : "delete", "tags" : [ { "key" : "key1" }, { "key" : "key2", "value" : "value2" } ] }
Ejemplo de respuesta
Ninguna
Código de estado
Para más detalles, véase Códigos de estado.
Código de error
Para más detalles, véase Códigos de error.