> 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 を作成します。

## 概要

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

## HTTP API

生のアーカイブバイト列をリクエストボディとして送信してください。JSON や multipart は使用しないでください。ボディはバイナリなので、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-dca3d4f164ead71d7f0d6953b9ac101065bf210f%2Fopenapi.yaml?alt=media)
{% endopenapi %}

### バンドル形式

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

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

`payload.json` は次と同じ構造です [Vision Event を作成](/deployment/ja/to/vision-events/create-a-vision-event.md#request-body-parameters) リクエストボディですが、違いが 2 つあります:

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

画像は次の下に配置する必要があります: `images/` ディレクトリ。どの画像からも参照されていないメンバーや、次を除くトップレベルのディレクトリは `images/`images/ `videos/` ディレクトリは警告付きで無視されます。クリップを添付するには、 [動画をアップロード](/deployment/ja/to/vision-events/upload-a-vision-event-video.md) してください。

フィールドのエラーは `payload.json` JSON エンドポイントと同じように動作します。参照先: [検証と警告](/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>1 バンドルあたりの画像数</td><td>100</td><td>400</td></tr><tr><td>1 画像あたりのピクセル数</td><td>80 MP</td><td>413</td></tr></tbody></table>

### 再試行

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