Cloud Storage Properties are represented as a key-value pair (String-String) collection. Mentioned pairs are either directly retrieved from Cloud Storage Provider APIs object headers or derived from their values.
Storage Properties are reflected at the content level and content may (especially when in Cloud Storage) or
may not have at least one such property. Storage Properties are not persisted as part of the metadata (or any other way),
so we rely on the ContentStore and ServiceAdapter implementations to provide the means to retrieve/derive the
storage properties information.
When cloud connectors do not provide functionality to retrieve storage properties, none will be returned.
Configuration properties applicable to AWS Cloud Storage Properties functionality:
| Property name | Property value | Description |
connector.s3.nativeStorageProperties |
x-amz-archive-status,x-amz-restore,x-amz-storage-class |
Limits the list of S3 specific storage properties to be retrived |
connector.s3.archiveStorageClass |
GLACIER / DEEP_ARCHIVE |
Archive storage class set for content archive request. |
connector.s3.restoreExpiryDays |
7 | Default number of expiration days for archive-restore |
connector.s3.restoreTierDefault |
Standard / Expedited |
Default archive-restore tier (restore priority). Used when no respective value passed in archive-restore request. |
The following headers are currently (by default) returned from AWS S3 Storage:
| Name | Possible values |
x-amz-storage-class |
REDUCED_REDUNDANCY / STANDARD_IA / ONEZONE_IA / INTELLIGENT_TIERING / GLACIER_IR / GLACIER / DEEP_ARCHIVE / OUTPOSTS |
x-amz-archive-status |
ARCHIVE_ACCESS / DEEPARCHIVEACCESS |
x-amz-restore |
Complex, e.g. ongoing-request="false", expiry-date="Fri, 21 Dec 2012 00:00:00 GMT" |
Note
'STANDARD' AWS S3 storage class is not returned by AWS S3 API (hence, nor by the S3 Connector), however it appears in AWS docs
Derived Storage Properties are Alfresco specific and currently reflecting information whether content is archived (offline) and whether it is being restored from offline state (and for how long):
| Name | Possible values | Description |
x-alf-archived |
true, false |
Indicates whether content is archived (offline) and not immediately accessible |
x-alf-archive-restore-in-progress |
true, false |
Indicates whether a request to restore content from archive is progress. |
x-alf-archive-restore-expiry |
YYYYMMDDThhmmssZ (ISO-8601) datetime | Indicates expiry time for content restored from archive, applicable to AWS S3 |