Vergrendelingen
Deze API (versie 1.0) biedt semantiek voor vergrendelen en ontgrendelen voor de sleutel-waarderesource. Het ondersteunt de volgende bewerkingen:
- Vergrendeling plaatsen
- Vergrendeling verwijderen
Indien aanwezig, label
moet een expliciete labelwaarde zijn (geen jokerteken). Voor alle bewerkingen is het een optionele parameter. Als u dit weglaat, impliceert dit geen label.
Vereisten
- Alle HTTP-aanvragen moeten worden geverifieerd. Zie de sectie verificatie .
- Alle HTTP-aanvragen moeten expliciet
api-version
zijn. Zie de sectie versiebeheer .
Sleutelwaarde vergrendelen
- Vereist:
{key}
,{api-version}
- Optionele:
label
PUT /locks/{key}?label={label}&api-version={api-version} HTTP/1.1
Reacties:
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": []
}
Als de sleutelwaarde niet bestaat, wordt het volgende antwoord geretourneerd:
HTTP/1.1 404 Not Found
Sleutelwaarde ontgrendelen
- Vereist:
{key}
,{api-version}
- Optionele:
label
DELETE /locks/{key}?label={label}?api-version={api-version} HTTP/1.1
Reacties:
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": []
}
Als de sleutelwaarde niet bestaat, wordt het volgende antwoord geretourneerd:
HTTP/1.1 404 Not Found
Voorwaardelijk vergrendelen en ontgrendelen
Gebruik If-Match
of If-None-Match
aanvraagheaders om racevoorwaarden te voorkomen. Het etag
argument maakt deel uit van de sleutelweergave. Als If-Match
of If-None-Match
worden weggelaten, is de bewerking onvoorwaardelijk.
Met de volgende aanvraag wordt de bewerking alleen toegepast als de huidige sleutelwaardeweergave overeenkomt met de opgegeven etag
:
PUT|DELETE /locks/{key}?label={label}&api-version={api-version} HTTP/1.1
If-Match: "4f6dd610dd5e4deebc7fbaef685fb903"
Met de volgende aanvraag wordt de bewerking alleen toegepast als de huidige sleutel-waarderepresentatie bestaat, maar niet overeenkomt met de opgegeven etag
:
PUT|DELETE /kv/{key}?label={label}&api-version={api-version} HTTP/1.1
If-None-Match: "4f6dd610dd5e4deebc7fbaef685fb903"
Feedback
https://aka.ms/ContentUserFeedback.
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie:Feedback verzenden en weergeven voor