> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/deployment/ja/to/vision-events/upload-a-vision-event-bundle.md).

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

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

## 概要

この [Write Vision Event Bundle](https://docs.roboflow.com/workflows/blocks/blocks/data-storage/vision-event-bundle) ブロックは、Roboflowに送信する代わりに、イベントごとに1つのtarballをローカルディスクに書き込みます。推論サーバーがクラウドへの経路を持たないネットワークで稼働している場合に使用してください。このエンドポイントはtarballをそのまま受け取ります。アップローダーが各ファイルをPOSTすると、Roboflowが展開して画像をアップロードし、 [Vision Event](https://docs.roboflow.com/deployment/ja/to/vision-events.md).

## HTTP API

リクエスト本文には未加工のアーカイブバイト列をそのまま送信します。JSONやマルチパート形式は使用しないでください。本文はバイナリ形式なので、APIキーは `Authorization: Bearer` ヘッダー、または `api_key` クエリパラメーターで送信してください。

**必須スコープ：** `vision-events:write` または `device:update`

{% openapi src="/files/934e54fa9aa57656316a422a76238b867f081de5" path="/vision-events/bundle" method="post" %}
[openapi.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-0988c6c6c600d725f72d1ecfe0cbeba9b717363f%2Fopenapi.yaml?alt=media)
{% endopenapi %}

### バンドル形式

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

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

`payload.json` は、次のものと同じ構造です:  [Vision Eventの作成](https://docs.roboflow.com/deployment/ja/to/vision-events/create-a-vision-event.md#http-api) リクエスト本文。ただし、次の2点が異なります:

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

画像は `images/` ディレクトリ内に配置する必要があります。画像から参照されていないメンバーや、 `images/`以外のトップレベルディレクトリがある場合、取り込み時に警告が追加されますが、イベントの処理は停止しません。バンドルに含められるのは画像のみです。 `videos/` ディレクトリは警告を出して無視されます。クリップを添付するには、 [動画をアップロード](https://docs.roboflow.com/deployment/ja/to/vision-events/upload-a-vision-event-video.md) してください。

payload.json `内のフィールドエラー` は、JSONエンドポイントの場合と同様に処理されます。詳しくは、 [検証と警告](https://docs.roboflow.com/deployment/ja/to/vision-events/create-a-vision-event.md#validation-and-warnings).

### ユースケース

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

### 制限

<table data-search="false"><thead><tr><th>上限</th><th>値</th><th>失敗時のステータス</th></tr></thead><tbody><tr><td>リクエストボディ</td><td>25 MB</td><td>413</td></tr><tr><td>展開後のアーカイブ</td><td>75 MB</td><td>413</td></tr><tr><td><code>payload.json</code></td><td>10 MB</td><td>413</td></tr><tr><td>アーカイブ内のエントリ数</td><td>217</td><td>413</td></tr><tr><td>バンドルあたりの画像数</td><td>100</td><td>400</td></tr><tr><td>画像あたりのピクセル数</td><td>80 MP</td><td>413</td></tr></tbody></table>

### 再試行

アップロードに失敗した場合や、結果が不明な場合は、同じバンドルを再度送信できます。画像はコンテンツに基づいて照合され、重複して届いたイベントは先に届いたものを置き換えます。課金は1回のみです。
