結果

結果は、ストレージバケットに公開されたデータまたはファイルのレコードです。それはその格納場所からこのデータを検索するのに必要な情報を含みます。

属性

署名付きURL

結果の公開に使用されるストレージ構成で署名付きURL生成が有効になっている場合、 signed_urlは次の形式の辞書に設定されます。

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

date_expires属性は、署名付きURLがいつ無効になるかを示します。この日付以降、結果のsigned_url属性はnullに設定されnull 。

署名付きURLの構成の詳細については、 ストレージ構成ドキュメントをご覧ください。

州

available

結果はバケットからダウンロードする準備ができています。

consumed

結果がダウンロードされ、APIに通知されました。

expired

結果は、スケジュールされたクリーンアップによってバケットから削除されました。この状態は、クライアント所有のバケットには適用されません。

GET /results/{result ID}取得してください

cURLを使う

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

ricloud-pyを使う

import ricloud

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

リストGET /results

consumedまたはexpiredの状態の結果は、デフォルトではリストに表示されません。

パラメーター

cURLを使う

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

ricloud-pyを使う

import ricloud

results = ricloud.Result.list()

POST /results/{result ID}/ack

結果が消費されたことを確認します。

cURLを使う

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

ricloud-pyを使う

import ricloud

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

# OR

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

result.acknowledge()

POST /results/ackバッチ確認

結果のバッチが消費されたものとして認めます。

指定された結果のいずれかがすでに確認されているか、見つからない場合でも、エンドポイントはエラーを発生させません 。

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>"]
}'

変更ログ

2020-02-27

• signed_url属性を結果オブジェクトに追加します。これは、 url属性に署名されたurlが含まれ、それがdate_expiresで期限切れになるときのネストされた辞書です。
• 新しいPOST /results/ackエンドポイントを使用して、結果をバッチで確認する機能を追加します。