مراجعات القيمة الرئيسية

  • مقالة
  • قراءة خلال 2 دقائق

تحدد مراجعة القيمة الرئيسية التمثيل التاريخي لمورد القيمة الرئيسية . تنتهي صلاحية المراجعات بعد 7 أيام لمتاجر الفئات المجانية، أو 30 يوما لمتاجر الفئة القياسية. تدعم المراجعات العملية List .

لجميع العمليات ، key هي معلمة اختيارية. إذا تم حذفه ، فإنه يعني أي مفتاح.

لجميع العمليات ، label هي معلمة اختيارية. إذا تم حذفها ، فإنها تنطوي على أي تسمية.

تنطبق هذه المقالة على الإصدار 1.0 من واجهة برمجة التطبيقات.

المتطلبات الأساسية

تنقيحات القائمة

GET /revisions?label=*&api-version={api-version} HTTP/1.1

الاستجابات:

HTTP/1.1 200 OK
Content-Type: application/vnd.microsoft.appconfig.kvset+json; charset=utf-8"
Accept-Ranges: items

{
    "items": [
        {
          "etag": "4f6dd610dd5e4deebc7fbaef685fb903",
          "key": "{key}",
          "label": "{label}",
          "content_type": null,
          "value": "example value",
          "last_modified": "2017-12-05T02:41:26.4874615+00:00",
          "tags": []
        },
        ...
    ],
    "@nextLink": "{relative uri}"
}

ترقيم الصفحات

يتم ترقيم النتيجة في صفحة إذا تجاوز عدد العناصر التي تم إرجاعها حد الاستجابة. اتبع رأس الاستجابة الاختياري Link واستخدمه rel="next" للتنقل. بدلا من ذلك، يوفر المحتوى رابطا تاليا في شكل @nextLink الخاصية.

GET /revisions?api-version={api-version} HTTP/1.1

استجابه:

HTTP/1.1 OK
Content-Type: application/vnd.microsoft.appconfig.kvs+json; charset=utf-8
Accept-Ranges: items
Link: <{relative uri}>; rel="next"

{
    "items": [
        ...
    ],
    "@nextLink": "{relative uri}"
}

قائمة مجموعة فرعية من المراجعات

Range استخدم رأس الطلب. تحتوي الاستجابة على عنوان ⁧Content-Range⁩. إذا لم يتمكن الخادم من تلبية النطاق المطلوب ، فإنه يستجيب باستخدام HTTP 416 (RangeNotSatisfiable).

GET /revisions?api-version={api-version} HTTP/1.1
Range: items=0-2

⁦⁩استجابة⁦⁩

HTTP/1.1 206 Partial Content
Content-Type: application/vnd.microsoft.appconfig.revs+json; charset=utf-8
Content-Range: items 0-2/80

التصفية

يتم دعم مزيج من key والتصفية label . استخدم معلمات سلسلة الاستعلام والاختيارية keylabel .

GET /revisions?key={key}&label={label}&api-version={api-version}

الفلاتر المدعومة

مرشح المفتاح التأثير
key تم حذفه أو key=* يطابق أي مفتاح
key=abc يطابق مفتاحا باسم abc
key=abc* يطابق أسماء المفاتيح التي تبدأ ب abc
key=*abc يطابق أسماء المفاتيح التي تنتهي ب abc
key=*abc* يطابق أسماء المفاتيح التي تحتوي على abc
key=abc,xyz يطابق أسماء المفاتيح abc أو xyz (يقتصر على 5 CSV)
فلتر الملصقات التأثير
label تم حذفه أو label= يطابق الدخول بدون تسمية
label=* يطابق أي تصنيف
label=prod يطابق الحث على التسمية
label=prod* يطابق التصنيفات التي تبدأ بالحث
label=*prod يطابق التصنيفات التي تنتهي بالحث
label=*prod* يطابق التصنيفات التي تحتوي على الهمز
label=prod,test يطابق المحفزات أو الاختبارات الخاصة بالتصنيفات (تقتصر على 5 CSV)

الأحرف المحجوزة

الأحرف المحجوزة هي:

*, \, ,

إذا كان الحرف المحجوز جزءا من القيمة ، فيجب الهروب منه باستخدام \{Reserved Character}. يمكن أيضا الهروب من الأحرف غير المحجوزة.

التحقق من صحة الفلتر

في حالة حدوث خطأ في التحقق من صحة عامل التصفية، تكون الاستجابة هي HTTP 400 مع تفاصيل الخطأ:

HTTP/1.1 400 Bad Request
Content-Type: application/problem+json; charset=utf-8

{
  "type": "https://azconfig.io/errors/invalid-argument",
  "title": "Invalid request parameter '{filter}'",
  "name": "{filter}",
  "detail": "{filter}(2): Invalid character",
  "status": 400
}

أمثلة

  • كل:

    GET /revisions

  • العناصر التي يبدأ فيها اسم المفتاح ب abc:

    GET /revisions?key=abc*&api-version={api-version}

  • العناصر التي يكون فيها اسم المفتاح إما abc أو xyz، وتحتوي التسميات على همز:

    GET /revisions?key=abc,xyz&label=*prod*&api-version={api-version}

طلب حقول محددة

استخدم معلمة سلسلة الاستعلام الاختيارية وقم بتوفير قائمة مفصولة بفواصل من الحقول $select المطلوبة. إذا تم حذف المعلمة، فستحتوي الاستجابة على المجموعة الافتراضية $select .

GET /revisions?$select=value,label,last_modified&api-version={api-version} HTTP/1.1

الوصول القائم على الوقت

الحصول على تمثيل للنتيجة كما كانت في وقت سابق. لمزيد من المعلومات، راجع إطار عمل HTTP Time-Based الوصول إلى دول الموارد -- تذكار، القسم 2.1.1.

GET /revisions?api-version={api-version} HTTP/1.1
Accept-Datetime: Sat, 12 May 2018 02:10:00 GMT

استجابه:

HTTP/1.1 200 OK
Content-Type: application/vnd.microsoft.appconfig.revs+json"
Memento-Datetime: Sat, 12 May 2018 02:10:00 GMT
Link: <{relative uri}>; rel="original"

{
    "items": [
        ....
    ]
}