Working with Object Storage

  Last updated 2024-12-19

This guide describes how to create an Object Storage key in the Fastly control panel which is used to authenticate requests when working with the S3-compatible API.

Working with the Object Storage web interface

You can use the Fastly control panel to create, view, and delete access keys consisting of an access key ID and secret key which is used to authenticate requests to the S3-compatible API from your Fastly services.

Creating an Object Storage access key

NOTE

Access keys created through the control panel grant access to Fastly Object Storage at the account-level, not the bucket-level. If you want to create access keys with bucket-level access, use the Fastly API.

To create an Object Storage access key:

  1. Log in to the Fastly control panel.

  2. Go to Resources > Object Storage.

  3. Click Create key.

  4. In the Description field, enter a description of the key.

  5. From the Scope field, select the level of access you want available to the key. The first key you create must have read and write access.

    • Read: access to read existing and future buckets.
    • Read and write: access to read and write to existing and future buckets.

  6. Click Create.

  7. Note the access key and secret key details. Record the secret key in a secure location because you won't be able to see it again.

Viewing Object Storage keys

Once at least one Object Storage access key is created, you can view details on all Object Storage access keys created on your account from Resources > Object Storage. The Object Storage page displays the following details:

  • Access Key ID: the access key ID returned from the S3-compatible API.
  • Description: a description of the access key.
  • Scope: the level of access available to the access key.
  • Created on: the date on which the access key was created.

Deleting an Object Storage access key

You can delete an Object Storage access key at any time. If the access key is being used by an active application, deleting it can cause unexpected behavior.

  1. Log in to the Fastly control panel.
  2. Go to Resources > Object Storage.
  3. Click the trash Trash icon to the right of the access key you want to delete.
  4. Click Confirm and delete.

Working with the S3-compatible API

Once you've created a Fastly Object Storage access key, you can use the S3-compatible API to create a bucket to store your data.

When working with the S3-compatible API, you must provide authentication via the key you created. Send requests to one of the following regional Object Storage endpoints, including the matching region in the credential Scope portion of the SigV4 signature:

  • us-east.object.fastlystorage.app

  • us-west.object.fastlystorage.app

  • eu-central.object.fastlystorage.app

    NOTE

    The regional Object Storage endpoints are different from AWS regions. Make sure you set all region options, like LocationConstraint, to the correct Object Storage region name.

Interact with your buckets by including the bucket name as part of the request path. For example, to access a bucket named my-bucket in the us-east region, you'd use the request path https://us-east.object.fastlystorage.app/my-bucket.

NOTE

Object Storage doesn't support using bucket names in the hostname (i.e., https://my-bucket.us-east.object.fastlystorage.app).

Compatible bucket operations

Object Storage supports the following processing operations for the S3-compatible API. These operations are categorized into two groups, each with differing prices. Refer to the Object Storage product description for more information on how operations are billed.

Class A operations

Class B operations

Was this guide helpful?

Do not use this form to send sensitive information. If you need assistance, contact support. This form is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

Fastly
© Fastly 2025