Résultats

Un résultat est un enregistrement de données ou un fichier publié dans un compartiment de stockage. Il contient les informations nécessaires pour extraire ces données de son emplacement de stockage.

Les attributs

URL signées

Si la génération d'URL signée est activée sur la configuration de stockage utilisée pour publier le résultat, le signed_url sera défini sur un dictionnaire au format:

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

L'attribut date_expires indique quand l'URL signée cessera d'être valide. Après cette date, l'attribut signed_url du résultat sera défini sur null .

Voir plus de détails sur la configuration des URL signées dans les documents de configuration de stockage .

États

available

Le résultat est prêt à être téléchargé à partir du compartiment.

consumed

Le résultat a été téléchargé et l'API a été informée.

expired

Le résultat a été supprimé du compartiment par un nettoyage planifié. Cet état ne s'applique pas aux compartiments appartenant au client.

Récupérer GET /results/{result ID}

Utiliser cURL

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

Utiliser ricloud-py

import ricloud

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

Liste GET /results

Les résultats dans les états consumed ou expired n'apparaissent pas dans la liste par défaut.

Paramètres

Utiliser cURL

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

Utiliser ricloud-py

import ricloud

results = ricloud.Result.list()

Reconnaître POST /results/{result ID}/ack

Reconnaître le résultat comme ayant été consommé.

Utiliser cURL

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

Utiliser ricloud-py

import ricloud

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

# OR

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

result.acknowledge()

Lot accusé de réception POST /results/ack réception

Reconnaissez qu'un lot de résultats a été consommé.

Le point de terminaison ne déclenchera pas d'erreur si l'un des résultats spécifiés a déjà été acquitté ou est introuvable.

Utiliser cURL

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

• Ajoute l'attribut signed_url à l'objet résultat. Il s'agit d'un dictionnaire imbriqué contenant l'URL signée dans l'attribut url et lorsqu'il expire dans date_expires .
• Ajoute la possibilité de reconnaître les résultats par lots avec le nouveau point de terminaison POST /results/ack .