रिपॉज़िटरी
वे रिपॉज़िटरी जिन्हें कॉल करने वाला देख सकता है, और किसी एक रिपॉज़िटरी का विवरण।
इस समूह के ऑपरेशन, उनके एक्सेस नियम, पुनः प्रयास नियम, पैरामीटर और जवाबों के साथ। हर अनुरोध में एक कुंजी होती है: Authorization: Bearer <कुंजी> (“प्रमाणीकरण” देखें)।
ऑपरेशन
वे रिपॉज़िटरी सूचीबद्ध करें जिन तक आपकी पहुँच है
GET HEAD /api/v1/repositories
एक्सेस: वे रिपॉज़िटरी जिन्हें कॉल करने वाला देख सकता है (repository.read) · पुनः प्रयास: दोहराना सुरक्षित है (पढ़ना)
नाम के क्रम में वे रिपॉज़िटरी सूचीबद्ध करता है जिनमें कॉलर के पास कोई अनुमति है; प्रत्येक के साथ उसके फ़ॉर्मैट (upack, assets) और वहाँ कॉलर की अपनी अनुमतियाँ हैं; प्रबंधित सेवा कुंजी केवल वही रिपॉज़िटरी देखती है जिनमें उसके पास repository.read है। रिपॉज़िटरी कॉलर के अनुदानों (grants) का दायरा है, पूरे सर्वर की किसी रजिस्ट्री की प्रविष्टि नहीं। प्रत्येक पृष्ठ में limit कार्ड होते हैं (1–100, डिफ़ॉल्ट 50); after में next देकर आगे बढ़ें।
पैरामीटर
| नाम | स्थान | प्रकार | आवश्यक | नियम |
|---|---|---|---|---|
after | क्वेरी | string | नहीं | पैटर्न: ^[a-z0-9][a-z0-9_-]{0,63}$; Exclusive repository ID boundary; authorization is rechecked on every page. |
limit | क्वेरी | integer | नहीं | 1–100; डिफ़ॉल्ट 50 |
प्रतिक्रिया 200
| फ़ील्ड | प्रकार | आवश्यक | नियम |
|---|---|---|---|
items | object का ऐरे | हाँ | अधिकतम 100 आइटम |
items[].id | string | हाँ | पैटर्न: ^[a-z0-9][a-z0-9_-]{0,63}$ |
items[].formats | string का ऐरे | हाँ | 2–2 आइटम; कोई आइटम दोहराया न जाए; हर आइटम: इनमें से एक: upack, assets |
items[].permissions | string का ऐरे | हाँ | 1–24 आइटम; कोई आइटम दोहराया न जाए; हर आइटम: इनमें से एक: repository.read, storage.read, storage.manage, diagnostics.read, artifact.read, artifact.list, artifact.delete, artifact.promote, content.read, upload.create, upload.read, upload.write, upload.complete, upload.cancel, job.read, package.read, package.publish, asset.read, asset.write, asset.restore, annotation.read, annotation.write, reference.write, audit.read |
next | string | हाँ | पैटर्न: ^[a-z0-9][a-z0-9_-]{0,63}$; null हो सकता है |
प्रतिक्रियाएँ: 200, 400, 401, 403, 404, 409, 422, 503, 507
उदाहरण
curl -X GET "$ARKVORY_URL/api/v1/repositories" \
-H "Authorization: Bearer $ARKVORY_TOKEN"रिपॉज़िटरी कार्ड प्राप्त करें
GET HEAD /api/v1/repositories/{repository}
एक्सेस: वे रिपॉज़िटरी जिन्हें कॉल करने वाला देख सकता है (repository.read) · पुनः प्रयास: दोहराना सुरक्षित है (पढ़ना)
कॉलर के लिए एक रिपॉज़िटरी का कार्ड लौटाता है: उसके फ़ॉर्मैट और उसमें कॉलर की अनुमतियाँ। जो रिपॉज़िटरी कॉलर नहीं देख सकता, उस पर 404 मिलता है, ठीक वैसे ही जैसे अस्तित्वहीन रिपॉज़िटरी पर; HEAD इसे पहुँच की सस्ती जाँच बना देता है। किसी रिपॉज़िटरी का दिखना उसकी सामग्री या सेटिंग तक पहुँच नहीं देता।
पैरामीटर
| नाम | स्थान | प्रकार | आवश्यक | नियम |
|---|---|---|---|---|
repository | पथ | string | हाँ | पैटर्न: ^[a-z0-9][a-z0-9_-]{0,63}$ |
प्रतिक्रिया 200
| फ़ील्ड | प्रकार | आवश्यक | नियम |
|---|---|---|---|
id | string | हाँ | पैटर्न: ^[a-z0-9][a-z0-9_-]{0,63}$ |
formats | string का ऐरे | हाँ | 2–2 आइटम; कोई आइटम दोहराया न जाए; हर आइटम: इनमें से एक: upack, assets |
permissions | string का ऐरे | हाँ | 1–24 आइटम; कोई आइटम दोहराया न जाए; हर आइटम: इनमें से एक: repository.read, storage.read, storage.manage, diagnostics.read, artifact.read, artifact.list, artifact.delete, artifact.promote, content.read, upload.create, upload.read, upload.write, upload.complete, upload.cancel, job.read, package.read, package.publish, asset.read, asset.write, asset.restore, annotation.read, annotation.write, reference.write, audit.read |
प्रतिक्रियाएँ: 200, 400, 401, 403, 404, 409, 422, 503, 507
उदाहरण
curl -X GET "$ARKVORY_URL/api/v1/repositories/$REPOSITORY" \
-H "Authorization: Bearer $ARKVORY_TOKEN"