Eliminar datos de tabla

Esta API permite eliminar por lotes los registros especificados de las tablas de base de datos del Agent, con un límite máximo de 1000 registros por solicitud.

Método de solicitud

POST

URL de solicitud

https://api-${endpoint}/v2/database/delete/record

Autenticación

Para obtener detalles de autenticación, consulte la sección Autenticación en Visión general de la API.

Solicitud

Ejemplo de solicitud

curl -X POST 'https://api-${endpoint}/v2/database/delete/record' \ -H 'Authorization: Bearer ${API Key}' \ -H 'Content-Type: application/json' \ -d '{ "table_id": "673af861ed69656ac0895b07", "delete_data": [ { "record_id": "123456" }, { "filter": { "id": "789" } } ] }'

                      
                      curl -X POST 'https://api-${endpoint}/v2/database/delete/record' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
  "table_id": "673af861ed69656ac0895b07",
  "delete_data": [
    { "record_id": "123456" },
    { "filter": { "id": "789" } }
  ]
}'

Este bloque de código en una ventana flotante

Cabeceras de la solicitud

Campo	Tipo	Descripción
Authorization	Bearer ${API Key}	Se utiliza `Authorization: Bearer ${API Key}` para la autenticación. La clave de API se obtiene en la página «API Keys».
Content-Type	application/json	Tipo de contenido; debe ser `application/json`.

Cuerpo de la solicitud

Campo	Tipo	Obligatorio	Descripción
table_id	string	Sí	ID de la tabla.
delete_data	array	Sí	Lista de registros que se van a eliminar.
record_id	string	No	Se debe elegir `record_id` o la condición `filter`. Se recomienda `record_id`.
filter	map	No	Condiciones de filtro personalizadas (se deben usar campos de clave primaria únicos personalizados).

Nota: Se debe especificar record_id o la condición filter; se recomienda record_id. Si se proporcionan ambos, record_id tiene prioridad.

Respuesta

Ejemplo de respuesta

{ "code": 0, "message": "OK" }

                      
                      {
    "code": 0,
    "message": "OK"
}

Este bloque de código en una ventana flotante

Respuesta correcta

Campo	Tipo	Descripción
code	int	Código de respuesta que indica el tipo de mensaje.
message	string	Descripción del mensaje de respuesta.

Respuesta de error

Campo	Tipo	Descripción
code	int	Código de error.
message	string	Mensaje de error detallado.

Códigos de error

Código	Mensaje
40000	Parámetros no válidos
50000	Error interno del sistema
403106	No se encontró la tabla
403131	No tiene permiso para acceder a la tabla