다음을 통해 공유

잠금

  • 아티클

이 API는 키-값 리소스에 대한 잠금 및 잠금 해제 의미 체계를 제공합니다. 다음 작업을 지원합니다.

  • 잠금 배치
  • 잠금 제거

있는 label 경우 와일드카드가 아닌 명시적 레이블 값이어야 합니다. 모든 작업에는 선택적 매개 변수입니다. 생략하면 레이블이 없음을 의미합니다.

필수 조건

  • 모든 HTTP 요청은 인증되어야 합니다. 인증 섹션을 참조하세요.
  • 모든 HTTP 요청은 명시적 api-version. 버전 관리 세션을 참조하세요.

키-값 잠금

  • 필수: {key}, {api-version}
  • 선택적: label
PUT /locks/{key}?label={label}&api-version={api-version} HTTP/1.1

응답:

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

키-값이 없으면 다음 응답이 반환됩니다.

HTTP/1.1 404 Not Found

키-값 잠금 해제

  • 필수: {key}, {api-version}
  • 선택적: label
DELETE /locks/{key}?label={label}?api-version={api-version} HTTP/1.1

응답:

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

키-값이 없으면 다음 응답이 반환됩니다.

HTTP/1.1 404 Not Found

조건부 잠금 및 잠금 해제

경합 상태를 방지하려면 헤더를 사용 If-Match 하거나 If-None-Match 요청합니다. etag 인수는 키 표현의 일부입니다. If-Match 또는 If-None-Match가 생략된 경우에는 작업이 무조건 수행됩니다.

다음 요청은 현재 키-값 표현이 지정된 etag값과 일치하는 경우에만 작업을 적용합니다.

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

다음 요청은 현재 키-값 표현이 존재하지만 지정된 etag값과 일치하지 않는 경우에만 작업을 적용합니다.

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