Aracılığıyla paylaş

Kilitler

  • Makale

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-versionsağ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 etagile 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 etagile eşleşmez:

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