Create a destination

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 the following:

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

    • Scopes: monitor:read_write

CLI

CLI - Akamai Object Storage destination

linode-cli streams destination-create \
--label OBJ_logs_destination \
--type akamai_object_storage \
--details.host primary-bucket-1.us-east-12.linodeobjects.com \
--details.bucket_name primary-bucket \
--details.path audit-logs \
--details.access_key_id 1ABCD23EFG4HIJKLMNO5 \
--details.access_key_secret 1aB2CD3e4fgHi5JK6lmnop7qR8STU9VxYzabcdefHh

CLI - Custom HTTPS destination

linode-cli streams destination-create \
--label custom_https_logs_destination \
--type custom_https \
--details.endpoint_url https://my-site.com/log-storage/basicAuth \
--details.content_type application/json \
--details.data_compression gzip \
--details.authentication.type basic \
--details.authentication.details.basic_authentication_user John_Q \
--details.authentication.details.basic_authentication_password C0mPl3X_p@$$w0Rd

Learn more

Path Params
string
enum
required

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

Allowed:
Body Params
details
required
string
required

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

string
enum
required

The type of destination for log data sync, either akamai_object_storage if Object Storage is the destination, or custom_https for a unique URL.

Allowed:
Responses

Language
Credentials
LoadingLoading…
Response
Choose an example:
application/json