الرؤوس
توفر هذه المقالة ارتباطات إلى صفحات مرجعية للرؤوس المستخدمة مع واجهة برمجة تطبيقات REST لتكوين تطبيقات Azure.
رؤوس الطلبات
يصف الجدول التالي رؤوس الطلبات الشائعة المستخدمة في تكوين تطبيق Azure.
| الرأس | الوصف | مثال |
|---|---|---|
| التخويل | تستخدم لمصادقة طلب للخدمة. انظر القسم 14-8 | Authorization: HMAC-SHA256 Credential=<Credential>&SignedHeaders=Host;x-ms-date;x-ms-content-sha256&Signature=<Signature> |
| قبول | يعلم الخادم بنوع الوسائط الذي سيقبله العميل في استجابة HTTP. انظر القسم 14-1 | Accept: application/vnd.microsoft.appconfig.kv+json; |
| قبول-تاريخ-الوقت | يطلب من الخادم إرجاع محتواه كتمثيل لحالته السابقة. قيمة هذا الرأس هي التاريخ المطلوب لتلك الحالة. انظر المعيار RFC 7089 | Accept-Datetime: Sat, 12 May 2018 02:10:00 GMT |
| نوع المحتوى | يحتوي على نوع الوسائط للمحتوى داخل نص طلب HTTP. انظر الفرع 14-17 | Content-Type: application/vnd.microsoft.appconfig.kv+json; charset=utf-8; |
| التاريخ | التاريخ الذي تم فيه إصدار طلب HTTP. يتم استخدام هذا الرأس في مصادقة HMAC. انظر الفرع 14-18 | Date: Fri, 11 May 2018 18:48:36 GMT |
| المضيف | يحدد المستأجر الذي تم إصدار الطلب له. يتم استخدام هذا الرأس في مصادقة HMAC. انظر الفرع 14-23 | Host: contoso.azconfig.io |
| إذا كان المباراة | يستخدم لجعل طلب HTTP مشروطا. يجب أن ينجح هذا الطلب فقط إذا كان ETag الخاص بالمورد المستهدف يتطابق مع قيمة هذا العنوان. تتطابق القيمة "*" مع أي ETag. انظر الفرع 14-24 | If-Match: "4f6dd610dd5e4deebc7fbaef685fb903" |
| إذا لم يكن هناك تطابق | يستخدم لجعل طلب HTTP مشروطا. يجب أن ينجح هذا الطلب فقط إذا كان ETag الخاص بالمورد المستهدف لا يتطابق مع قيمة هذا الرأس. تتطابق القيمة "*" مع أي ETag. انظر الفرع 14-26 | If-None-Match: "4f6dd610dd5e4deebc7fbaef685fb903" |
| رمز المزامنة | يستخدم لتمكين الاتساق في الوقت الفعلي أثناء سلسلة من الطلبات. | Sync-Token: jtqGc1I4=MDoyOA==;sn=28 |
| x-ms-client-request-id | معرف فريد يقدمه العميل يستخدم لتتبع رحلة الطلب ذهابا وإيابا. | x-ms-client-request-id: 00000000-0000-0000-0000-000000000000 |
| x-ms-content-sha256 | ملخص sha256 لنص طلب HTTP. يتم استخدام هذا الرأس في مصادقة HMAC. | x-ms-content-sha256: 47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU= |
| x-ms-date | قد يتم تعيين هذا الرأس واستخدامه بدلا من Date الرأس إذا تعذر الوصول إلى رأس التاريخ. يتم استخدام هذا الرأس في مصادقة HMAC. |
x-ms-date: Fri, 11 May 2018 18:48:36 GMT |
| x-ms-return-client-request-id | يستخدم بالاقتران مع x-ms-client-request-id الرأس. إذا كانت قيمة هذا الرأس صحيحة ، توجيه الخادم لإرجاع قيمة x-ms-client-request-id رأس الطلب. |
x-ms-return-client-request-id: true |
عناوين الاستجابة
قد يتضمن الخادم رؤوس HTTP التالية في ردوده.
| الرأس | الوصف | مثال |
|---|---|---|
| نوع المحتوى | يحتوي على نوع الوسائط للمحتوى داخل نص استجابة HTTP. انظر الفرع 14-17 | Content-Type: application/vnd.microsoft.appconfig.kv+json; charset=utf-8; |
| همجموعة | رمز مميز غير شفاف يمثل حالة مورد معين. يمكن استخدامها في العمليات الشرطية. انظر الفرع 14-19 | ETag: "4f6dd610dd5e4deebc7fbaef685fb903" |
| تاريخ التعديل الأخير | توضح هذه المقالة تاريخ آخر تعديل للمورد المطلوب. تم تنسيقه كتاريخ HTTP. انظر الفرع 14-29 | Last-Modified: Tue, 05 Dec 2017 02:41:26 GMT |
| الرابط | يوفر روابط إلى الموارد المرتبطة بالاستجابة. يتم استخدام هذا الرأس لترحيل الصفحات باستخدام الارتباط التالي . انظر المعيار RFC 5988 | Link: </kv?after={token}>; rel="next" |
| تذكار-التاريخي- | يشير إلى أن المحتوى الوارد في الاستجابة يمثل حالة سابقة. قيمة هذا الرأس هي تاريخ وقت تلك الحالة. انظر المعيار RFC 7089 | Memento-Datetime: Sat, 12 May 2018 02:10:00 GMT |
| إعادة المحاولة-بعد-مللي ثانية | يوفر فترة مقترحة (بالمللي ثانية) للعميل للانتظار قبل إعادة محاولة طلب فاشل. | retry-after-ms: 10 |
| x-ms-request-id | معرف فريد تم إنشاؤه بواسطة الخادم المستخدم لتتبع الطلب داخل الخدمة. | x-ms-request-id: 00000000-0000-0000-0000-000000000000 |
| WWW-المصادقة | يستخدم لتحدي العملاء للمصادقة وتقديم سبب لفشل محاولة المصادقة. انظر الفرع 14-47 | WWW-Authenticate: HMAC-SHA256 error="invalid_token" error_description="Invalid Signature" |