O passo 4: Chamar a API de entrega logs
Este artigo descreve como chamar a API de entrega logs . Esta é a última o passo na configuração de entrega logs de auditoria.
Para configurar a entrega log, o senhor deve chamar a entregalog API .
Valores necessários
Em sua chamada de API, especifique os seguintes valores que você copiou nas o passos anteriores:
credentials_id
: Seu ID de configuração de credenciais do Databricks, que representa suas credenciais de função entre contas.storage_configuration_id
: Seu ID de configuração de armazenamento do Databricks, que representa seu contêiner raiz S3.
Defina também os seguintes campos:
log_type
: Definido comoAUDIT_LOGS
.output_format
: Definido comoJSON
.delivery_path_prefix
(Opcional) Defina como o prefixo do caminho. Isso deve corresponder ao prefixo do caminho que o senhor usou na política de função. O caminho de entrega é<bucket-name>/<delivery-path-prefix>/workspaceId=<workspaceId>/date=<yyyy-mm-dd>/auditlogs_<internal-id>.json
. Se o senhor configurar a entrega de auditoria log para todo o account, os eventos de auditoria de nível accountque não estiverem associados a nenhum workspace serão entregues à partiçãoworkspaceId=0
.workspace_ids_filter
: (Opcional) Para garantir a entrega de eventos em nível de account , incluindo Unity Catalog e eventos de compartilhamento Delta, deixeworkspace_ids_filter
em branco. Se você deseja apenas logs para selecionar workspace, defina uma matriz de IDs workspace (cada um é umint64
). Se você adicionar IDs de espaço de trabalho específicos neste campo, não receberá logs em nível de accounte/ou logs para espaços de trabalho criados no futuro.
Exemplo de chamada de API
Aqui está um exemplo de chamada para a entrega log API:
curl -X POST
'https://accounts.cloud.databricks.com/api/2.0/accounts/<databricks-account-id>/log-delivery' \
--header 'Authorization: Bearer $OAUTH_TOKEN' \
-d '{
"log_delivery_configuration": {
"log_type": "AUDIT_LOGS",
"config_name": "audit log config",
"output_format": "JSON",
"credentials_id": "<databricks-credentials-id>",
"storage_configuration_id": "<databricks-storage-config-id>",
"delivery_path_prefix": "auditlogs-data",
"workspace_ids_filter": [
6383650456894062,
4102272838062927
]
}
}'
Resposta de exemplo:
{
"log_delivery_configuration": {
"config_id": "<config-id>",
"config_name": "audit log config",
"log_type": "AUDIT_LOGS",
"output_format": "JSON",
"account_id": "<account-id>",
"credentials_id": "<databricks-credentials-id>",
"storage_configuration_id": "<databricks-storage-config-id>",
"workspace_ids_filter": [
6383650456894062,
4102272838062927
],
"delivery_path_prefix": "auditlogs-data",
"status": "ENABLED",
"creation_time": 1591638409000,
"update_time": 1593108904000,
"log_delivery_status": {
"status": "CREATED",
"message": "Log Delivery Configuration is successfully created. Status will be updated after the first delivery attempt."
}
}
}
Observação
Após a configuração inicial ou outras alterações na configuração de entrega do log, espere um atraso de até uma hora até que as alterações entrem em vigor. Após o início do fornecimento de registros, os eventos auditáveis são normalmente registrados em 15 minutos.
Próximos passos
Depois de configurar o fornecimento de log de auditoria, saiba mais sobre o esquema de log e os logs disponíveis consultando a Referência de log de auditoria.