live
archival
live
state in multiple projects with the same billTo
entity. The file is still in standard storage.archived
unarchiving
live
archival
archived
unarchiving
archival
to archived
.project-xxxx/archive
API is called upon a file object, the file transitions from the live
state to the archival
state. Only when all copies of a file in all projects with the same billTo
organization are in the archival
state, does the file transition to the archived
state automatically by the platform.project-xxxx/unarchive
API is called upon a file in the archived
state, the file transitions from the archived
to the unarchiving
state. During the unarchiving
state, the file is being restored by the third-party storage platform (e.g., AWS or Azure). The unarchiving
process may take a while depending on the retrieval option selected for the specific platform. Finally, when the unarchival process is completed, and the file becomes available on standard storage, the file is transitioned to a live
state.CONTRIBUTE
or ADMINISTER
permissions to a project to archive or unarchive files that reside in the project. Via API calls, users can archive or unarchive files, folders, or entire projects, although the archival process itself happens at the file level. The API can accept a list of up to 1000 files for archival and unarchival. When archiving or unarchiving folders or projects, the API by default will archive or unarchive all the files at the root level and those in the subfolders recursively. If you archive a folder or a project that includes filess in different states, the Service will only archive files that are in the live
state and skip files that are in other states. Likewise, if you unarchive a folder or a project that includes files in different states, the Service will only unarchive files that are in the archived
state, transition archival
files back to the live
state, skip files in other states.live
and archival
state incur this charge. The archival
state indicates that the file is waiting to be archived or that other copies of the same file in other projects are still in the live
state, so the file is in standard storage (such as AWS S3). The standard storage charge continues to get billed until all copies of the file are requested to be archived and eventually the file is moved to archival storage and transitioned into the archived
state.archived
state incur a monthly archival storage charge.archival
state, which still incurs the standard storage cost. To achieve the lower archival storage cost, you need to ensure that all copies of the file in all projects with the same billTo
org are being archived. When all the copies of the file transition into the archival
state, the Service automatically transitions the files from the archival
state to the archived
state. We recommend using the allCopies
option of the API to force archiving all the copies of the file. You must be the org ADMIN of the billTo
org of the current project to use the allCopies
option.file-xxxx
has copies in project-xxxx
, project-yyyy
, and project-zzzz
which are sharing the same billTo
org (org-xxxx
). You are the ADMINISTER
of project-xxxx
, and a CONTRIBUTE
of project-yyyy
, but do not have any role in project-zzzz
. You are the org ADMIN of the project billTo
org, and try to archive all copies of files in all projects with the same billTo
org using /project-xxxx/archive:org-xxxx
file-xxxx
file-xxxx
will be archived and transitioned into the archived
state.