Vision Event バンドルをアップロード

エアギャップ環境のデプロイメントによって作成された tarball バンドルを取り込み、Vision Event を作成します。

概要

その Vision Event Bundle の書き込み このブロックは、イベントごとに1つのtarballをRoboflowへ送信する代わりにローカルディスクに書き込みます。推論サーバーがクラウドへの経路がないネットワークで動作している場合に使用してください。このエンドポイントは、そのtarballをそのまま受け取ります。アップローダーが各ファイルをPOSTし、Roboflowがそれを展開し、画像をアップロードし、 Vision Event.

HTTP API

生のアーカイブバイト列をリクエストボディとして送信してください。JSONやmultipartは使用しないでください。ボディはバイナリなので、APIキーは Authorization: Bearer ヘッダーまたは api_key クエリパラメータに含めてください。

必要なスコープ: vision-events:write または device:update

Upload a Vision Event Bundle

post

Create one vision event from a self-contained tarball bundle written by the Write Vision Event Bundle workflow block. Post the raw archive bytes as the body.

認可

Authorizationstring必須

Roboflow API key passed as a Bearer token.

クエリパラメータ

useCaseIdstring · 最大: 256オプション

The use case the event belongs to. This overrides the useCaseId inside payload.json. Required when the bundle does not carry one.

本文

string · binaryオプション

Gzipped tar archive holding payload.json and its image members.

レスポンス

201

Event created successfully.

application/json

eventIdstringオプションExample: a1b2c3d4-e5f6-7890-abcd-ef1234567890

createdbooleanオプションExample: true

deprecationsstring[]オプション

400

Bad archive, bad payload, more than 100 images, or no use case in the query or the payload.

application/json

403

Insufficient permissions for this resource.

application/json

413

A size limit was exceeded.

application/json

post/vision-events/bundle

POST /vision-events/bundle HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/gzip
Accept: */*
Content-Length: 8

"binary"

{
  "eventId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "created": true,
  "images": [
    {
      "file": "images/9f0c1b2a-4d3e-4f5a-8b6c-7d8e9f0a1b2c.jpg",
      "sourceId": "src_abc123"
    }
  ],
  "warnings": [
    {
      "type": "text",
      "path": "text",
      "value": "text",
      "valueType": "text"
    }
  ],
  "deprecations": [
    "text"
  ]
}

バンドル形式

各バンドルには1つのイベントが含まれます。このブロックはgzip圧縮されたtarファイルを書き込みますが、通常のtarでも動作します。

event_<timestamp>_<eventId>.tar.gz
├── payload.json
└── images/<file_id>.jpg

payload.json は、次と同じ構造です Vision Event の作成 リクエストボディです。違いは2つあります:

• bundleFormatVersion は 1.

• images[].file および images[].inputFile はアーカイブメンバーのパスを保持します（例: images/9f0c1b2a.jpg）の代わりに sourceId および inputSourceId。Roboflowは各メンバーをアップロードし、イベントにソースIDを保存します。

画像は images/ ディレクトリの下に配置する必要があります。画像が参照していないメンバーと、 images/以外のトップレベルディレクトリは、取り込み警告を追加しますが、イベントは停止しません。

内のフィールドエラーは payload.json JSONエンドポイントと同じように扱われます。 検証と警告.

ユースケース

その useCaseId クエリパラメータは useCaseId 内の payload.jsonを上書きします。どちらも設定されていない場合、リクエストは400で失敗します。エアギャップ環境のサイトでは通常、ユースケースをバンドルから除外するため、クラウド識別子はローカルネットワーク内に保存されず、代わりにアップロード時に設定します。

制限

制限	値	失敗時のステータス
リクエストボディ	25 MB	413
解凍後のアーカイブ	75 MB	413
payload.json	10 MB	413
アーカイブエントリ	217	413
バンドルあたりの画像数	100	400
1画像あたりのピクセル数	80 MP	413

再試行

失敗した、または結果が不明瞭なアップロードの後でも、同じバンドルを再度投稿できます。画像は内容で照合され、2回届いたイベントは前のものを置き換えます。課金は1回のみです。