मिरर

मिरर की गई रिपॉज़िटरी की स्थिति और वह फ़ीड जिसका मिरर अनुसरण करता है।

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

ऑपरेशन

इस इंस्टॉलेशन के मिरर और इम्पोर्ट की सूची

GET HEAD /api/v1/mirrors

एक्सेस: वे रिपॉज़िटरी जिन्हें कॉल करने वाला देख सकता है (repository.read) · पुनः प्रयास: दोहराना सुरक्षित है (पढ़ना)

हर उस रिपॉज़िटरी के लिए जिसे यह सर्वर किसी दूसरे Arkvory से मिरर या इम्पोर्ट करता है और जिसे कॉलर पढ़ सकता है, एक रिपॉज़िटरी की मिरर स्थिति जैसी ही जानकारी लौटाता है: स्रोत, mode, phase, cursor और head, caughtUp, पिछली जाँच, सिंक और त्रुटि, और कॉपी किए गए आर्टिफ़ैक्ट व बाइट। जिन रिपॉज़िटरी को कॉलर नहीं पढ़ सकता, वे छोड़ दी जाती हैं; बिना मिरर वाला इंस्टॉलेशन खाली सूची लौटाता है।

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

फ़ील्ड	प्रकार	आवश्यक	नियम
items	object का ऐरे	हाँ	अधिकतम 64 आइटम
items[].repository	string	हाँ	—
items[].upstream	string (uri)	हाँ	—
items[].sourceRepository	string	हाँ	—
items[].mode	string	हाँ	इनमें से एक: mirror, import
items[].stages	string का ऐरे	हाँ	अधिकतम 16 आइटम
items[].phase	string	हाँ	इनमें से एक: pending, seeding, following
items[].seedStep	string	हाँ	इनमें से एक: artifacts, packages, assets; null हो सकता है
items[].cursor	string	हाँ	दशमलव अंकों में पूर्णांक, स्ट्रिंग के रूप में भेजा जाता है
items[].head	string	हाँ	दशमलव अंकों में पूर्णांक, स्ट्रिंग के रूप में भेजा जाता है; null हो सकता है
items[].caughtUp	boolean	हाँ	null हो सकता है
items[].checkedAt	string (date-time)	हाँ	null हो सकता है
items[].syncedAt	string (date-time)	हाँ	null हो सकता है
items[].errorCode	string	हाँ	null हो सकता है
items[].errorAt	string (date-time)	हाँ	null हो सकता है
items[].copiedArtifacts	integer	हाँ	कम से कम 0
items[].copiedBytes	string	हाँ	दशमलव अंकों में पूर्णांक, स्ट्रिंग के रूप में भेजा जाता है
items[].conflicts	object	हाँ	—
items[].conflicts.count	integer	हाँ	कम से कम 0
items[].conflicts.oldestAt	string (date-time)	हाँ	null हो सकता है
items[].conflicts.sample	object का ऐरे	हाँ	अधिकतम 10 आइटम

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

उदाहरण

curl -X GET "$ARKVORY_URL/api/v1/mirrors" \
  -H "Authorization: Bearer $ARKVORY_TOKEN"

मिरर की सिंक्रनाइज़ेशन स्थिति प्राप्त करें

GET HEAD /api/v1/repositories/{repository}/mirror

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

जिस रिपॉज़िटरी को यह सर्वर किसी अन्य Arkvory से मिरर करता है (ARKVORY_MIRRORS_FILE में कॉन्फ़िगर), उसके लिए स्रोत, mode (mirror, केवल-पढ़ने वाली प्रति, या import, जो सूचीबद्ध stages वाले संस्करण अपने हाथ में ले लेता है), phase (pending, seeding, following), लागू किया गया cursor और स्रोत का head, caughtUp, अंतिम जाँच, सिंक और त्रुटि, तथा कॉपी किए गए आर्टिफ़ैक्ट और बाइट लौटाता है। क्रम संख्याएँ स्रोत के जर्नल नंबर हैं, इसलिए उनका अंतर परिवर्तनों की गिनती नहीं है। साधारण रिपॉज़िटरी पर 404 मिलता है।

पैरामीटर

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

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

फ़ील्ड	प्रकार	आवश्यक	नियम
repository	string	हाँ	—
upstream	string (uri)	हाँ	—
sourceRepository	string	हाँ	—
mode	string	हाँ	इनमें से एक: mirror, import
stages	string का ऐरे	हाँ	अधिकतम 16 आइटम
phase	string	हाँ	इनमें से एक: pending, seeding, following
seedStep	string	हाँ	इनमें से एक: artifacts, packages, assets; null हो सकता है
cursor	string	हाँ	दशमलव अंकों में पूर्णांक, स्ट्रिंग के रूप में भेजा जाता है
head	string	हाँ	दशमलव अंकों में पूर्णांक, स्ट्रिंग के रूप में भेजा जाता है; null हो सकता है
caughtUp	boolean	हाँ	null हो सकता है
checkedAt	string (date-time)	हाँ	null हो सकता है
syncedAt	string (date-time)	हाँ	null हो सकता है
errorCode	string	हाँ	null हो सकता है
errorAt	string (date-time)	हाँ	null हो सकता है
copiedArtifacts	integer	हाँ	कम से कम 0
copiedBytes	string	हाँ	दशमलव अंकों में पूर्णांक, स्ट्रिंग के रूप में भेजा जाता है
conflicts	object	हाँ	—
conflicts.count	integer	हाँ	कम से कम 0
conflicts.oldestAt	string (date-time)	हाँ	null हो सकता है
conflicts.sample	object का ऐरे	हाँ	अधिकतम 10 आइटम
conflicts.sample[].artifactId	string (uuid)	हाँ	—
conflicts.sample[].action	string	हाँ	—
conflicts.sample[].detail	string	हाँ	null हो सकता है
conflicts.sample[].code	string	हाँ	—
conflicts.sample[].firstAt	string (date-time)	हाँ	—
conflicts.sample[].lastAt	string (date-time)	हाँ	—
conflicts.sample[].attempts	integer	हाँ	कम से कम 1

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

उदाहरण

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