risultati

Un risultato è un record di dati o un file che è stato pubblicato su un bucket di archiviazione. Contiene le informazioni necessarie per recuperare questi dati dalla sua posizione di archiviazione.

attributi

URL firmati

Se la generazione dell'URL con segno è abilitata nella configurazione di archiviazione utilizzata per pubblicare il risultato, signed_url verrà impostato su un dizionario con il formato:

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

L'attributo date_expires indica quando l'URL firmato cesserà di essere valido. Dopo questa data, l'attributo signed_url del risultato verrà impostato su null .

Vedi maggiori dettagli sulla configurazione degli URL firmati nei documenti di configurazione dell'archiviazione .

stati

available

Il risultato è pronto per essere scaricato dal secchio.

consumed

Il risultato è stato scaricato e l'API è stata informata.

expired

Il risultato è stato cancellato dal bucket tramite una pulizia pianificata. Questo stato non si applica ai bucket di proprietà del cliente.

Recupera GET /results/{result ID}

Utilizzando cURL

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

Usando ricloud-py

import ricloud

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

Elenco GET /results

I risultati negli stati consumed o expired non vengono visualizzati nell'elenco per impostazione predefinita.

parametri

Utilizzando cURL

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

Usando ricloud-py

import ricloud

results = ricloud.Result.list()

Conferma POST /results/{result ID}/ack

Riconoscere il risultato come se fosse stato consumato.

Utilizzando cURL

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

Usando ricloud-py

import ricloud

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

# OR

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

result.acknowledge()

Lotto conferma POST /results/ack

Riconoscere una serie di risultati come consumati.

L'endpoint non genererà un errore se uno dei risultati specificati è già stato riconosciuto o non può essere trovato.

Utilizzando 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

• Aggiunge l'attributo signed_url all'oggetto risultato. Questo è un dizionario nidificato contenente l'URL firmato nell'attributo url e quando scade tra date_expires .
• Aggiunge la possibilità di riconoscere i risultati in batch con il nuovo endpoint POST /results/ack .