Sdílet prostřednictvím

Zámky

  • Článek

Toto rozhraní API poskytuje sémantiku uzamčení a odemknutí prostředku klíč-hodnota. Podporuje následující operace:

  • Umístit zámek
  • Odebrat zámek

Pokud je k dispozici, label musí to být explicitní hodnota popisku (ne zástupný znak). Pro všechny operace je to volitelný parametr. Pokud tento popisek vynecháte, znamená to žádný popisek.

Požadavky

Uzamknout hodnotu klíče

  • Povinné: {key}, {api-version}
  • Volitelný: label
PUT /locks/{key}?label={label}&api-version={api-version} HTTP/1.1

Odpovědi:

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": []
}

Pokud klíč-hodnota neexistuje, vrátí se následující odpověď:

HTTP/1.1 404 Not Found

Odemknutí hodnoty klíče

  • Povinné: {key}, {api-version}
  • Volitelný: label
DELETE /locks/{key}?label={label}?api-version={api-version} HTTP/1.1

Odpovědi:

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": []
}

Pokud klíč-hodnota neexistuje, vrátí se následující odpověď:

HTTP/1.1 404 Not Found

Podmíněný zámek a odemknutí

Pokud chcete zabránit podmínkám časování, použijte If-Match hlavičky požadavků nebo If-None-Match jejich hlavičky. Argument etag je součástí klíčové reprezentace. Pokud If-Match je operace vynechána nebo If-None-Match je vynechána, je nepodmíněná.

Následující požadavek použije operaci pouze v případě, že aktuální reprezentace klíč-hodnota odpovídá zadanému etag:

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

Následující požadavek použije operaci pouze v případě, že existuje aktuální reprezentace klíč-hodnota, ale neodpovídá zadanému etag:

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