مشاركة عبر

الحصول على حالة لمهمة ترجمة معينة

  • مقالة

ميزة المرجع
: Azure الذكاء الاصطناعي المترجم → إصدار واجهة برمجة تطبيقات ترجمة
المستندات: 2024-05-01
أسلوب HTTP: GET

  • get translation status استخدم الأسلوب لطلب حالة مهمة ترجمة معينة. تتضمن الاستجابة الحالة الإجمالية للوظيفة وحالة المستندات التي تتم ترجمتها كجزء من تلك الوظيفة.

URL للطلب

هام

تتطلب جميع طلبات واجهة برمجة التطبيقات إلى ميزة ترجمة المستندات نقطة نهاية مجال مخصصة موجودة في صفحة نظرة عامة على الموارد في مدخل Microsoft Azure.

curl -i -X GET "{document-translation-endpoint}/translator/document/batches/{id}?api-version={date}"

معلمات الطلب

معلمات الطلب التي تم تمريرها على سلسلة الاستعلام هي:

معلمة الاستعلام المطلوب ‏‏الوصف
id صواب معرف العملية.

تحديد موقع القيمة id

يمكنك العثور على المهمة id في قيمة عنوان URL لاستجابة Operation-Location أسلوب POSTstart-batch-translation. السلسلة الأبجدية الرقمية التي تتبع المعلمة /document/ هي مهمة idالعملية :

رأس الاستجابة عنوان URL للاستجابة
موقع-العملية {document-translation-endpoint}/translator/document/9dce0aa9-78dc-41ba-8cae-2e2f3c2ff8ec?api-version=2024-05-01

عناوين الطلبات

عناوين الطلبات هي:

الرؤوس ‏‏الوصف الحالة
Ocp-Apim-Subscription-Key مفتاح واجهة برمجة تطبيقات خدمة المترجم من مدخل Microsoft Azure. المطلوب
Ocp-Apim-Subscription-Region المنطقة التي تم فيها إنشاء المورد الخاص بك. • مطلوب عند استخدام مورد إقليمي (جغرافي) مثل غرب الولايات المتحدة.
رمز نقطي.
نوع المحتوى نوع محتوى الحمولة. القيمة المقبولة هي application/json أو charset = UTF-8. • مطلوب

رموز حالة الاستجابة

فيما يلي رموز حالة HTTP المحتملة التي يعرضها الطلب.

رمز الحالة ‏‏الوصف
200 جيد. طلب ناجح وإرجاع حالة عملية الترجمة المجمعة. HeadersRetry-After: integerETag: string
401 Unauthorized. تحقق من معلومات تسجيل الدخول الخاصة بك.
404 لم يتم العثور على المورد.
500 خطأ في الخادم الداخلي.
رموز الحالة الأخرى • طلبات كثيرة جدا
• الخادم غير متوفر مؤقتا

احصل على استجابة حالة الترجمة

نجح الحصول على استجابة حالة الترجمة

يتم إرجاع المعلومات التالية في استجابة ناجحة.

Name كتابة الوصف
id سلسلة معرف العملية.
createdDateTimeUtc سلسلة أنشأت العملية التاريخ والوقت.
lastActionDateTimeUtc سلسلة تاريخ تحديث حالة العملية.
الحالة السلسلة‬ قائمة الحالات المحتملة للمهمة أو المستند:
• مُلغى
•الغاء
•فشل
• لم يتم البدء
•تشغيل
•نجحت
• ValidationFailed
الملخص. StatusSummary ملخص يحتوي على التفاصيل المدرجة.
summary.total integer العدد الإجمالي.
summary.failed integer فشل العد.
summary.success integer عدد الناجحين.
summary.inProgress integer رقم قيد التقدم.
summary.notYetStarted integer لم يبدأ العد بعد.
الملخص integer عدد الملغاة.
summary.totalCharacterCharged integer إجمالي الأحرف التي تفرضها واجهة برمجة التطبيقات.

الاستجابة للخطأ

Name كتابة ‏‏الوصف
الكود سلسلة قوائم تعدادات تحتوي على رموز خطأ عالية المستوى. القيم الممكنة:
• InternalServerError
• InvalidArgument
• طلب غير صالح
• RequestRateTooHigh
• ResourceNotFound
• ServiceUnavailable
•غير المصرح به
رسالة سلسلة يحصل على رسالة خطأ عالية المستوى.
الهدف سلسلة الحصول على مصدر الخطأ. على سبيل المثال، سيكون documents مستندا غير صالح أو document id لمستند غير صالح.
innerError InnerTranslationError تنسيق خطأ داخلي جديد يتوافق مع إرشادات واجهة برمجة تطبيقات خدمات Azure الذكاء الاصطناعي. تحتوي رسالة الخطأ هذه على الخصائص المطلوبة ErrorCode والرسالة وهدف الخصائص الاختيارية والتفاصيل (زوج قيمة المفتاح) والخطأ الداخلي (يمكن تداخله).
innerError.code سلسلة يحصل على سلسلة خطأ في التعليمة البرمجية.
innerError.message سلسلة يحصل على رسالة خطأ عالية المستوى.
innerError.target سلسلة الحصول على مصدر الخطأ. على سبيل المثال، سيكون documents أو document id لمستند غير صالح.

الأمثلة

مثال على الاستجابة الناجحة

عنصر JSON التالي هو مثال على استجابة ناجحة.

{
  "id": "727bf148-f327-47a0-9481-abae6362f11e",
  "createdDateTimeUtc": "2020-03-26T00:00:00Z",
  "lastActionDateTimeUtc": "2020-03-26T01:00:00Z",
  "status": "Succeeded",
  "summary": {
    "total": 10,
    "failed": 1,
    "success": 9,
    "inProgress": 0,
    "notYetStarted": 0,
    "cancelled": 0,
    "totalCharacterCharged": 0
  }
}

مثال على استجابة الخطأ

عنصر JSON التالي هو مثال على الاستجابة للخطأ. مخطط رموز الخطأ الأخرى هو نفسه.

تعليمة برمجية الحالة: 401

{
  "error": {
    "code": "Unauthorized",
    "message": "User is not authorized",
    "target": "Document",
    "innerError": {
      "code": "Unauthorized",
      "message": "Operation is not authorized"
    }
  }
}

الخطوات التالية

اتبع خطواتنا السريعة لمعرفة المزيد بشأن استخدام ترجمة المستندات ومكتبة العميل.

البدء في استخدام Document Translation