बिल्ड अटैचमेंट

किसी आर्टिफ़ैक्ट से जुड़े लॉग, रिपोर्ट और दूसरी फ़ाइलें, उनके इतिहास के साथ।

इस समूह के ऑपरेशन, उनके एक्सेस नियम, पुनः प्रयास नियम, पैरामीटर और जवाबों के साथ। हर अनुरोध में एक कुंजी होती है: Authorization: Bearer <कुंजी> (“प्रमाणीकरण” देखें)।

ऑपरेशन

बिल्ड के अटैचमेंट प्राप्त करें

GET HEAD /api/v1/repositories/{repository}/artifacts/{id}/attachments

एक्सेस: रिपॉज़िटरी अनुमति: annotation.read; फ़ाइल कुंजियाँ: read · पुनः प्रयास: दोहराना सुरक्षित है (पढ़ना)

आर्टिफ़ैक्ट का वर्तमान अटैचमेंट संशोधन लौटाता है: अधिकतम 32 प्रविष्टियाँ, प्रत्येक रिपॉज़िटरी के किसी अन्य प्रकाशित आर्टिफ़ैक्ट को name, kind (manifest, sbom, signature, report, file) और description के साथ नामित करती है, साथ ही परिवर्तन का कर्ता और समय। बिना आइटम का संशोधन 0 बताता है कि कभी कुछ संलग्न नहीं किया गया। संलग्न फ़ाइल को उसकी artifactId से डाउनलोड करें।

पैरामीटर

नाम	स्थान	प्रकार	आवश्यक	नियम
repository	पथ	string	हाँ	पैटर्न: ^[a-z0-9][a-z0-9_-]{0,63}$
id	पथ	string (uuid)	हाँ	—

प्रतिक्रिया 200

फ़ील्ड	प्रकार	आवश्यक	नियम
revision	integer	हाँ	0–2147483647
items	object का ऐरे	हाँ	अधिकतम 32 आइटम
items[].name	string	हाँ	1–240 वर्ण
items[].kind	string	हाँ	इनमें से एक: manifest, sbom, signature, report, file
items[].artifactId	string (uuid)	हाँ	—
items[].description	string	हाँ	अधिकतम 512 वर्ण
actor	string	हाँ	null हो सकता है
createdAt	string (date-time)	हाँ	null हो सकता है

प्रतिक्रियाएँ: 200, 400, 401, 403, 404, 409, 422, 503, 507

उदाहरण

curl -X GET "$ARKVORY_URL/api/v1/repositories/$REPOSITORY/artifacts/$ID/attachments" \
  -H "Authorization: Bearer $ARKVORY_TOKEN"

बिल्ड के अटैचमेंट प्रतिस्थापित करें

PUT /api/v1/repositories/{repository}/artifacts/{id}/attachments

एक्सेस: रिपॉज़िटरी अनुमति: annotation.write, artifact.read; फ़ाइल कुंजियाँ: read, write · पुनः प्रयास: केवल अपेक्षित संशोधन के साथ दोहराएँ (compare-and-swap)

आर्टिफ़ैक्ट की पूरी अटैचमेंट सूची प्रतिस्थापित करता है (अधिकतम 32 प्रविष्टियाँ; खाली सूची सभी हटा देती है) और नया संशोधन लौटाता है। हर लक्ष्य उसी रिपॉज़िटरी में पहले से प्रकाशित कोई अन्य आर्टिफ़ैक्ट होना चाहिए (पहले उसे अपलोड करें), नाम बड़े-छोटे अक्षर की उपेक्षा करके अद्वितीय होते हैं और विवरण अधिकतम 512 वर्णों के होते हैं। expectedRevision वर्तमान संशोधन होना चाहिए (पहली सूची के लिए 0), अन्यथा 409 revision_mismatch; किसी भी संशोधन में नामित आर्टिफ़ैक्ट हटाए जाने से सुरक्षित रहते हैं।

पैरामीटर

