Example: Copying a file to itself

Frequency of useCommon
TriggerUser-initiated action, typically through the user-interface
Pre-conditions
  • A file present at /123/my/file
  • The user has EDIT permissions on the file
  • The provider supports RENAME for conflict policies
Post-conditions
  • A new file present at '/123/my/file (1)'
Actors
  • An authenticated user (user)
Communication Flow: Kotlin
Files.copy.call(
    bulkRequestOf(FilesCopyRequestItem(
        conflictPolicy = WriteConflictPolicy.RENAME, 
        newId = "/123/my/file", 
        oldId = "/123/my/file", 
    )),
    user
).orThrow()

/*
BulkResponse(
    responses = listOf(LongRunningTask.Complete()), 
)
*/
Communication Flow: TypeScript
// Authenticated as user
await callAPI(FilesApi.copy(
    {
        "items": [
            {
                "oldId": "/123/my/file",
                "newId": "/123/my/file",
                "conflictPolicy": "RENAME"
            }
        ]
    }
);

/*
{
    "responses": [
        {
            "type": "complete"
        }
    ]
}
*/
Communication Flow: Curl
# ------------------------------------------------------------------------------------------------------
# $host is the UCloud instance to contact. Example: 'http://localhost:8080' or 'https://cloud.sdu.dk'
# $accessToken is a valid access-token issued by UCloud
# ------------------------------------------------------------------------------------------------------

# Authenticated as user
curl -XPOST -H "Authorization: Bearer $accessToken" -H "Content-Type: content-type: application/json; charset=utf-8" "$host/api/files/copy" -d '{
    "items": [
        {
            "oldId": "/123/my/file",
            "newId": "/123/my/file",
            "conflictPolicy": "RENAME"
        }
    ]
}'


# {
#     "responses": [
#         {
#             "type": "complete"
#         }
#     ]
# }
Communication Flow: Visual