{"info":{"_postman_id":"2bd51552-2df9-443f-95f1-014a26894b00","name":"Backblaze B2 Cloud Storage S3-Compatible API","description":"

The Backblaze B2 Cloud Storage S3-Compatible API implements the most commonly used actions from the AWS S3 API, and easily integrates with your existing applications, data management tools, and S3 gateways. Backblaze B2 Cloud Storage is ¼ the price of AWS S3 so you can quickly integrate B2 and see dramatic savings on your cloud storage bill.

If you aren’t already a Backblaze B2 user you can sign up for an account today and get your first 10GB of storage free.

Most applications and scripts use one of the AWS SDKs or the S3 commands in the AWS CLI to access B2. All of the SDKs, and the CLI, allow you to override the default Amazon S3 endpoint in favor of Backblaze B2. Sometimes, though, you might want to interact directly with B2 via the S3-Compatible API, perhaps in debugging an issue, or just to better understand how the service works. This documentation is the definitive reference for accessing Backblaze B2 directly via the S3-Compatible API.

Prerequisites

Sign up for a Backblaze account, if you have not already done so.
\n
Ensure that B2 is enabled on your account.
\n
Create an application key, if you have not already done so. Ensure that you save the application key now as you will not be able to access it later. Note that you cannot use your master application key with the S3-Compatible API.
\n
Create a bucket, if you have not already done so. Note the bucket's Endpoint URL. It will have the form s3.<your-region>.backblazeb2.com, where <your-region> is similar to us-west-004. Make a note of the region. Note that at present, unlike Amazon S3, a B2 account is associated with a single region. It is not currently possible to create buckets outside an account's region.
\n

Once you have your application key and region, navigate to the API's collection variables (Click on Backblaze B2 Cloud Storage S3-Compatible API in the tree on the left then click the Variables tab). Copy your application key, application key ID, and region into the current values of the three variables:

Test your settings

Go to the S3 Get Bucket Location request inside this collection.
\n
Enter the name of a bucket to which your application key has access.
\n
Click Send.
\n

You should see an XML response with the location of the bucket:

Troubleshooting

If you don't see an XML response with the bucket location, check that:

The application key has access to the bucket that you specified.
\n
You didn't inadvertently swap the application key and application key ID.
\n
You saved the collection variables.
\n

Authentication

The API supports AWS Signature Version 4 (SigV4) for authentication and does not support V2 signatures at this time. This collection uses Postman's built-in implementation of AWS SigV4.

Requests

Communicate with the API by sending HTTP requests to resource endpoints. The HTTP method determines the action taken.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Method	Usage
DELETE	Use the DELETE method to destroy a resource such as a bucket, object or bucket setting. If it is not found, the operation will return a 4xx error and an appropriate message.
GET	To retrieve object data or configuration, use the GET method. Object data is returned in the format it was written; configuration is returned as XML. GET methods are read-only and do not modify any resources.
PUT	Use the PUT method to write object data or configuration. Configuration must be formatted as XML according to the schema defined by the Amazon S3 API.
POST	Use the POST method with the S3 Delete Object, S3 Complete Multipart Upload, and S3 Create Multipart Upload operations.

Response Codes

The API uses standard HTTP response codes to show the outcome of requests. Response codes in the 2xx range indicate success, while codes in the 4xx range indicate a client-side error, such as an authorization failure or a malformed request. 4xx errors return an XML response object explaining the problem. For example:

\n<Error>\n    <Code>NoSuchBucket</Code>\n    <Message>The specified bucket does not exist: NonExistentBucket</Message>\n    <Resource>NonExistentBucket</Resource>\n</Error>\n\n

Codes in the 5xx range indicate a server-side problem preventing B2 from fulfilling your request, and include JSON diagnostics:

{\n    \"code\": \"internal_error\",\n    \"message\": \"incident id 2f0e432cc922-9c2c28e96a16711b\",\n    \"status\": 500\n}\n\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Response	Description
200 OK	The response contains your requested information.
201 Created	Your request was accepted. The resource was created.
202 Accepted	Your request was accepted. The resource was created or updated.
204 No Content	Your request succeeded, there is no additional information returned.
400 Bad Request	Your request was malformed.
401 Unauthorized	You did not supply valid authentication credentials.
403 Forbidden	You are not allowed to perform that action.
404 Not Found	No results were found for your request.
429 Too Many Requests	Your request exceeded the API rate limit.
500 Internal Server Error	We were unable to perform the request due to server-side problems.

Differences from Amazon S3

For the most part, the Backblaze B2 Cloud Storage S3-Compatible API operates identically to Amazon S3. There are, however, some important differences that you should bear in mind with designing applications and solutions.

Backblaze B2 endpoints are located at backblazeb2.com rather than amazonaws.com. Most S3-compatible applications and tools allow you to customize the S3 endpoint to work with S3-compatible APIs outside Amazon.
\n
ACLs are set at the bucket level, and only the canned ACL values \"private\" and “public-read” are supported. You cannot set complex ACLs via XML. Objects inherit their bucket's ACL. Attempting to set an object's ACL to a different value from its parent will result in a 403 Forbidden error.
\n
Backblaze B2 features slightly different restrictions on file and bucket names than Amazon S3.
\n
Buckets in Backblaze B2 are versioned by default. Because Buckets are versioned, when a file is deleted by referencing the name only the most recent version of that file will be deleted and older versions of the file will continue to exist in the Bucket.
\n
The API endpoints only accept connections over HTTPS. Non-secure connections will be rejected.
\n
Backblaze B2 supports server-side encryption of data using either Backblaze-managed keys (SSE-B2) or using customer-managed keys (SSE-C). SSE-KMS encryption is not currently supported.
\n
IAM roles, Object Tagging, and Website configuration are not currently supported.
\n

For a more detailed explanation of the differences between the Backblaze B2 Cloud Storage S3-Compatible API and Amazon S3 see the Backblaze B2 S3-Compatible API documentation.

Presigned URLs

B2 supports standard AWS SigV4 query-string presigning. Postman cannot easily generate a presigned URL inside a request, but you can produce one externally:

aws s3 presign s3:/// --expires-in 3600 \\\n    --endpoint-url https://s3..backblazeb2.com\n

or via any AWS SDK. Paste the resulting URL into a fresh GET request (no auth needed; the URL carries its own SigV4 signature).

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"9169647","collectionId":"2bd51552-2df9-443f-95f1-014a26894b00","publishedId":"UVeMGhwV","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"E20626"},"publishDate":"2022-10-04T23:16:49.000Z"},"item":[{"name":"Bucket Operations","item":[{"name":"S3 Create Bucket","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('Status 200', function () {"," pm.expect(pm.response.code === 200).to.be.true;","});"]}}],"id":"7a2fe9d3-2d6a-433e-a640-68dee20e5df3","request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"\n \n","options":{"raw":{"language":"xml"}}},"url":"https://s3..backblazeb2.com/","description":"

Creates a new bucket.

The bucket name must be globally unique. For restrictions on bucket names such as minimum and maximum length see Bucket Names.

You can optionally specify a canned ACL of private (the default) or public-read via the x-amz-acl header.

Deletes the bucket specified. Only buckets that contain no versions of any files can be deleted.

Deletes CORS configuration from the bucket.

Deletes default encryption configuration from the bucket. For information about the default encryption feature see Default Bucket Encryption.

\n false\n","options":{"raw":{"language":"xml"}}},"url":"https://s3..backblazeb2.com/?delete","description":"

Deletes multiple objects from a bucket in a single request. In the XML body, provide the object keys and, optionally, version IDs to delete specific versions.

Usage: Set the and collection variables to the object keys you want to delete, and add more <Object> blocks for additional keys. Optionally include <VersionId>...</VersionId> inside an <Object> to delete a specific version.

Docs: https://www.backblaze.com/apidocs/s3-delete-objects

\n","options":{"raw":{"language":"xml"}}},"url":{"raw":"https://s3..backblazeb2.com/:bucket/?delete","protocol":"https","host":["s3","","backblazeb2","com"],"path":[":bucket",""],"query":[{"key":"delete","value":null,"description":"Must be present to delete multiple objects."}],"variable":[{"key":"bucket","value":"my-bucket-name","description":"Required. The name of the bucket"}]}},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"x-amz-request-id","value":"d149d18cdac3d9ca"},{"key":"x-amz-id-2","value":"aMec1XWZmOTAzoTWJY0pmxDTDZDNjxWI4"},{"key":"Cache-Control","value":"max-age=0, no-cache, no-store"},{"key":"Content-Type","value":"application/xml"},{"key":"Content-Length","value":"611"},{"key":"Date","value":"Fri, 28 Jan 2022 23:45:22 GMT"},{"key":"Keep-Alive","value":"timeout=5"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"\n\n \n true\n 4_z6145af89f355ac2f74ed0c1b_f401a918cd72e68af_d20220128_m234522_c004_v0402003_t0046\n object-1\n \n \n true\n 4_z6145af89f355ac2f74ed0c1b_f401a918cd72e68b0_d20220128_m234522_c004_v0402002_t0049\n object-2\n \n"}],"_postman_id":"b2113c16-bac4-4fa5-bfae-93e010433437"},{"name":"S3 Get Bucket ACL","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('Status 200', function () {"," pm.expect(pm.response.code === 200).to.be.true;","});"]}}],"id":"20c54af2-7b91-4be0-ad86-b1687e1ad3c5","request":{"method":"GET","header":[],"url":"https://s3..backblazeb2.com/?acl","description":"

Retrieves the bucket's ACL in XML format.

Gets the bucket's CORS configuration.

Gets the bucket's default encryption configuration. For more information on default encryption see Default Bucket Encryption.

Returns the bucket's region.

Returns the logging status of a bucket with Bucket Access Logs enabled and the permissions users have to view and modify that status.

Gets the versioning state of the bucket.

Backblaze B2 behavior: B2 buckets are always versioned; versioning cannot be disabled or suspended, so the response always returns <Status>Enabled</Status>.

Docs: https://www.backblaze.com/apidocs/s3-get-bucket-versioning

Gets the Object Lock configuration for a bucket.

Determines whether the bucket exists in your B2 account, returning 200 OK if it does exist in your B2 account or 404 Not Found if it does not.

Lists buckets in your account in alphabetical order by bucket name.

Returns metadata of the versions of objects in the bucket. Use the query parameters to filter the search.

Returns a list of up to 1,000 objects in the bucket, sorted alphabetically by key. Use the query parameters to filter the search.

Note - S3 List Objects V2 (below) should be used in preference to this operation, since S3 List Objects has no mechanism to page through more than 1,000 results.

Returns a list of up to 1,000 objects in the bucket, sorted alphabetically by key.

Use the query parameters to filter the search.

By default, sets of up to 1,000 results are returned. You can set the max-keys to set the maximum result set size to less than 1,000. If the search results in more than the maximum result set size, then the first set is returned in the initial response, the response element contains the value true and the element contains a token to retrieve the next set of results. Use this token as the continuation-token query parameter in another request to retrieve the next set of results.

Required. Allowed values are \"private\" or \"public-read\".

\n","type":"text"}],"url":"https://s3..backblazeb2.com/?acl","description":"

Sets the ACL on an existing bucket via the x-amz-acl header. Setting the ACL via XML in the request body is not supported.

Sets the bucket's CORS configuration. If the configuration exists, it is replaced.

Sets the bucket's default encryption configuration. For more information, see default bucket encryption.

Backblaze B2 behavior: <SSEAlgorithm>AES256</SSEAlgorithm> invokes B2's SSE-B2 (Backblaze-managed encryption keys). B2 does not support SSE-KMS (aws:kms); the supported options are SSE-B2 (this) and SSE-C (per-request customer keys). See the Backblaze B2 Server-Side Encryption docs.

Docs: https://www.backblaze.com/apidocs/s3-put-bucket-encryption

Sets the bucket's access logging configuration. Bucket Access Logs records S3-style request logs into a target bucket and prefix.

Docs: https://www.backblaze.com/docs/cloud-storage-bucket-access-logs

Sets the Object Lock configuration for a bucket. The specified rule will apply by default to new objects created in the bucket.

This set of operations allows you to manipulate B2 buckets.

There is no limit to the number of files in a bucket, but there is a limit of 100 buckets per account.

Aside from S3 List Buckets, all bucket operations use an endpoint of the form https://s3.<region>.backblazeb2.com/<bucket name>.

\n","_postman_id":"ed6c5aa4-c635-439a-aaf8-423b5e0724c0","auth":{"type":"awsv4","awsv4":{"basicConfig":[{"key":"accessKey","value":""},{"key":"secretKey","value":""}],"advancedConfig":[{"key":"region","value":""},{"key":"service","value":""}]},"isInherited":true,"source":{"_postman_id":"2bd51552-2df9-443f-95f1-014a26894b00","id":"2bd51552-2df9-443f-95f1-014a26894b00","name":"Backblaze B2 Cloud Storage S3-Compatible API","type":"collection"}}},{"name":"Object Operations","item":[{"name":"Multipart Uploads","item":[{"name":"S3 Abort Multipart Upload","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('Status 204', function () {"," pm.expect(pm.response.code === 204).to.be.true;","});"]}}],"id":"ee597790-4c60-46e0-8724-c1f455de3cec","request":{"method":"DELETE","header":[],"url":"https://s3..backblazeb2.com//?uploadId=","description":"

Aborts a multipart upload and deletes any parts that were already uploaded. Set to the ID returned by S3 Create Multipart Upload. Docs: https://www.backblaze.com/apidocs/s3-abort-multipart-upload

Completes a multipart upload by assembling the parts you previously uploaded. Docs: https://www.backblaze.com/apidocs/s3-complete-multipart-upload

Multipart upload guidance: ETags must come from the corresponding S3 Upload Part response headers and must be wrapped in quotes in the XML body (per the AWS S3 spec). Set the and collection variables after each Upload Part response. If you have more than two parts, add an additional <Part> block for each.

Initiates a multipart upload and returns an UploadId used by the subsequent S3 Upload Part and S3 Complete Multipart Upload requests. Use multipart uploads for large objects. Docs: https://www.backblaze.com/apidocs/s3-create-multipart-upload

\n","auth":{"type":"awsv4","awsv4":{"basicConfig":[{"key":"accessKey","value":""},{"key":"secretKey","value":""}],"advancedConfig":[{"key":"region","value":""},{"key":"service","value":""}]},"isInherited":true,"source":{"_postman_id":"2bd51552-2df9-443f-95f1-014a26894b00","id":"2bd51552-2df9-443f-95f1-014a26894b00","name":"Backblaze B2 Cloud Storage S3-Compatible API","type":"collection"}},"urlObject":{"protocol":"https","path":["",""],"host":["s3","","backblazeb2","com"],"query":[{"key":"uploads","value":""}],"variable":[]}},"response":[{"id":"9f026546-e3b5-435c-b436-ece94a85415a","name":"S3 Create Multipart Upload","originalRequest":{"method":"POST","header":[{"key":"Cache-Control","value":"","description":"Optional. Specifies Cache-Control header on retrieval.","disabled":true},{"key":"Content-Disposition","value":"","description":"Optional. Specifies Content-Disposition header on retrieval.","disabled":true},{"key":"Content-Encoding","value":"","description":"Optional. Specifies Content-Encoding header on retrieval.","disabled":true},{"key":"Content-Language","value":"","description":"Optional. Specifies Content-Encoding header on retrieval.","disabled":true},{"key":"Content-Length","value":"","description":"Optional. Specifies Content-Length header on retrieval.","disabled":true},{"key":"Content-Type","value":"","description":"Optional. Specifies Content-Type header on retrieval.","disabled":true},{"key":"Expires","value":"","description":"Optional. Specifies Expires header on retrieval.","disabled":true},{"key":"x-amz-acl","value":"","description":"Optional. If supplied, must be the same as the bucket ACL.","disabled":true},{"key":"x-amz-expected-bucket-owner","value":"","description":"Optional. Account ID of the expected bucket owner. If the bucket is owned by a different owner, a 403 Access Denied error will be returned.","disabled":true},{"key":"x-amz-object-lock-legal-hold","value":"","description":"Optional. Specifies whether a legal hold will be applied. Allowed values are 'ON' or 'OFF'.","disabled":true},{"key":"x-amz-object-lock-mode","value":"","description":"Optional. The lock mode to apply. Allowed values are 'GOVERNANCE' or 'COMPLIANCE'.","disabled":true},{"key":"x-amz-object-lock-retain-until-date","value":"","description":"Optional. Timestamp for expiration of object lock.","disabled":true},{"key":"x-amz-server-side-encryption-customer-algorithm","value":"","description":"Optional. Encryption algorithm to be used for SSE-C.","disabled":true},{"key":"x-amz-server-side-encryption-customer-key","value":"","description":"Optional. Base64-encoded customer key for SSE-C.","disabled":true},{"key":"x-amz-server-side-encryption","value":"","description":"Optional. Set to AES256 to use SSE-B2.","disabled":true},{"key":"x-backblaze-live-read-enabled","value":"true","description":"Optional. Enable the Live Read feature and allow data retrieval from a current multipart upload. \n\nAny value other than TRUE is treated as false.","disabled":true},{"key":"x-backblaze-live-read-part-size","value":"10000000","description":"Optional. Use this optional header to specify the part size (in bytes) to be used to determine which part numbers correspond to the requested byte range.\n\nThe accepted part size byte range is 5 MB (5,000,000 bytes) to 5 GiB (5,368,709,120) bytes.","disabled":true}],"url":{"raw":"https://s3..backblazeb2.com/:bucket/:key?uploads","protocol":"https","host":["s3","","backblazeb2","com"],"path":[":bucket",":key"],"query":[{"key":"uploads","value":null,"description":"Must be present for a multipart upload."}],"variable":[{"key":"bucket","value":"my-bucket-name","description":"Required. The name of the bucket."},{"key":"key","value":"object-1","description":"Required. Key of the object to be written."}]}},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"x-amz-request-id","value":"12548b67204cfe35"},{"key":"x-amz-id-2","value":"aMWU16WbDOfkzcjVCY3FmiTROZAljPWLF"},{"key":"x-amz-version-id","value":"4_z6145af89f355ac2f74ed0c1b_f2025e1f1817e0030_d20220128_m233615_c004_v0402000_t0048"},{"key":"Cache-Control","value":"max-age=0, no-cache, no-store"},{"key":"Content-Type","value":"application/xml"},{"key":"Content-Length","value":"348"},{"key":"Date","value":"Fri, 28 Jan 2022 23:36:15 GMT"},{"key":"Keep-Alive","value":"timeout=5"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"\n\n my-bucket-name\n object-1\n 4_z6145af89f355ac2f74ed0c1b_f2025e1f1817e0030_d20220128_m233615_c004_v0402000_t0048\n"}],"_postman_id":"046591f5-52c1-4fde-8465-77a61c90450c"},{"name":"S3 Upload Part","event":[{"listen":"prerequest","script":{"exec":["// SSE-C: derive customer-key-MD5 from customer-key if it's set.","// (Content-MD5 for the part body is NOT set here — same reason as in S3 Put Object;","// SigV4's x-amz-content-sha256 covers the integrity check for normal uploads.)","const key = pm.request.headers.get('x-amz-server-side-encryption-customer-key');","if (key) {"," pm.request.headers.add({"," key: 'x-amz-server-side-encryption-customer-key-MD5',"," value: CryptoJS.MD5(CryptoJS.enc.Base64.parse(key)).toString(CryptoJS.enc.Base64)"," });","}"],"type":"text/javascript"}},{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('Status 200', function () {"," pm.expect(pm.response.code === 200).to.be.true;","});"]}}],"id":"690057f6-8019-4c5b-8c88-db367a35b3a0","request":{"method":"PUT","header":[],"body":{"mode":"file","file":{"src":""}},"url":"https://s3..backblazeb2.com//?partNumber=1&uploadId=","description":"

Uploads one part of a multipart upload.

Body mode is set to file — pick the part file (≥ 5 MB except for the last part).

Capture the response ETag — you'll need it for S3 Complete Multipart Upload. Save it in the , , etc. collection variables.

Docs: https://www.backblaze.com/apidocs/s3-upload-part

Required. The name of the source bucket and the key of the source object in the form /.

\n","type":"text"}],"body":{"mode":"raw","raw":""},"url":"https://s3..backblazeb2.com//?partNumber=1&uploadId=","description":"

Uploads a part by copying data from an existing object, identified by the x-amz-copy-source header. Set and 1. Docs: https://www.backblaze.com/apidocs/s3-upload-part-copy

\n","auth":{"type":"awsv4","awsv4":{"basicConfig":[{"key":"accessKey","value":""},{"key":"secretKey","value":""}],"advancedConfig":[{"key":"region","value":""},{"key":"service","value":""}]},"isInherited":true,"source":{"_postman_id":"2bd51552-2df9-443f-95f1-014a26894b00","id":"2bd51552-2df9-443f-95f1-014a26894b00","name":"Backblaze B2 Cloud Storage S3-Compatible API","type":"collection"}},"urlObject":{"protocol":"https","path":["",""],"host":["s3","","backblazeb2","com"],"query":[{"key":"partNumber","value":"1"},{"key":"uploadId","value":""}],"variable":[]}},"response":[{"id":"5d61c926-f2d2-4fca-b9a8-bdaafcf528a9","name":"S3 Upload Part Copy","originalRequest":{"method":"PUT","header":[{"key":"x-amz-copy-source","value":"my-bucket-name/object-2","description":"Required. The name of the source bucket and the key of the source object in the form /.","type":"text"},{"key":"x-amz-copy-source-if-match","value":"","description":"Optional. Only copy the object if its ETag matches this value, otherwise return a 412 (precondition failed) error.","type":"text","disabled":true},{"key":"x-amz-copy-source-if-modified-since","value":"","description":"Optional. Only copy the object if it has been modified since this time.","type":"text","disabled":true},{"key":"x-amz-copy-source-if-none-match","value":"","description":"Optional. Only copy the object if its ETag does not match this value, otherwise return a 412 (precondition failed) error","type":"text","disabled":true},{"key":"x-amz-copy-source-if-unmodified-since","value":"","description":"Optional. Only copy the object if it has not been modified since this time.","type":"text","disabled":true},{"key":"x-amz-copy-source-range","value":"","description":"Optional. A range of bytes to copy from the source object in the form bytes=first-last, where the first and last are the zero-based byte offsets to copy.","type":"text","disabled":true},{"key":"x-amz-copy-source-server-side-encryption-customer-algorithm","value":"","description":"Optional. Encryption algorithm to be used for decrypting the source object via SSE-C.","type":"text","disabled":true},{"key":"x-amz-copy-source-server-side-encryption-customer-key","value":"","description":"Optional. Base64-encoded customer key to be used for decrypting the source object via SSE-C.","type":"text","disabled":true},{"key":"x-amz-copy-source-server-side-encryption-customer-key-MD5","value":"","description":"Optional. Base64-encoded MD5 hash of the customer key to be used for decrypting the source object via SSE-C. Calculated in pre-request script.","type":"text","disabled":true},{"key":"x-amz-expected-bucket-owner","value":"","type":"text","description":"Optional. Account ID of the expected bucket owner. If the bucket is owned by a different owner, a 403 Access Denied error will be returned.","disabled":true},{"key":"x-amz-server-side-encryption-customer-algorithm","value":"","type":"text","description":"Optional. Encryption algorithm to be used for SSE-C.","disabled":true},{"key":"x-amz-server-side-encryption-customer-key","value":"","type":"text","description":"Optional. Base64-encoded customer key for SSE-C.","disabled":true},{"key":"x-amz-source-expected-bucket-owner","value":"","description":"Optional. Account ID of the expected source bucket owner. If the bucket is owned by a different owner, a 403 Access Denied error will be returned.","type":"text","disabled":true}],"body":{"mode":"raw","raw":""},"url":{"raw":"https://s3..backblazeb2.com/:bucket/:key?partNumber=1&uploadId=4_z6145af89f355ac2f74ed0c1b_f2025e1f1817e0030_d20220128_m233615_c004_v0402000_t0048","protocol":"https","host":["s3","","backblazeb2","com"],"path":[":bucket",":key"],"query":[{"key":"partNumber","value":"1","description":"The number of the part being uploaded, between 1 and 10,000."},{"key":"uploadId","value":"4_z6145af89f355ac2f74ed0c1b_f2025e1f1817e0030_d20220128_m233615_c004_v0402000_t0048","description":"An Upload ID obtained from S3 Create Multipart Upload"}],"variable":[{"key":"bucket","value":"my-bucket-name-example","description":"Required. The name of the bucket."},{"key":"key","value":"object-1","description":"Required. Key of the object to be written."}]}},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"x-amz-request-id","value":"90e17e227a223955"},{"key":"x-amz-id-2","value":"aMR81PGamOQQzjTUJY9lmFzRwZNVjQGJS"},{"key":"x-amz-copy-source-version-id","value":"4_z6145af89f355ac2f74ed0c1b_f2006887251b080dd_d20220128_m232720_c004_v0402000_t0046"},{"key":"Cache-Control","value":"max-age=0, no-cache, no-store"},{"key":"Content-Type","value":"application/xml"},{"key":"Content-Length","value":"249"},{"key":"Date","value":"Fri, 28 Jan 2022 23:37:39 GMT"},{"key":"Keep-Alive","value":"timeout=5"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"\n\n \"85f30635602dc09bd85957a6e82a2c21\"\n 2022-01-28T23:37:39.426Z\n"}],"_postman_id":"51ed1fd5-0f28-4386-a7e8-71fa248b5a05"},{"name":"S3 List Multipart Uploads","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('Status 200', function () {"," pm.expect(pm.response.code === 200).to.be.true;","});"]}}],"id":"406f906d-84d0-40ae-ad9a-da8e144289ae","request":{"method":"GET","header":[],"url":"https://s3..backblazeb2.com/?uploads","description":"

Lists in-progress multipart uploads for a bucket. Docs: https://www.backblaze.com/apidocs/s3-list-multipart-uploads

Lists parts that have been uploaded for a given multipart upload.

By default, sets of up to 1,000 results are returned. You can set max-parts to set the maximum result set size to less than 1,000. If the search results number more than the maximum result set size, then the first set is returned in the initial response, the response element contains the value true and the element contains a token to retrieve the next set of results. Use this token as the part-number-marker query parameter in another request to retrieve the next set of results.

Required. The name of the source bucket and the key of the source object in the form /.

\n","type":"text"}],"body":{"mode":"raw","raw":""},"url":"https://s3..backblazeb2.com//","description":"

Creates a copy of an object that is already stored in Backblaze B2. The source object is identified by the x-amz-copy-source header. Docs: https://www.backblaze.com/apidocs/s3-copy-object

\n","auth":{"type":"awsv4","awsv4":{"basicConfig":[{"key":"accessKey","value":""},{"key":"secretKey","value":""}],"advancedConfig":[{"key":"region","value":""},{"key":"service","value":""}]},"isInherited":true,"source":{"_postman_id":"2bd51552-2df9-443f-95f1-014a26894b00","id":"2bd51552-2df9-443f-95f1-014a26894b00","name":"Backblaze B2 Cloud Storage S3-Compatible API","type":"collection"}},"urlObject":{"protocol":"https","path":["",""],"host":["s3","","backblazeb2","com"],"query":[],"variable":[]}},"response":[{"id":"f88f756e-839e-41d3-b21b-e1664625524f","name":"S3 Copy Object","originalRequest":{"method":"PUT","header":[{"key":"Cache-Control","value":"","description":"Optional. Specifies Cache-Control header on retrieval.","type":"text","disabled":true},{"key":"Content-Disposition","value":"","description":"Optional. Specifies Content-Disposition header on retrieval.","type":"text","disabled":true},{"key":"Content-Encoding","value":"","description":"Optional. Specifies Content-Encoding header on retrieval.","type":"text","disabled":true},{"key":"Content-Language","value":"","description":"Optional. Specifies Content-Encoding header on retrieval.","type":"text","disabled":true},{"key":"Content-Type","value":"","description":"Optional. Specifies Content-Type header on retrieval.","type":"text","disabled":true},{"key":"Expires","value":"","description":"Optional. Specifies Expires header on retrieval.","type":"text","disabled":true},{"key":"x-amz-acl","value":"","type":"text","description":"Optional. If supplied, must be the same as the bucket ACL.","disabled":true},{"key":"x-amz-copy-source","value":"my-bucket-name/object-1","description":"Required. The name of the source bucket and the key of the source object in the form /.","type":"text"},{"key":"x-amz-copy-source-if-match","value":"","description":"Optional. Only copy the object if its ETag matches this value, otherwise return a 412 (precondition failed) error.","type":"text","disabled":true},{"key":"x-amz-copy-source-if-modified-since","value":"","description":"Optional. Only copy the object if it has been modified since this time.","type":"text","disabled":true},{"key":"x-amz-copy-source-if-none-match","value":"","description":"Optional. Only copy the object if its ETag does not match this value, otherwise return a 412 (precondition failed) error","type":"text","disabled":true},{"key":"x-amz-copy-source-if-unmodified-since","value":"","description":"Optional. Only copy the object if it has not been modified since this time.","type":"text","disabled":true},{"key":"x-amz-copy-source-server-side-encryption-customer-algorithm","value":"","description":"Optional. Encryption algorithm to be used for decrypting the source object via SSE-C.","type":"text","disabled":true},{"key":"x-amz-copy-source-server-side-encryption-customer-key","value":"","description":"Optional. Base64-encoded customer key to be used for decrypting the source object via SSE-C.","type":"text","disabled":true},{"key":"x-amz-copy-source-server-side-encryption-customer-key-MD5","value":"","description":"Optional. Base64-encoded MD5 hash of the customer key to be used for decrypting the source object via SSE-C. Calculated in pre-request script.","type":"text","disabled":true},{"key":"x-amz-expected-bucket-owner","value":"","type":"text","description":"Optional. Account ID of the expected destination bucket owner. If the bucket is owned by a different owner, a 403 Access Denied error will be returned.","disabled":true},{"key":"x-amz-metadata-directive","value":"","description":"Optional. Specifies whether metadata should be copied from the source object or replaced with values in the request. Allowed values are \"COPY\" or \"REPLACE\".","type":"text","disabled":true},{"key":"x-amz-object-lock-legal-hold","value":"","type":"text","description":"Optional. Specifies whether a legal hold will be applied. Allowed values are 'ON' or 'OFF'.","disabled":true},{"key":"x-amz-object-lock-mode","value":"","type":"text","description":"Optional. The lock mode to apply. Allowed values are 'GOVERNANCE' or 'COMPLIANCE'.","disabled":true},{"key":"x-amz-object-lock-retain-until-date","value":"","type":"text","description":"Optional. Timestamp for expiration of object lock.","disabled":true},{"key":"x-amz-server-side-encryption-customer-algorithm","value":"","type":"text","description":"Optional. Encryption algorithm to be used for SSE-C.","disabled":true},{"key":"x-amz-server-side-encryption-customer-key","value":"","type":"text","description":"Optional. Base64-encoded customer key for SSE-C.","disabled":true},{"key":"x-amz-server-side-encryption","value":"","description":"Optional. Set to AES256 to use SSE-B2.","type":"text","disabled":true},{"key":"x-amz-source-expected-bucket-owner","value":"","description":"Optional. Account ID of the expected source bucket owner. If the bucket is owned by a different owner, a 403 Access Denied error will be returned.","type":"text","disabled":true}],"body":{"mode":"raw","raw":""},"url":{"raw":"https://s3..backblazeb2.com/:bucket/:key","protocol":"https","host":["s3","","backblazeb2","com"],"path":[":bucket",":key"],"variable":[{"key":"bucket","value":"my-bucket-name","description":"Required. The name of the destination bucket."},{"key":"key","value":"object-2","description":"Required. Key of the object to be written."}]}},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"x-amz-request-id","value":"8bce3b35a5a2ea35"},{"key":"x-amz-id-2","value":"aMfU17WbdOUAzOTXxY9ZmojQOZM9jGmJu"},{"key":"x-amz-copy-source-version-id","value":"4_z6145af89f355ac2f74ed0c1b_f4030346ce9e208f0_d20220128_m232407_c004_v0402005_t0021"},{"key":"x-amz-version-id","value":"4_z6145af89f355ac2f74ed0c1b_f411debfc7f401b47_d20220128_m232545_c004_v0402003_t0045"},{"key":"Cache-Control","value":"max-age=0, no-cache, no-store"},{"key":"Content-Type","value":"application/xml"},{"key":"Content-Length","value":"253"},{"key":"Date","value":"Fri, 28 Jan 2022 23:25:44 GMT"},{"key":"Keep-Alive","value":"timeout=5"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"\n\n \"85f30635602dc09bd85957a6e82a2c21\"\n 2022-01-28T23:25:45.000Z\n"}],"_postman_id":"dc24a415-26fc-48dc-af5c-20852daaadb7"},{"name":"S3 Delete Object","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('Status 204', function () {"," pm.expect(pm.response.code === 204).to.be.true;","});"]}}],"id":"a8c9f776-85c0-49f8-9b38-3a770fe0262a","request":{"method":"DELETE","header":[],"url":"https://s3..backblazeb2.com//","description":"

Deletes an object from a bucket. Because B2 buckets are always versioned, deleting by name hides the object by adding a delete marker; pass versionId to delete a specific version. Docs: https://www.backblaze.com/apidocs/s3-delete-object

Optional. Target a specific object version.

\n","type":"text/plain"},"key":"versionId","value":""}],"variable":[]}},"response":[{"id":"8a2c8d3e-342a-4bde-8a8f-b336d9834d64","name":"S3 Delete Object","originalRequest":{"method":"DELETE","header":[{"key":"x-amz-expected-bucket-owner","value":"","description":"Optional. Account ID of the expected bucket owner. If the bucket is owned by a different owner, a 403 Access Denied error will be returned.","type":"text","disabled":true},{"key":"x-amz-bypass-governance-retention","value":"","description":"Optional. Specifies whether the object should be deleted even if there is a governance object lock in place.","type":"text","disabled":true}],"url":{"raw":"https://s3..backblazeb2.com/:bucket/:key","protocol":"https","host":["s3","","backblazeb2","com"],"path":[":bucket",":key"],"query":[{"key":"versionId","value":"","description":"VersionId to delete.","disabled":true}],"variable":[{"key":"bucket","value":"my-bucket-name","description":"Required. The name of the bucket"},{"key":"key","value":"object-1","description":"Required. Key of the object to read."}]}},"status":"No Content","code":204,"_postman_previewlanguage":"plain","header":[{"key":"x-amz-request-id","value":"462500c9d699ed92"},{"key":"x-amz-id-2","value":"aMR01LmYuOegzLTUBY5hmJjQOZKdjfGJC"},{"key":"x-amz-delete-marker","value":"true"},{"key":"x-amz-version-id","value":"4_z6145af89f355ac2f74ed0c1b_f40057de773908ada_d20220128_m234031_c004_v0402002_t0050"},{"key":"Cache-Control","value":"max-age=0, no-cache, no-store"},{"key":"Content-Type","value":""},{"key":"Date","value":"Fri, 28 Jan 2022 23:40:31 GMT"},{"key":"Keep-Alive","value":"timeout=5"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"a8c9f776-85c0-49f8-9b38-3a770fe0262a"},{"name":"S3 Get Object","event":[{"listen":"prerequest","script":{"exec":["// Set the SSE-C customer-key MD5 header from the customer key","const key = pm.request.headers.get('x-amz-server-side-encryption-customer-key');","if (key) {"," pm.request.headers.add({"," key: 'x-amz-server-side-encryption-customer-key-MD5', "," value: CryptoJS.MD5(CryptoJS.enc.Base64.parse(key)).toString(CryptoJS.enc.Base64)"," });","}"],"type":"text/javascript","packages":{}}},{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('Status 200', function () {"," pm.expect(pm.response.code === 200).to.be.true;","});"]}}],"id":"d4dd2d25-c75f-4b19-94be-e1182b39d63d","request":{"method":"GET","header":[],"url":"https://s3..backblazeb2.com//","description":"

Retrieves an object from a bucket. Pass versionId to retrieve a specific version. Docs: https://www.backblaze.com/apidocs/s3-get-object

Optional. Target a specific object version.

\n","type":"text/plain"},"key":"versionId","value":""}],"variable":[]}},"response":[{"id":"b2ee0c7b-ae95-4cda-86e3-d930fc0737a4","name":"S3 Get Object","originalRequest":{"method":"GET","header":[{"key":"x-amz-expected-bucket-owner","value":"","description":"Optional. Account ID of the expected bucket owner. If the bucket is owned by a different owner, a 403 Access Denied error will be returned.","disabled":true},{"key":"x-amz-server-side-encryption-customer-algorithm","value":"AES256","description":"Optional. Encryption algorithm to be used for SSE-C.","disabled":true},{"key":"x-amz-server-side-encryption-customer-key","value":"kmxlnaH92TEckb+8giJF8qPR5lPY5NDBsIpQQZwAn7A=","description":"Optional. Base64-encoded customer key for SSE-C.","disabled":true},{"key":"x-amz-server-side-encryption-customer-key-MD5","value":"","description":"Optional. Base64-encoded MD5 hash of the customer key for SSE-C. Calculated in pre-request script","disabled":true},{"key":"x-backblaze-live-read-enabled","value":"True","description":"Optional. To retrieve data from an ongoing multipart upload with Live Read enabled, the value must be TRUE.\n\nAny value other than TRUE (case-insensitive) is treated as false.","disabled":true}],"url":{"raw":"https://s3..backblazeb2.com/:bucket/:key","protocol":"https","host":["s3","","backblazeb2","com"],"path":[":bucket",":key"],"query":[{"key":"partNumber","value":"","description":"Part number to read, between 1 and 10,000.","disabled":true},{"key":"response-cache-control","value":"","description":"Specifies Cache-Control header for the response.","disabled":true},{"key":"response-content-encoding","value":"","description":"Specifies Content-Encoding header for the response.","disabled":true},{"key":"response-content-language","value":"","description":"Specifies Content-Language header for the response.","disabled":true},{"key":"response-content-type","value":"","description":"Specifies Content-Type header for the response.","disabled":true},{"key":"response-expires","value":"","description":"Specifies Expires header for the response.","disabled":true},{"key":"versionId","value":"","description":"VersionId to read.","disabled":true}],"variable":[{"key":"bucket","value":"my-bucket-name","description":"Required. The name of the bucket"},{"key":"key","value":"object-1","description":"Required. Key of the object to read."}]}},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":[{"key":"Accept-Ranges","value":"bytes"},{"key":"Last-Modified","value":"Fri, 28 Jan 2022 23:12:33 GMT"},{"key":"ETag","value":"\"85f30635602dc09bd85957a6e82a2c21\""},{"key":"Cache-Control","value":"no-cache"},{"key":"x-amz-request-id","value":"22f4a1772746da99"},{"key":"x-amz-id-2","value":"aMWA1NmaNOcQz7zWKY2lmZzT6ZHdjpGJT"},{"key":"x-amz-version-id","value":"4_z6145af89f355ac2f74ed0c1b_f416a807037a7ee2a_d20220128_m231233_c004_v0402000_t0056"},{"key":"x-backblaze-live-read-enabled","value":"True","description":""},{"key":"x-backblaze-live-read-part-size","value":"5000","description":""},{"key":"Content-Type","value":"text/plain"},{"key":"Content-Length","value":"11"},{"key":"Date","value":"Fri, 28 Jan 2022 23:14:25 GMT"},{"key":"Keep-Alive","value":"timeout=5"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"object data"}],"_postman_id":"d4dd2d25-c75f-4b19-94be-e1182b39d63d"},{"name":"S3 Get Object ACL","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('Status 200', function () {"," pm.expect(pm.response.code === 200).to.be.true;","});"]}}],"id":"f7bb7fd0-021d-41e7-83c7-7b44968ff91a","request":{"method":"GET","header":[],"url":"https://s3..backblazeb2.com//?acl","description":"

Returns the access control list (ACL) of an object. In Backblaze B2, ACLs are managed at the bucket level and objects inherit their bucket's ACL. Docs: https://www.backblaze.com/apidocs/s3-get-object-acl

Returns the Object Lock legal-hold status of an object. Requires Object Lock to be enabled on the bucket. Docs: https://www.backblaze.com/apidocs/s3-get-object-legal-hold

Returns the Object Lock retention settings of an object. Requires Object Lock to be enabled on the bucket. Docs: https://www.backblaze.com/apidocs/s3-get-object-retention

Retrieves metadata for an object without returning the object data, using the same headers as S3 Get Object. Docs: https://www.backblaze.com/apidocs/s3-head-object

Optional. Target a specific object version.

\n","type":"text/plain"},"key":"versionId","value":""}],"variable":[]}},"response":[{"id":"305d4ca8-a4bc-42e6-9b9b-1ebc3cc73ebe","name":"S3 Head Object","originalRequest":{"method":"HEAD","header":[{"key":"x-amz-expected-bucket-owner","value":"","description":"Optional. Account ID of the expected bucket owner. If the bucket is owned by a different owner, a 403 Access Denied error will be returned.","disabled":true},{"key":"x-amz-server-side-encryption-customer-algorithm","value":"AES256","description":"Optional. Encryption algorithm to be used for SSE-C.","disabled":true},{"key":"x-amz-server-side-encryption-customer-key","value":"kmxlnaH92TEckb+8giJF8qPR5lPY5NDBsIpQQZwAn7A=","description":"Optional. Base64-encoded customer key for SSE-C.","disabled":true},{"key":"If-Match","value":"","description":"Optional. Only return the object if its ETag matches this value, otherwise return a 412 (precondition failed) error.","disabled":true},{"key":"If-Modified-Since","value":"","description":"Optional. Only copy the object if it has been modified since this time, otherwise return a 304 (not modified) response.","disabled":true},{"key":"If-None-Match","value":"","description":"Optional. Only copy the object if its ETag does not match this value, otherwise return a 304 (not modified) response.","disabled":true},{"key":"If-Unmodified-Since","value":"","description":"Optional. Only copy the object if it has not been modified since this time, otherwise return a 412 (precondition failed) error.","disabled":true},{"key":"x-backblaze-live-read-enabled","value":"","description":"Optional. To retrieve metadata from an ongoing multipart upload with Live Read enabled, the value must be TRUE.\n\nAny value other than TRUE (case-insensitive) is treated as false.\n","disabled":true}],"url":{"raw":"https://s3..backblazeb2.com/:bucket/:key","protocol":"https","host":["s3","","backblazeb2","com"],"path":[":bucket",":key"],"query":[{"key":"partNumber","value":"","description":"Part number to read, between 1 and 10,000.","disabled":true},{"key":"versionId","value":"","description":"VersionId to read.","disabled":true}],"variable":[{"key":"bucket","value":"my-bucket-name","description":"Required. The name of the bucket"},{"key":"key","value":"object-1","description":"Required. Key of the object to read."}]}},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":[{"key":"Accept-Ranges","value":"bytes"},{"key":"Last-Modified","value":"Fri, 28 Jan 2022 23:12:33 GMT"},{"key":"ETag","value":"\"85f30635602dc09bd85957a6e82a2c21\""},{"key":"Cache-Control","value":"no-cache"},{"key":"x-amz-request-id","value":"a42d54e0e48c6deb"},{"key":"x-amz-id-2","value":"aMYU1lmaMOc4zLDX9Y2Nm+DQAZKpj4WIH"},{"key":"x-amz-version-id","value":"4_z6145af89f355ac2f74ed0c1b_f416a807037a7ee2a_d20220128_m231233_c004_v0402000_t0056"},{"key":"x-backblaze-live-read-enabled","value":"True","description":""},{"key":"x-backblaze-live-read-part-size","value":"5000","description":""},{"key":"Content-Type","value":"text/plain"},{"key":"Content-Length","value":"0"},{"key":"Date","value":"Fri, 28 Jan 2022 23:18:43 GMT"},{"key":"Keep-Alive","value":"timeout=5"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"bd091c9f-a76b-4d20-b780-d7d180369d1d"},{"name":"S3 Put Object","event":[{"listen":"prerequest","script":{"exec":["// SSE-C: derive customer-key-MD5 from customer-key if it's set.","// (Content-MD5 for the body is NOT set here — Postman cannot reliably hash a binary","// body in JS; rely on SigV4's x-amz-content-sha256 for integrity. If you use Object","// Lock with retention, precompute Content-MD5 externally and add it manually.)","const key = pm.request.headers.get('x-amz-server-side-encryption-customer-key');","if (key) {"," pm.request.headers.add({"," key: 'x-amz-server-side-encryption-customer-key-MD5',"," value: CryptoJS.MD5(CryptoJS.enc.Base64.parse(key)).toString(CryptoJS.enc.Base64)"," });","}"],"type":"text/javascript"}},{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('Status 200', function () {"," pm.expect(pm.response.code === 200).to.be.true;","});"]}}],"id":"7158696a-87b4-403a-bdb2-e4925fb97d9e","request":{"method":"PUT","header":[],"body":{"mode":"file","file":{"src":""}},"url":"https://s3..backblazeb2.com//","description":"

Uploads an object to a B2 bucket via the S3-compatible API.

Body mode is set to file — pick the file you want to upload in the body tab.

SigV4 integrity: Postman's AWS Signature V4 helper signs x-amz-content-sha256 automatically; an explicit Content-MD5 header is not required for normal uploads. If you use Object Lock retention, AWS S3 may require a separately-precomputed Content-MD5 — Postman cannot reliably hash a binary body in a pre-request script, so compute it externally and add the header manually.

Docs: https://www.backblaze.com/apidocs/s3-put-object

Required. Allowed values are \"private\" or \"public-read\".

\n","type":"text"}],"url":"https://s3..backblazeb2.com//?acl","description":"

Sets the ACL on a specific object via the x-amz-acl header.

Backblaze B2 behavior: B2 supports bucket-level ACLs only, and objects inherit their bucket's ACL. Setting a per-object ACL that differs from the bucket's ACL returns HTTP 403 Forbidden. Only the canned ACLs private and public-read are accepted; values such as authenticated-read and bucket-owner-read are not supported.

Docs: https://www.backblaze.com/apidocs/s3-put-object-acl

Applies or removes an Object Lock legal hold on an object. Requires Object Lock to be enabled on the bucket. Docs: https://www.backblaze.com/apidocs/s3-put-object-legal-hold

Sets retention on a specific object version.

must be a future ISO 8601 timestamp (e.g., 2030-12-31T00:00:00.000Z); B2 returns 400 InvalidRetentionPeriod for past dates.

Mode: COMPLIANCE is irrevocable until the date passes. GOVERNANCE (used here as the safer default) allows users with the bypassGovernance capability to delete or shorten the retention if you make a mistake.

Docs: https://www.backblaze.com/apidocs/s3-put-object-retention

\n","auth":{"type":"awsv4","awsv4":{"basicConfig":[{"key":"accessKey","value":""},{"key":"secretKey","value":""}],"advancedConfig":[{"key":"region","value":""},{"key":"service","value":""}]},"isInherited":true,"source":{"_postman_id":"2bd51552-2df9-443f-95f1-014a26894b00","id":"2bd51552-2df9-443f-95f1-014a26894b00","name":"Backblaze B2 Cloud Storage S3-Compatible API","type":"collection"}},"urlObject":{"protocol":"https","path":["",""],"host":["s3","","backblazeb2","com"],"query":[{"key":"retention","value":""}],"variable":[]}},"response":[{"id":"79e636f3-aebe-4bea-af3e-862feca991be","name":"S3 Put Object Retention","originalRequest":{"method":"PUT","header":[{"key":"x-amz-bypass-governance-retention","value":"","description":"Optional. Specifies whether this request should bypass governance controls.","type":"text","disabled":true},{"key":"x-amz-expected-bucket-owner","value":"","description":"Optional. Account ID of the expected bucket owner. If the bucket is owned by a different owner, a 403 Access Denied error will be returned.","type":"text","disabled":true}],"body":{"mode":"raw","raw":"\n\n COMPLIANCE\n 2022-02-02T23:56:06.538Z\n","options":{"raw":{"language":"xml"}}},"url":{"raw":"https://s3..backblazeb2.com/:bucket/:key?retention","protocol":"https","host":["s3","","backblazeb2","com"],"path":[":bucket",":key"],"query":[{"key":"versionId","value":null,"description":"Optional. Specifies a particular version of the object.","type":"text","disabled":true},{"key":"retention","value":null}],"variable":[{"key":"bucket","value":"my-bucket-name","description":"Required. The name of the bucket"},{"key":"key","value":"object-1","description":"Required. Key of the object to be written."}]}},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":[{"key":"x-amz-request-id","value":"57a0fb6edf0b5178"},{"key":"x-amz-id-2","value":"aMTc1fGa/OdwzKTUuYxlmIjSCZF5jv2Iq"},{"key":"Cache-Control","value":"max-age=0, no-cache, no-store"},{"key":"Content-Type","value":""},{"key":"Content-Length","value":"0"},{"key":"Date","value":"Fri, 28 Jan 2022 23:22:02 GMT"},{"key":"Keep-Alive","value":"timeout=5"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"08e2810e-a8d4-4be9-a94b-b14a2c178842"}],"id":"9514d6a6-44ea-460e-b83f-308e2493b606","_postman_id":"9514d6a6-44ea-460e-b83f-308e2493b606","description":"","auth":{"type":"awsv4","awsv4":{"basicConfig":[{"key":"accessKey","value":""},{"key":"secretKey","value":""}],"advancedConfig":[{"key":"region","value":""},{"key":"service","value":""}]},"isInherited":true,"source":{"_postman_id":"2bd51552-2df9-443f-95f1-014a26894b00","id":"2bd51552-2df9-443f-95f1-014a26894b00","name":"Backblaze B2 Cloud Storage S3-Compatible API","type":"collection"}}}],"auth":{"type":"awsv4","awsv4":{"basicConfig":[{"key":"accessKey","value":""},{"key":"secretKey","value":""}],"advancedConfig":[{"key":"region","value":""},{"key":"service","value":""}]}},"event":[{"listen":"prerequest","script":{"type":"text/javascript","requests":{},"exec":[""]}},{"listen":"test","script":{"type":"text/javascript","requests":{},"exec":[""]}}],"variable":[{"key":"applicationKeyId","value":"","type":"string","description":"B2 application key ID. Note: master application keys cannot be used with the S3-Compatible API; create a non-master key first."},{"key":"applicationKey","value":"","type":"string","description":"B2 application key (the secret value). Capture it when creating the key — it is not retrievable later."},{"key":"region","value":"","type":"string","description":"B2 region code (e.g., us-west-004, eu-central-003). Find this in your bucket's Endpoint URL in the B2 console. Note: B2 region codes have 3-digit suffixes — they are NOT AWS region names like us-west-1."},{"key":"bucketName","value":"","type":"string","description":"B2 bucket name to target. Set once at collection level so every request inherits."},{"key":"objectKey","value":"","type":"string","description":"Object key (path within bucket) for object-level operations."},{"key":"objectKey1","value":"","type":"string","description":"First object key for multi-object operations (S3 Delete Objects)."},{"key":"objectKey2","value":"","type":"string","description":"Second object key for multi-object operations (S3 Delete Objects)."},{"key":"uploadId","value":"","type":"string","description":"Multipart upload ID, returned by S3 Create Multipart Upload."},{"key":"versionId","value":"","type":"string","description":"Object version ID, used for versioned operations."},{"key":"partNumber","value":"1","type":"string","description":"Part number for S3 Upload Part."},{"key":"part1ETag","value":"","type":"string","description":"ETag of part 1, captured from S3 Upload Part response."},{"key":"part2ETag","value":"","type":"string","description":"ETag of part 2, captured from S3 Upload Part response."},{"key":"retainUntilDate","value":"","type":"string","description":"ISO 8601 future timestamp for S3 Put Object Retention (e.g., 2030-12-31T00:00:00.000Z). Must be in the future or B2 returns 400 InvalidRetentionPeriod."}]}