الأقفال

توفر واجهة برمجة التطبيقات هذه قفلا ودلالات إلغاء تأمين لمورد قيمة المفتاح. يدعم العمليات التالية:

• وضع التأمين
• إزالة التأمين

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

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

• لابد من مصادقة جميع طلبات HTTP. راجع القسم authentication.
• يجب أن توفر جميع طلبات HTTP api-version صراحةً. راجع قسم الإصدار.

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

• مطلوب: {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 هي جزء من تمثيل key. إذا تم حذف 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"