> 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/hi/monitoring-and-analytics/vision-events/upload-a-vision-event-bundle.md).

# एक Vision Event Bundle अपलोड करें

एक Vision Event बनाने के लिए air-gapped डिप्लॉयमेंट द्वारा लिखे गए tarball bundle को ingest करें।

## परिचय

यह [विज़न इवेंट बंडल लिखें](https://docs.roboflow.com/workflows/blocks/blocks/data-storage/vision-event-bundle) ब्लॉक प्रत्येक इवेंट के लिए एक टारबॉल Roboflow को भेजने के बजाय लोकल डिस्क पर लिखता है। इसका उपयोग तब करें जब आपका इंफरेंस सर्वर ऐसे नेटवर्क में चलता हो जिसका क्लाउड से कोई कनेक्शन न हो। यह एंडपॉइंट उन टारबॉल को ज्यों का त्यों स्वीकार करता है: आपका अपलोडर प्रत्येक फ़ाइल पोस्ट करता है और Roboflow उसे अनपैक करके इमेज अपलोड करता है और बनाता है: [विज़न इवेंट](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events.md).

## HTTP API

रॉ आर्काइव बाइट्स को अनुरोध की बॉडी के रूप में पोस्ट करें। JSON या multipart का उपयोग न करें। बॉडी बाइनरी है, इसलिए अपनी API कुंजी `Authorization: Bearer` हेडर या `api_key` क्वेरी पैरामीटर में भेजें।

**आवश्यक स्कोप:** `vision-events:write` या `device:update`

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

### बंडल का प्रारूप

हर बंडल में एक इवेंट होता है। ब्लॉक gzip से संपीड़ित tar फ़ाइलें लिखता है, लेकिन साधारण tar भी काम करता है।

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

`payload.json` का प्रारूप [विज़न इवेंट बनाएँ](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/create-a-vision-event.md#http-api) अनुरोध बॉडी के समान है, लेकिन इसमें दो अंतर हैं:

* `bundleFormatVersion` है `1`.
* `images[].file` और `images[].inputFile` में आर्काइव सदस्यों के पथ (जैसे: `images/9f0c1b2a.jpg`) होते हैं, न कि `sourceId` और `inputSourceId`। Roboflow प्रत्येक सदस्य को अपलोड करता है और स्रोत ID को इवेंट में संग्रहीत करता है।

इमेज `images/` डायरेक्टरी में होनी चाहिए। जिन सदस्यों का संदर्भ किसी इमेज में नहीं है, और `images/`के अलावा अन्य शीर्ष-स्तरीय डायरेक्टरी, इंगेशन चेतावनी उत्पन्न करती हैं, लेकिन इवेंट को रोकती नहीं हैं। बंडल में केवल इमेज होती हैं: `videos/` डायरेक्टरी को एक चेतावनी के साथ अनदेखा कर दिया जाता है। क्लिप संलग्न करने के लिए, [वीडियो अपलोड करें](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/upload-a-vision-event-video.md) अलग से।

इसके भीतर की फ़ील्ड त्रुटियाँ `payload.json` उसी तरह काम करती हैं जैसे JSON एंडपॉइंट पर करती हैं। देखें [सत्यापन और चेतावनियाँ](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/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>

### पुनः प्रयास

अपलोड विफल होने या उसकी स्थिति स्पष्ट न होने पर आप वही बंडल दोबारा पोस्ट कर सकते हैं। इमेज का मिलान उनकी सामग्री के आधार पर किया जाता है, और दो बार आने वाला इवेंट पहले वाले की जगह ले लेता है। इसके लिए आपसे केवल एक बार शुल्क लिया जाता है।
