Zámky
Toto rozhraní API (verze 1.0) poskytuje sémantiku uzamčení a odemknutí pro prostředek klíč-hodnota. Podporuje následující operace:
- Umístit zámek
- Odebrat zámek
Pokud je k dispozici, label
musí se jednat o explicitní hodnotu popisku (ne zástupný znak). Pro všechny operace je to volitelný parametr. Pokud ho vynecháte, znamená to, že neexistuje žádný popisek.
Požadavky
- Všechny požadavky HTTP musí být ověřené. Projděte si část věnovanou ověřování .
- Všechny požadavky HTTP musí poskytovat explicitní
api-version
. Projděte si část věnovanou správě verzí .
Uzamknout klíč-hodnota
- Povinné:
{key}
,{api-version}
- Volitelné:
label
PUT /locks/{key}?label={label}&api-version={api-version} HTTP/1.1
Reakce:
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
Odemknout klíč-hodnota
- Povinné:
{key}
,{api-version}
- Volitelné:
label
DELETE /locks/{key}?label={label}?api-version={api-version} HTTP/1.1
Reakce:
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é uzamčení a odemknutí
Pokud chcete zabránit konfliktům časování, použijte If-Match
hlavičky nebo If-None-Match
žádosti. Argument etag
je součástí reprezentace klíče. Pokud If-Match
jsou nebo If-None-Match
vynechány, operace 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é etag
hodnotě :
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"