POST api/resources/multipart/initialize

Initializes a multipart upload to the repository. Uploads must be completed before the resource is available for use, or aborted if it is no longer needed.

Request Information

URI Parameters

None.

Body Parameters

Arguments describing the new resource.

InitiateNewMultipartResourceArgs
NameDescriptionTypeAdditional information
Application

Application putting the resource into the repository.

string

None.

OriginalFilename

Original filename of the resource

string

None.

TimeToLiveAfterLastAccess

Indicates how long after last access to automatically delete the resource.

time interval

None.

StartCheckingTimeToLiveAtUtc

Indicates when the TimeToLive will start being checked.

date

None.

Tags

List of tags to associate with the resource

Collection of Pair of string [key] and string [value]

None.

UniqueInstanceIdentifier

String that will uniquely identify an instance uploading files.

string

None.

Request Formats

application/json, text/json

Sample:
{
  "Application": "sample string 1",
  "OriginalFilename": "sample string 2",
  "TimeToLiveAfterLastAccess": "00:00:00.1234567",
  "StartCheckingTimeToLiveAtUtc": "2024-05-19T01:33:30.035021-04:00",
  "Tags": [
    {
      "Key": "sample string 1",
      "Value": "sample string 2"
    },
    {
      "Key": "sample string 1",
      "Value": "sample string 2"
    }
  ],
  "UniqueInstanceIdentifier": "sample string 3"
}

application/xml, text/xml

Sample:
<InitiateNewMultipartResourceArgs xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Application>sample string 1</Application>
  <OriginalFilename>sample string 2</OriginalFilename>
  <TimeToLiveAfterLastAccess />
  <StartCheckingTimeToLiveAtUtc>2024-05-19T01:33:30.035021-04:00</StartCheckingTimeToLiveAtUtc>
  <Tags>
    <KeyValuePairOfStringString />
    <KeyValuePairOfStringString />
  </Tags>
  <UniqueInstanceIdentifier>sample string 3</UniqueInstanceIdentifier>
</InitiateNewMultipartResourceArgs>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

A structure containing the resource ID.

InitiateNewMultipartResourceResult
NameDescriptionTypeAdditional information
ResourceIdentifier

The identifier for the resource

globally unique identifier

None.

MaxParallelism

Max uploads to allow in parallel

integer

None.

Response Formats

application/json, text/json

Sample:
{
  "ResourceIdentifier": "023b78a8-992a-4ab3-a386-3eff8d4d1a86",
  "MaxParallelism": 2
}

application/xml, text/xml

Sample:
<InitiateNewMultipartResourceResult xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <ResourceIdentifier>023b78a8-992a-4ab3-a386-3eff8d4d1a86</ResourceIdentifier>
  <MaxParallelism>2</MaxParallelism>
</InitiateNewMultipartResourceResult>