नाम	स्थान	प्रकार	आवश्यक	नियम
repository	पथ	string	हाँ	पैटर्न: ^[a-z0-9][a-z0-9_-]{0,63}$
id	पथ	string (uuid)	हाँ	—

अनुरोध बॉडी (application/json)

फ़ील्ड	प्रकार	आवश्यक	नियम
expectedRevision	integer	हाँ	0–2147483646
items	object का ऐरे	हाँ	अधिकतम 32 आइटम
items[].name	string	हाँ	1–240 वर्ण
items[].kind	string	हाँ	इनमें से एक: manifest, sbom, signature, report, file
items[].artifactId	string (uuid)	हाँ	—
items[].description	string	हाँ	अधिकतम 512 वर्ण

प्रतिक्रिया 200

फ़ील्ड	प्रकार	आवश्यक	नियम
revision	integer	हाँ	0–2147483647
items	object का ऐरे	हाँ	अधिकतम 32 आइटम
items[].name	string	हाँ	1–240 वर्ण
items[].kind	string	हाँ	इनमें से एक: manifest, sbom, signature, report, file
items[].artifactId	string (uuid)	हाँ	—
items[].description	string	हाँ	अधिकतम 512 वर्ण
actor	string	हाँ	null हो सकता है
createdAt	string (date-time)	हाँ	null हो सकता है

प्रतिक्रियाएँ: 200, 400, 401, 403, 404, 405, 409, 413, 415, 422, 503, 507

उदाहरण

curl -X PUT "$ARKVORY_URL/api/v1/repositories/$REPOSITORY/artifacts/$ID/attachments" \
  -H "Authorization: Bearer $ARKVORY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"expectedRevision":0,"items":[]}'

बिल्ड का अटैचमेंट इतिहास सूचीबद्ध करें

GET HEAD /api/v1/repositories/{repository}/artifacts/{id}/attachments/history

एक्सेस: रिपॉज़िटरी अनुमति: annotation.read; फ़ाइल कुंजियाँ: read · पुनः प्रयास: दोहराना सुरक्षित है (पढ़ना)

आर्टिफ़ैक्ट के पिछले और वर्तमान अटैचमेंट संशोधन, सबसे नया पहले, प्रति पृष्ठ 20, प्रत्येक के साथ उसकी प्रविष्टियाँ, कर्ता और समय लौटाता है; before में next देकर आगे बढ़ें। हर संशोधन के संलग्न आर्टिफ़ैक्ट डाउनलोड योग्य रहते हैं, क्योंकि वे हटाए जाने से सुरक्षित हैं।

पैरामीटर

नाम	स्थान	प्रकार	आवश्यक	नियम
repository	पथ	string	हाँ	पैटर्न: ^[a-z0-9][a-z0-9_-]{0,63}$
id	पथ	string (uuid)	हाँ	—
before	क्वेरी	integer	नहीं	1–2147483647

प्रतिक्रिया 200

फ़ील्ड	प्रकार	आवश्यक	नियम
items	object का ऐरे	हाँ	अधिकतम 20 आइटम
items[].revision	integer	हाँ	0–2147483647
items[].items	object का ऐरे	हाँ	अधिकतम 32 आइटम
items[].items[].name	string	हाँ	1–240 वर्ण
items[].items[].kind	string	हाँ	इनमें से एक: manifest, sbom, signature, report, file
items[].items[].artifactId	string (uuid)	हाँ	—
items[].items[].description	string	हाँ	अधिकतम 512 वर्ण
items[].actor	string	हाँ	null हो सकता है
items[].createdAt	string (date-time)	हाँ	null हो सकता है
next	integer	हाँ	1–2147483647; null हो सकता है

प्रतिक्रियाएँ: 200, 400, 401, 403, 404, 409, 422, 503, 507

उदाहरण

curl -X GET "$ARKVORY_URL/api/v1/repositories/$REPOSITORY/artifacts/$ID/attachments/history" \
  -H "Authorization: Bearer $ARKVORY_TOKEN"