Create a stream

Create a new stream to track logs for an Akamai Cloud Computing service. Consider these points before creating a stream:

  • You first need to create the destination where you want to store log data.

  • By default, you can only set up a single stream for each audit log type. Talk to your account team if you need additional streams.

  • 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 create \
--label Logs stream for Managed Databases \
--type audit_logs \
--destinations 12345 \

Learn more

Path Params
string
enum
required

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

Allowed:
Body Params
destinations
array of integers
required
length ≤ 1

The unique identifier for the sync point that will receive logs data. Run the List destinations operation and store the id value for the applicable destination.

📘

Currently, you can only specify a single destination for a stream.

destinations*
details
object

Additional details for the stream, based on the selected type.

📘

Currently, this only applies to streams with a type of lke_audit_logs. Leave this object out of requests that use a type of audit_logs.

string
required

The name of the stream. This is used for display purposes in Akamai Cloud Manager.

string
enum
Defaults to active

The availability status of the stream.

Allowed:
string
enum
required

The type of stream. This can be audit_logs for logs consisting of all of the control plane operations for the services in your Linodes, or lke_audit_logs for log data for your Linode Kubernetes Engine (LKE) enterprise clusters.

Allowed:
Responses

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