نسخ مشاريع الرؤية المخصصة ونسخها احتياطيا
بعد إنشاء مشروع "رؤية مخصصة" وتدريبه، قد تحتاج إلى نسخ مشروعك إلى مورد آخر. إذا كان تطبيقك أو نشاطك التجاري يعتمد على استخدام مشروع "رؤية مخصصة"، نوصيك بنسخ نموذجك إلى حساب "رؤية مخصصة" آخر في منطقة أخرى. ثم في حالة حدوث انقطاع إقليمي ، يمكنك الوصول إلى مشروعك في المنطقة التي تم نسخه فيها.
كجزء من Azure، تحتوي خدمة الرؤية المخصصة على مكونات يتم الاحتفاظ بها عبر مناطق متعددة. يتم استخدام مناطق الخدمة والمناطق من قبل جميع خدماتنا لتوفير خدمة مستمرة لعملائنا. لمزيد من المعلومات حول المناطق والمناطق، راجع مناطق Azure. إذا كنت بحاجة إلى معلومات إضافية أو لديك أي مشاكل، يرجى الاتصال بالدعم.
تعمل واجهات برمجة تطبيقات ExportProject وImportProject على تمكين هذا السيناريو من خلال السماح لك بنسخ المشاريع من حساب Custom Vision إلى حسابات أخرى. يوضح لك هذا الدليل كيفية استخدام واجهات برمجة تطبيقات REST هذه مع cURL. يمكنك أيضا استخدام خدمة طلب HTTP مثل ساعي البريد لإصدار الطلبات.
تلميح
للحصول على مثال على هذا السيناريو باستخدام مكتبة عميل Python، راجع مستودع نقل Project الرؤية المخصصة على GitHub.
المتطلبات الأساسية
- اثنين من موارد Azure Custom Vision. إذا لم يكن لديك هذه العناصر، فانتقل إلى مدخل Azure وقم بإنشاء مورد جديد للرؤية المخصصة.
- مفاتيح التدريب وعناوين URL لنقاط النهاية لموارد الرؤية المخصصة. يمكنك العثور على هذه القيم في علامة التبويب نظرة عامة على المورد على مدخل Azure.
- مشروع رؤية مخصصة تم إنشاؤه. راجع إنشاء مصنف للحصول على إرشادات حول كيفية القيام بذلك.
- PowerShell الإصدار 6.0+ أو أداة مساعدة مشابهة لسطر الأوامر.
نظرة عامة على العملية
تتكون عملية نسخ المشروع من الخطوات التالية:
- أولا ، يمكنك الحصول على معرف المشروع في حساب المصدر الذي تريد نسخه.
- ثم يمكنك استدعاء واجهة برمجة تطبيقات ExportProject باستخدام معرف المشروع ومفتاح التدريب لحساب المصدر الخاص بك. ستحصل على سلسلة رمزية مؤقتة.
- ثم تقوم باستدعاء واجهة برمجة تطبيقات ImportProject باستخدام سلسلة الرمز المميز ومفتاح التدريب لحسابك المستهدف. سيتم بعد ذلك إدراج المشروع ضمن حسابك المستهدف.
الحصول على معرف المشروع
اتصل أولا ب GetProjects للاطلاع على قائمة بمشاريع الرؤية المخصصة الحالية ومعرفاتها. استخدم مفتاح التدريب ونقطة النهاية لحساب المصدر الخاص بك.
curl -v -X GET "{endpoint}/customvision/v3.3/Training/projects"
-H "Training-key: {training key}"
ستحصل على 200\OK رد مع قائمة بالمشاريع وبياناتها الوصفية في النص. "id" القيمة هي السلسلة المراد نسخها للخطوات التالية.
[
{
"id": "00000000-0000-0000-0000-000000000000",
"name": "string",
"description": "string",
"settings": {
"domainId": "00000000-0000-0000-0000-000000000000",
"classificationType": "Multiclass",
"targetExportPlatforms": [
"CoreML"
],
"useNegativeSet": true,
"detectionParameters": "string",
"imageProcessingSettings": {
"augmentationMethods": {}
}
},
"created": "string",
"lastModified": "string",
"thumbnailUri": "string",
"drModeEnabled": true,
"status": "Succeeded"
}
]
تصدير المشروع
اتصل ب ExportProject باستخدام معرف المشروع ومفتاح تدريب المصدر ونقطة النهاية.
curl -v -X GET "{endpoint}/customvision/v3.3/Training/projects/{projectId}/export"
-H "Training-key: {training key}"
ستحصل على 200/OK استجابة مع بيانات وصفية حول المشروع المصدر وسلسلة "token"مرجعية . انسخ قيمة الرمز المميز.
{
"iterationCount": 0,
"imageCount": 0,
"tagCount": 0,
"regionCount": 0,
"estimatedImportTimeInMS": 0,
"token": "string"
}
تلميح
إذا تلقيت خطأ "رمز مميز غير صالح" عند استيراد مشروعك ، فقد يكون ذلك هو أن سلسلة عنوان URL المميز غير مشفرة على الويب. يمكنك ترميز الرمز المميز باستخدام برنامج ترميز عنوان URL.
استيراد المشروع
اتصل ب ImportProject باستخدام مفتاح التدريب المستهدف ونقطة النهاية، إلى جانب الرمز المميز المرجعي. يمكنك أيضا إعطاء مشروعك اسما في حسابه الجديد.
curl -v -G -X POST "{endpoint}/customvision/v3.3/Training/projects/import"
--data-urlencode "token={token}" --data-urlencode "name={name}"
-H "Training-key: {training key}" -H "Content-Length: 0"
ستحصل على رد ببيانات 200/OK وصفية حول مشروعك الذي تم استيراده حديثا.
{
"id": "00000000-0000-0000-0000-000000000000",
"name": "string",
"description": "string",
"settings": {
"domainId": "00000000-0000-0000-0000-000000000000",
"classificationType": "Multiclass",
"targetExportPlatforms": [
"CoreML"
],
"useNegativeSet": true,
"detectionParameters": "string",
"imageProcessingSettings": {
"augmentationMethods": {}
}
},
"created": "string",
"lastModified": "string",
"thumbnailUri": "string",
"drModeEnabled": true,
"status": "Succeeded"
}
الخطوات التالية
في هذا الدليل، تعلمت كيفية نسخ مشروع ونقله بين موارد الرؤية المخصصة. بعد ذلك، استكشف المستندات المرجعية لواجهة برمجة التطبيقات لمعرفة ما يمكنك فعله باستخدام الرؤية المخصصة.