Lås

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

• Platslås
• Ta bort lås

Om det finns label måste 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 autentiseringsavsnittet .
• 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ås 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

Om du vill förhindra konkurrensvillkor 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"