Latest Content

How to List Available Clusters for Audit Logs

Updated on 29 July, 2026

List the object storage clusters available for an audit logs subscription on Vultr, including each cluster's region and S3-compatible hostname details.

Audit logs subscriptions store exported logs in object storage on a specific cluster. Each cluster corresponds to a Vultr Object Storage location. Selecting a cluster determines where your audit logs are physically stored and which s3_hostname you use to connect to that storage.

This guide explains how to list the clusters available for audit logs using the Vultr API.

Send a GET request to the List Audit Logs Clusters endpoint to retrieve the available clusters.

console 
$ curl "https://api.vultr.com/v2/logs/audit-logs/clusters" \
    -X GET \
    -H "Authorization: Bearer ${VULTR_API_KEY}"

The response contains a locations array. Each entry includes id (the cluster_id to use when creating a subscription), region, hostname, name, and deploy (whether the cluster currently accepts new audit logs deployments).

Note the id of your target cluster for use when creating an audit logs subscription.

Comments