resultaten

Een resultaat is een record met gegevens of een bestand dat is gepubliceerd naar een opslagbunker. Het bevat de informatie die nodig is om deze gegevens op te halen uit de opslaglocatie.

attributen

Ondertekende URL's

Als het genereren van ondertekende URL's is ingeschakeld in de opslagconfiguratie die is gebruikt om het resultaat te publiceren, wordt signed_url ingesteld op een woordenboek met de indeling:

{
  "url": "<signed URL value here>",
  "date_expires": "2020-02-29T11:59:15.110451Z"
}

Het kenmerk date_expires geeft aan wanneer de ondertekende URL niet meer geldig is. Na deze datum wordt het kenmerk signed_url het resultaat ingesteld op null .

Zie meer details over het configureren van ondertekende URL's in de opslagconfiguratiedocumenten .

Staten

available

Het resultaat kan worden gedownload vanuit de bucket.

consumed

Het resultaat is gedownload en de API is geïnformeerd.

expired

Het resultaat is uit de bucket verwijderd door een geplande opschoning. Deze status is niet van toepassing op door klanten beheerde buckets.

Ophalen GET /results/{result ID}

CURL gebruiken

curl https://ricloud-api.reincubate.com/results/<result ID> \
  -H 'Authorization: Token <your key_token>'

Ricloud-py gebruiken

import ricloud

results = ricloud.Result.retrieve(<result ID>)

Lijst GET /results

Resultaten in de consumed of expired staten consumed standaard niet in de lijst weergegeven.

parameters

CURL gebruiken

curl https://ricloud-api.reincubate.com/results \
  -H 'Authorization: Token <your key_token>'

Ricloud-py gebruiken

import ricloud

results = ricloud.Result.list()

Bevestig POST /results/{result ID}/ack

Erken het resultaat als zijnde geconsumeerd.

CURL gebruiken

curl https://ricloud-api.reincubate.com/results/<result ID>/ack \
  -X POST \
  -H 'Authorization: Token <your key_token>'

Ricloud-py gebruiken

import ricloud

result = ricloud.Result.acknowledge_with_id(<result ID>)

# OR

result = ricloud.Result.retrieve(<result ID>)

result.acknowledge()

Batch bevestig POST /results/ack

Erken dat een reeks resultaten is verbruikt.

Het eindpunt geeft geen foutmelding als een van de opgegeven resultaten al is bevestigd of niet kan worden gevonden.

CURL gebruiken

curl https://ricloud-api.reincubate.com/results/ack \
  -X POST \
  -H 'Authorization: Token <your key_token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "ids": ["<result ID>", "<result ID>"]
}'

Changelog

2020-02-27

• Voegt het kenmerk signed_url toe aan het resultaatobject. Dit is een genest woordenboek dat de ondertekende URL in het url kenmerk bevat en wanneer het vervalt in date_expires .
• Voegt de mogelijkheid toe om resultaten in batches te erkennen met het nieuwe POST /results/ack eindpunt.