Lås

Det här API:et tillhandahåller lås- och upplåsningssemantik för nyckelvärdesresursen. Den stöder följande åtgärder:

• Placera lås
• Ta bort lås

Om det finns label måste det vara ett explicit etikettvärde (inte ett jokertecken). För alla åtgärder är det en valfri parameter. Om det utelämnas innebär det ingen etikett.

Förutsättningar

• Alla HTTP-begäranden måste autentiseras. Se avsnittet autentisering.
• Alla HTTP-begäranden måste ange explicit api-version. Se avsnittet versionshantering.

Lås nyckelvärde

• Krävs: {key}, {api-version}
• Valfri: label

PUT /locks/{key}?label={label}&api-version={api-version} HTTP/1.1

Svaren:

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

Om nyckelvärdet inte finns returneras följande svar:

HTTP/1.1 404 Not Found

Låsa upp nyckelvärde

• Krävs: {key}, {api-version}
• Valfri: label

DELETE /locks/{key}?label={label}?api-version={api-version} HTTP/1.1

Svaren:

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

Om nyckelvärdet inte finns returneras följande svar:

HTTP/1.1 404 Not Found

Villkorligt lås och upplåsning

För att förhindra tävlingsvillkor använder If-Match du eller If-None-Match begär rubriker. Argumentet etag är en del av nyckelrepresentationen. Om If-Match eller If-None-Match utelämnas är åtgärden ovillkorlig.

Följande begäran tillämpar endast åtgärden om den aktuella nyckel/värde-representationen matchar den angivna etag:

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

Följande begäran tillämpar endast åtgärden om den aktuella nyckel/värde-representationen finns, men inte matchar den angivna etag:

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