Skip to main content
Version: Next

TransferDetailDto

localIdstringrequired
Example: local-12345
remoteIdstring
Example: remote-98765
rolestringrequired
Example: provider
remoteAddressstringrequired
Example: http://example.com/
remotePartystringrequired
Example: party-identifier-001
statestringrequired

Possible values: [dspace:REQUESTED, dspace:STARTED, dspace:TERMINATED, dspace:COMPLETED, dspace:SUSPENDED]

Example: dspace:REQUESTED
process object
@typestringrequired
Example: dspace:TransferProcess
dspace:providerPidstringrequired
Example: provider-pid-789
dspace:consumerPidstringrequired
Example: consumer-pid-123
dspace:agreementIdstringrequired
Example: agreement-id-456
dspace:statestringrequired
Example: COMPLETED
agreementIdstringrequired
Example: agreement-45678
formatstring
Example: application/json
modifiedDatedate-timerequired
Example: 2023-10-01T12:34:56Z
dataAddress object
@typestringrequired
Example: dspace:DataAddress
dspace:endpointTypestringrequired
Example: http
dspace:endpointstringrequired
Example: https://api.example.com
dspace:endpointProperties object[]required
  • Array [
  • @typestringrequired
    Example: dspace:EndpointProperty
    dspace:namestringrequired
    Example: endpointName
    dspace:valuestringrequired
    Example: endpointValue
  • ]
  • dataPlaneTransfer object
    acceptedbooleanrequired
    Example: true
    identifierstringrequired
    Example: req-identifier
    dataAddress object
    endpointstringrequired
    Example: http://data-plane-endpoint
    properties object[]required
  • Array [
  • namestringrequired
    Example: propertyName
    valuestringrequired
    Example: propertyValue
  • ]
  • callbackAddressstring
    Example: http://callback-address
    dataPlaneIdentifierstringrequired
    Example: transfer-identifier
    endpointTypestringrequired
    Example: type1
    events object[]required
  • Array [
  • timedate-timerequired
    Example: 2023-10-01T12:00:00Z
    statestringrequired

    Possible values: [dspace:REQUESTED, dspace:STARTED, dspace:TERMINATED, dspace:COMPLETED, dspace:SUSPENDED]

    Example: dspace:COMPLETED
    localMessagestring
    Example: The transfer completed successfully.
    codestring
    Example: ERR_NONE
    reason object
    @valuestringrequired
    Example: This is a sentence.
    @languagestringrequired
    Example: en
    typestringrequired

    Possible values: [local, remote]

    Example: local
  • ]
  • TransferDetailDto
    {
    "localId": "local-12345",
    "remoteId": "remote-98765",
    "role": "provider",
    "remoteAddress": "http://example.com/",
    "remoteParty": "party-identifier-001",
    "state": "dspace:REQUESTED",
    "process": {
    "step": "upload",
    "progress": 50
    },
    "agreementId": "agreement-45678",
    "format": "application/json",
    "modifiedDate": "2023-10-01T12:34:56Z",
    "dataAddress": {
    "type": "S3",
    "bucketName": "example-bucket",
    "region": "us-east-1"
    },
    "dataPlaneTransfer": {
    "transportProtocol": "HTTP",
    "endpoint": "https://data-plane.example.com/transfer"
    },
    "events": [
    {
    "time": "2023-10-01T12:00:00Z",
    "state": "dspace:STARTED",
    "localMessage": "Upload started.",
    "code": "STARTED",
    "reason": [
    {
    "language": "en",
    "value": "Transfer initiated"
    }
    ],
    "type": "local"
    }
    ]
    }