Delen via

Vergrendelingen

  • Artikel

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-versionzijn. 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"