Create an Object Storage access key

Generates a new Object Storage access key and an associated secret key. The secret key is only displayed when the access key is generated and cannot be viewed again. A successful request triggers an obj_access_key_create event.

📘

  • Accounts with negative balances can't access this operation.

  • This operation has specific rate limits.

Unlimited vs. limited access keys

An unlimited access key grants full access to all of your buckets in each region you name, using the regions array. A limited access key lets you name specific buckets where you need to manage content, using the bucket_access array.

👍

There's a tutorial

We offer workflows for both an unlimited access key and a limited access key.

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: object_storage:read_write

CLI

linode-cli object-storage keys-create \
  --label "my-object-storage-key" \
  --bucket_access '[{"region": "ap-south", "bucket_name": "bucket-example-1", "permissions": "read_write" }]'

Learn more

Path Params
string
enum
required

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

Allowed:
Body Params
bucket_access
array of objects

Settings that limit access to specific buckets, each with a specific permission level. See Create a limited access key for more information.

bucket_access
string

The name for the key. For display purposes only.

Responses

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