Relevant Issue: https://sagebionetworks.jira.com/browse/PLFMPLFM-4253
StorageLocationSettings are immutable and thus can be cached client side. The information in these will therefore not be repeated in the new implementations of UploadDestination and FileHandle.The keyPath in ClientDelegatedS3UploadDestination is client generated: baseKey/<<UUID>>
keyPrefixUUID is a new UUID generated by the backend every time a ExternalObjectStoreUploadDestination is requested.
The key in ClientDelegatedS3FIleHandleExternalObjectStorageFileHandle, once uploaded will be baseKeykeyPrefixUUID/<<UUID>>/fileName.
New API
The Interfaces exist for future comparability in case we need to add other client reliant storage solutions
New API
Because the upload must occur client-side, the client must be responsible for creating the FIleHandle once uploading has completedclients are responsible for creating FileHandles after upload has completed since Synapse does not have access to the new storage location
With the changes to the hierarchy of FileHandle, the POST /externalFileHandle service will be made generic to allow all implementations of ExternalFileHandleInterface
| Action | URI | Method | Request Body | Response Body |
|---|---|---|---|---|
| Creates a ClientDelegatedS3FileHandle. Its storageLocationId must match that of a ClientDelegatedS3StorageLocationSettingany instance of an ExternalFileHandleInterface | /externalFileHandle/clientS3???? | POST | ClientDelegatedS3FileHandle | ClientDelegatedS3FIleHandle |
Unanswered questions
...
| ExternalFileHandleInterface | ExternalFileHandleInterface |