Perform a transaction using your Spaces client configuration. Note that this does not perform any exception handling; if caught at the lower level, exceptions are generally re-thrown as SpacesExceptions

To run a SpacesT action with arguments in the opposite order, you can use runSpacesT directly

Create a new Spaces in a given Region while specifying a method to retrieve your credentials:

FromFile expects a configuration file in the same format as AWS credentials files, with the same field names. For example:

[default]
aws_access_key_id=AKIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

FromEnv will look up the following environment variables to find your keys: AWS_ACCESS_KEY_ID , SPACES_ACCESS_KEY_ID , SPACES_ACCESS_KEY for the AccessKey, and AWS_SECRET_ACCESS_KEY , SPACES_SECRET_ACCESS_KEY , and SPACES_SECRET_KEY for your SecretKey. Alternatively, you can directly specify the environment variables to consult.

You can also choose to provide both keys yourself with Explicit

Upload an Object within a single request

Initiate and complete a multipart upload, using default UploadHeaders. If a SpacesException is thrown while performing the transaction, an attempt will be made to runSpaces a CancelMultipart request, and the exception will be rethrown

Upload a file's contents as an Object. This will attempt to set the correct MimeType based on the file extension

Get an Object (retrieves the actual body of the object)

Get an Object's data and write it to the provided FilePath

Get information about an Object (does not retrieve the body of the object)

Copy an Object from one Bucket to another; this chooses a number of defaults to represent the most common cases and avoid a preponderance of parameters. Objects are copied using default ACLs with the COPY metadata directive.

If you'd like to use a specfic CannedACL or MetadataDirective, use CopyObject directly with runAction

Copy an Object within the same Bucket, using defaults for the MetadataDirective and CannedACL

Copy an Object to itself, overwriting its associated metadata

Delete a single Object

Get an Object's Access Control Lists

Set an Object's Access Control Lists

Create a new Bucket

Delete a Bucket

Get the location (Region) of a Bucket

List every Bucket associated with your Spaces account

List the Objects of a Bucket, without grouping, delimiting, or limiting the keys (i.e. list all Objects non-hierarchically, up to the Spaces limit)

List the Objects of a Bucket, using a delimiter and prefix to group objects. For example / can be used as a delimiter to treat objects as directories within the bucket, which can further be combined with a text prefix

Recursively list all Objects in a Bucket, calling ListBucket until isTruncated is False. This operation may take some time, depending on the total number of objects in your bucket

Get the CORSRules configured for a given Bucket

Delete the existing configured CORSRules for a given Bucket

Set CORSRules for a given Bucket

Get a Bucket's Access Control Lists

Set a Bucket's Access Control Lists. Spaces only allows a limited subset of s3 ACLs at the moment. It may be preferable to use a CannedACL when creating new resources rather than using this action, which is provided for the sake of completeness.

Note that to allow public read-only access to your bucket, you must simultaneously set full owner control.

Get a Bucket's LifecycleRule configuration . Note that unless you have explicitly configured lifecycle rules, this will fail with a 404 status and an error code of NoSuchLifecycleConfiguration

Set a Bucket's LifecycleRule configuration

Delete a Bucket's LifecycleRule configuration

A client for interacting with the DO Spaces API

A ConsumedResponse with optional SpacesMetadata

Metadata and other response information returned from each Spaces API transaction; it can be helpful to retain this at times

The name of a single storage bucket

Smart constructor for Buckets; names must conform to the following rules:

• They must be between 3 and 63 characters in length
• They may only contain lowercase letters, digits, dots, and hyphens
• They must begin and end in a number or letter See more at: https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html.

This function ensures that names are valid and will also convert the Text to lowercase

The name of a "key", in AWS parlance

Smart constructor for Objects; names must not be empty

DO regions where Spaces is available (only a subset of all regions)

Spaces access key

Spaces secret key

How to discover AccessKeys and SecretKeys when creating a new Spaces client.

The name of a per-project configuration profile to select when loading credentials from a file

Cross-origin resource sharing rules

Smart constructor for CORSRule. Ensures that both origins and header names contain a maximum of one wildcard and removes duplicates from both headers and methods

An individual access grant

Information about who an access grant applies to

Access grant level; Spaces currently only supports these two levels

A unique ID for a LifecycleRule

Smart constructor for LifecycleID, which may contain a maximum of 255 characters, including spaces

The base Exception type for both ClientExceptions and APIExceptions

An exception generated within the Spaces client

An s3-compatible API error response, sent as XML