Create a destination

Limited availability Create a new destination to serve as a sync point for logs data. You need a destination, before you can create a stream. This operation can only be accessed by account users with unrestricted access. Talk to your local account administrator about access management.

🚧

By using this service, you acknowledge your obligations under the United States Department of Justice Bulk Sensitive Data Transaction Rule ("BSD Rule"). You also agree that you will not use the service to transfer, onward transfer, or otherwise make accessible any United States government-related data or bulk United States sensitive personal data to countries of concern or a covered person, as each of those terms and concepts are defined in the BSD Rule. Anyone using the service is solely responsible for compliance with the BSD Rule.

👍

There's a tutorial

We offer an example API workflow you can follow to set up a stream and its destination.

Permissions and scopes

To call this operation, you need permissions, based on the model you're using:

  • OAuth scopes. Your user needs these scopes assigned. Learn more.

    • Scopes: monitor:read_write

CLI

linode-cli streams destination-create \
--label destination for Managed Database logs \
--details.host primary-bucket-1.us-east-12.linodeobjects.com \
--details.bucket_name primary-bucket \
--details.path audit-logs \
--details.access_key_id 123

Learn more

Path Params
string
enum
required

Enum Call either the v4 URL, or v4beta for operations still in Beta.

Allowed:
Body Params
details
object
required

Settings used for an Object Storage-based destination for a stream. You need an existing Object Storage bucket, configured to use Object Lock. See Configure audit log delivery for complete details.

string
required

The name of the destination object. Used for display purposes.

string
enum
required

The type of destination for logs data sync. Currently, only akamai_object_storage is supported for use. This lets you use Akamai Object Storage as your destination.

Allowed:
Responses

Language
Credentials
Response
Choose an example:
application/json