Kilitler
Bu API, anahtar-değer kaynağı için kilit ve kilit açma semantiği sağlar. Aşağıdaki işlemleri destekler:
- Yer kilidi
- Kilidi kaldır
Varsa, label
açık bir etiket değeri olmalıdır (joker karakter olmamalıdır). Tüm işlemler için isteğe bağlı bir parametredir. Atlanırsa, etiket olmadığını gösterir.
Önkoşullar
- Tüm HTTP isteklerinin kimliği doğrulanmalıdır. Kimlik doğrulama bölümüne bakın.
- Tüm HTTP istekleri açık
api-version
sağlamalıdır. Sürüm oluşturma bölümüne bakın.
Anahtar-değeri kilitle
- Gerekli:
{key}
,{api-version}
- Opsiyonel:
label
PUT /locks/{key}?label={label}&api-version={api-version} HTTP/1.1
Yanıt:
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": []
}
Anahtar-değer yoksa aşağıdaki yanıt döndürülür:
HTTP/1.1 404 Not Found
Anahtar değerinin kilidini açma
- Gerekli:
{key}
,{api-version}
- Opsiyonel:
label
DELETE /locks/{key}?label={label}?api-version={api-version} HTTP/1.1
Yanıt:
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": []
}
Anahtar-değer yoksa aşağıdaki yanıt döndürülür:
HTTP/1.1 404 Not Found
Koşullu kilitleme ve kilidini açma
Yarış koşullarını önlemek için üst bilgileri kullanın If-Match
veya If-None-Match
isteyin. etag
bağımsız değişkeni, anahtar gösteriminin bir parçasıdır. If-None-Match
Veya If-Match
atlanırsa, işlem koşulsuz olur.
Aşağıdaki istek yalnızca geçerli anahtar-değer gösterimi belirtilen etag
ile eşleşiyorsa işlemi uygular:
PUT|DELETE /locks/{key}?label={label}&api-version={api-version} HTTP/1.1
If-Match: "4f6dd610dd5e4deebc7fbaef685fb903"
Aşağıdaki istek yalnızca geçerli anahtar-değer gösterimi mevcutsa işlemi uygular, ancak belirtilen etag
ile eşleşmez:
PUT|DELETE /kv/{key}?label={label}&api-version={api-version} HTTP/1.1
If-None-Match: "4f6dd610dd5e4deebc7fbaef685fb903"