S3 Get Object

GEThttps://s3.<your-region>.backblazeb2.com/<your-bucket-name>/<your-key>

This operation retrieves an object from Backblaze B2 Cloud Storage.

Encryption:

For an object encrypted with SSE-B2, the response includes x-amz-server-side-encryption: AES256. Existing objects that were stored without server-side encryption are not retroactively changed.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection Backblaze B2 Cloud Storage S3 Compatible API.

Live Read

Backblaze B2 Live Read provides the ability to read data from a multipart object while that object is uploading.

To initiate an upload with Live Read enabled, include the x-backblaze-live-read-enabled HTTP header when using S3 Create Multipart Upload.

To learn more about Live Read, click here.

Using Live Read

You can retrieve data from a current Live Read multipart upload when calling Get Object by including the x-backblaze-live-read-enabled HTTP header with its value set to true.

When you make a request with either a file name or file versionId, specify a partNumber or a byte-range header that includes both start and end values (Live Read only supports a byte range with both values).

Failure to supply either a partNumber or a supported byte range results in a 400 Bad Request error.

When you include a file name or versionId and a partNumber or supported byte range header in the request, but no data is available, a 416 Requested Range Not Satisfiable error response is returned.

See "Live Read Error Codes" below for a complete list of Live Read-related errors.

Live Read Behaviors

The following behaviors are present when Live Read is enabled:

1. The same Live Read Get Object request may return different results over time if the upload process replaces certain part numbers with new versions.

2. A Live Read Get Object request for a byte range may not return the same results as the same Get Object byte range request on the completed object if the upload process does not follow the documented upload part expectations.

3. Live Read-enabled requests that specify a file name but do not specify a versionIdmay switch from one object to another object between requests if a new Live Read multipart upload for the same file name is started.

   • The ETag response header value that is returned is not the same as the final ETag value. However, it is consistent across multiple identical calls if none of the parts that are used in the data that is returned from the API call are overwritten with new versions.

HEADERS

PARAMS

PATH VARIABLES

Example Request

curl --location 'https://s3.<your-region>.backblazeb2.com/my-bucket-name/object-1'

Example Response

Live Read Error Codes