أقفال

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

توفر واجهة برمجة التطبيقات هذه (الإصدار 1.0) دلالات القفل وإلغاء القفل لمورد القيمة الرئيسية. وهو يدعم العمليات التالية:

  • قفل المكان
  • إزالة القفل

إذا كانت موجودة، label يجب أن تكون قيمة تسمية صريحة (وليس حرف بدل). بالنسبة لجميع العمليات ، إنها معلمة اختيارية. إذا تم حذفه ، فإنه لا يعني أي تسمية.

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

تأمين قيمة المفتاح

  • المطلوب: {key}, {api-version}
  • اختياري: label
PUT /locks/{key}?label={label}&api-version={api-version} HTTP/1.1

الاستجابات:

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

{
  "etag": "4f6dd610dd5e4deebc7fbaef685fb903",
  "key": "{key}",
  "label": "{label}",
  "content_type": null,
  "value": "example value",
  "created": "2017-12-05T02:41:26.4874615+00:00",
  "locked": true,
  "tags": []
}

في حالة عدم وجود قيمة المفتاح، يتم إرجاع الاستجابة التالية:

HTTP/1.1 404 Not Found

فتح القيمة الرئيسية

  • المطلوب: {key}, {api-version}
  • اختياري: label
DELETE /locks/{key}?label={label}?api-version={api-version} HTTP/1.1

الاستجابات:

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

{
  "etag": "4f6dd610dd5e4deebc7fbaef685fb903",
  "key": "{key}",
  "label": "{label}",
  "content_type": null,
  "value": "example value",
  "created": "2017-12-05T02:41:26.4874615+00:00",
  "locked": true,
  "tags": []
}

في حالة عدم وجود قيمة المفتاح، يتم إرجاع الاستجابة التالية:

HTTP/1.1 404 Not Found

القفل الشرطي وإلغاء القفل

لمنع ظروف السباق، استخدم If-Match رؤوس الرؤوس أو If-None-Match طلبها. etag الحجة هي جزء من التمثيل الرئيسي. إذا If-Match تم حذفها أو If-None-Match حذفها ، فإن العملية غير مشروطة.

يطبق الطلب التالي العملية فقط إذا كان تمثيل قيمة المفتاح الحالي يتطابق مع المحدد etag:

PUT|DELETE /locks/{key}?label={label}&api-version={api-version} HTTP/1.1
If-Match: "4f6dd610dd5e4deebc7fbaef685fb903"

يطبق الطلب التالي العملية فقط في حالة وجود تمثيل قيمة المفتاح الحالي، ولكنه لا يتطابق مع التمثيل المحدد etag:

PUT|DELETE /kv/{key}?label={label}&api-version={api-version} HTTP/1.1
If-None-Match: "4f6dd610dd5e4deebc7fbaef685fb903"