Storage object structure
The API represents storages as JSON objects.
JSON object structure of a storage
Name |
Value type |
Description |
---|---|---|
|
UUID string |
The UUID of the storage. |
|
UUID string |
The UUID of the tenant this storage belongs to. |
|
UUID string |
The UUID of the location this storage belongs to. |
|
boolean |
Flag, that specifies if it is platform-owned storage. |
|
string |
A name of the storage. |
|
string |
The URL of the storage. See storage url formatting rules |
|
array of strings |
A list of services this storage can be used in. See the list of available storage capabilities. |
|
string |
The URL to the web interface of the restore server. |
|
string |
The URL to the archive server used by mobile backup apps to access the cloud storage. |
|
string |
The backend type of the storage. Once the storage has been created, the |
|
number |
Revision number. |
|
boolean |
Flag, that specifies if the location can be modified. |
Example storage
{
"id": "8fcd353b-0a40-40f2-9a55-ef8137d48800",
"owner_tenant_id": "0bb386ae-e66d-4e7b-84fb-cddcf60002de",
"location_id": "f79546d7-d051-4e19-96f3-4cc68c2c5575",
"platform_owned": true,
"name": "Azure Backup Storage",
"url": "acronis+fes://storage20.corp.acronis.com:44445",
"capabilities": [
"backup",
"disaster_recovery",
"files_cloud"
],
"content_url": "https://browse.storage20.corp.acronis.com/",
"content_mobile_url": "https://browse.storage20.corp.acronis.com/mobile/",
"backend_type": "azure",
"version": 3,
"readonly": false
}
Available storage types and required credentials
Acronis S3 Storage or other S3-compatible storage
s3 access key id
s3 secret access key
storage address
bucket name
encryption type (AES-128, AES-256) you want to use (optional)
Amazon S3
region (optional)
encryption type (AES-128, AES-256) you want to use (optional)
Microsoft Azure
encryption type (AES-128, AES-256) you want to use (optional)
Storage URL formatting rules
The storage URL must comply with RFC 1738 and use the following storage URL schemes:
Value |
Description |
---|---|
|
Acronis Storage |
|
Acronis File Sync & Share Storage |
|
Acronis S3 Storage or other S3-compatible storage |
|
Amazon S3 Storage |
|
Microsoft Azure Storage |
Below are listed the URL formats for different storage types (see the list of required credentials for reference):
Acronis S3 Storage or other S3-compatible storages:
s3://<s3-access-key-id>:<s3-secret-access-key>@<storage-address>/<bucket-name>?encryption=<aes128|aes256>&use_ssl=<true|false>
Amazon S3:
amazon+s3://<s3-access-key-id>:<s3-secret-access-key>@s3-<region>.amazonaws.com/<bucket-name>?encryption=<aes128|aes256>&use_ssl=<true|false>
Note
<region> is optional, for default region use s3.amazonaws.com address.
Microsoft Azure Storage:
microsoft+azure://<azure-account-name>:<azure-access-key>@blob.core.windows.net/<azure-blob-container-name>?encryption=<aes128|aes256>
Available storage backends
Value |
Description |
---|---|
|
Acronis backend type. |
|
Google backend type. |
|
Microsoft Azure backend type. |
|
Amazon S3 backend type. |
Available storage capabilities
Value |
Description |
---|---|
|
Allows this storage to be used in “Backup” service. |
|
Allows this storage to be used in “Disaster Recovery” service. |
|
Allows this storage to be used in “File Sync & Share” service. |