Jobs - ImportJobs List

Service:

Azure Digital Twins

API Version:

2023-10-31

استرداد جميع مهام الاستيراد. رموز الحالة:

• 200 موافق

GET https://digitaltwins-hostname/jobs/imports?api-version=2023-10-31

معلمات URI

الاسم	في	مطلوب	النوع	الوصف
api-version	query	True	string	إصدار واجهة برمجة التطبيقات المطلوب.

رأس الطلب

الاسم	مطلوب	النوع	الوصف
max-items-per-page		integer	الحد الأقصى لعدد العناصر المراد استردادها لكل طلب. قد يختار الخادم إرجاع أقل من الرقم المطلوب.
traceparent		string	يحدد الطلب في نظام تتبع موزع.
tracestate		string	يوفر معلومات تعريف التتبع الخاصة بالمورد وهو مصاحب ل traceparent.

الاستجابات

الاسم	النوع	الوصف
200 OK	ImportJobCollection	نجاح
Other Status Codes	ErrorResponse	الاستجابة الافتراضية. Headers x-ms-error-code: string

الأمان

oauth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize?resource=0b07f429-9f4b-4714-9392-cc5e8e80c8b0

أمثلة

Get all import jobs

Sample Request

HTTP

GET https://digitaltwins-hostname/jobs/imports?api-version=2023-10-31

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "importjob1",
      "inputBlobUri": "path to input blob",
      "outputBlobUri": "path to output blob",
      "createdDateTime": "2022-01-01T00:00:00.0000000+00:00",
      "lastActionDateTime": "2022-01-01T00:01:00.0000000+00:00",
      "finishedDateTime": "2022-01-01T00:01:00.0000000+00:00",
      "purgeDateTime": "2022-01-31T00:01:00.0000000+00:00",
      "status": "succeeded"
    },
    {
      "id": "importjob2",
      "inputBlobUri": "path to input blob",
      "outputBlobUri": "path to output blob",
      "createdDateTime": "2022-01-01T00:00:00.0000000+00:00",
      "lastActionDateTime": "2022-01-01T00:01:00.0000000+00:00",
      "finishedDateTime": "2022-01-01T00:01:00.0000000+00:00",
      "purgeDateTime": "2022-01-31T00:01:00.0000000+00:00",
      "status": "succeeded"
    }
  ],
  "nextLink": "url-to-next-page"
}

التعريفات

الاسم	الوصف
Error	تعريف الخطأ.
ErrorResponse	استجابة الخطأ.
ImportJob	مهمة تحتوي على مرجع إلى العمليات التي يجب تنفيذها والنتائج وبيانات تعريف التنفيذ.
ImportJobCollection	مجموعة من عناصر مهمة الاستيراد.
InnerError	وصف خطأ أكثر تحديدا مما تم توفيره بواسطة الخطأ المحتوي.
status	حالة الوظيفة.

Error

تعريف الخطأ.

الاسم	النوع	الوصف
code	string	رمز الخطأ الخاص بالخدمة الذي يعمل بمثابة الإحصائيات الفرعية لرمز خطأ HTTP.
details	Error[]	تفاصيل الخطأ الداخلي.
innererror	InnerError	كائن يحتوي على معلومات أكثر تحديدا من الكائن الحالي حول الخطأ.
message	string	تمثيل يمكن للبشر قراءته للخطأ.

ErrorResponse

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

الاسم	النوع	الوصف
error	Error	تفاصيل الخطأ.

ImportJob

مهمة تحتوي على مرجع إلى العمليات التي يجب تنفيذها والنتائج وبيانات تعريف التنفيذ.

الاسم	النوع	الوصف
createdDateTime	string	وقت بدء المهمة. الطابع الزمني بتنسيق RFC3339: yyyy-MM-ddTHH:mm:ssZ.
error	Error	تفاصيل الخطأ (الأخطاء) التي حدثت أثناء تنفيذ مهمة الاستيراد.
finishedDateTime	string	وقت انتهاء المهمة. الطابع الزمني بتنسيق RFC3339: yyyy-MM-ddTHH:mm:ssZ.
id	string	معرف مهمة الاستيراد.
inputBlobUri	string	المسار إلى إدخال كائن تخزين Azure الثنائي كبير الحجم الذي يحتوي على ملف (ملفات) يصف العمليات التي يجب تنفيذها في المهمة.
lastActionDateTime	string	نفذت خدمة آخر مرة أي إجراء من الوظيفة. الطابع الزمني بتنسيق RFC3339: yyyy-MM-ddTHH:mm:ssZ.
outputBlobUri	string	المسار إلى إخراج كائن ثنائي كبير الحجم لتخزين Azure الذي سيحتوي على الأخطاء وسجلات التقدم لمهمة الاستيراد.
purgeDateTime	string	الوقت الذي سيتم فيه إزالة الوظيفة من قبل الخدمة من النظام. الطابع الزمني بتنسيق RFC3339: yyyy-MM-ddTHH:mm:ssZ.
status	status	حالة الوظيفة.

ImportJobCollection

مجموعة من عناصر مهمة الاستيراد.

الاسم	النوع	الوصف
nextLink	string	URI لاسترداد الصفحة التالية من النتائج.
value	ImportJob[]	قائمة عناصر مهمة الاستيراد.

InnerError

وصف خطأ أكثر تحديدا مما تم توفيره بواسطة الخطأ المحتوي.

الاسم	النوع	الوصف
code	string	رمز خطأ أكثر تحديدا مما تم توفيره بواسطة الخطأ المحتوي.
innererror	InnerError	كائن يحتوي على معلومات أكثر تحديدا من الكائن الحالي حول الخطأ.

status

حالة الوظيفة.

الاسم	النوع	الوصف
cancelled	string
cancelling	string
failed	string
notstarted	string
running	string
succeeded	string