다음을 통해 공유

키-값 수정 버전

  • 아티클

키-값 수정은 키-값 리소스의 기록 표현을 정의합니다. 무료 계층 저장소의 경우 7일 또는 표준 계층 저장소의 경우 30일 후에 수정 내용이 만료됩니다. 수정 버전은 작업을 지원 List 합니다.

모든 작업에 대해 key 선택적 매개 변수입니다. 생략하는 경우 모든 키를 의미합니다.

모든 작업에 대해 label 선택적 매개 변수입니다. 생략하면 레이블을 의미합니다.

필수 조건

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

수정 버전 나열

GET /revisions?label=*&api-version={api-version} HTTP/1.1

응답:

HTTP/1.1 200 OK
Content-Type: application/vnd.microsoft.appconfig.kvset+json; charset=utf-8"
Accept-Ranges: items

{
    "items": [
        {
          "etag": "4f6dd610dd5e4deebc7fbaef685fb903",
          "key": "{key}",
          "label": "{label}",
          "content_type": null,
          "value": "example value",
          "last_modified": "2017-12-05T02:41:26.4874615+00:00",
          "tags": []
        },
        ...
    ],
    "@nextLink": "{relative uri}"
}

페이지 매김

반환된 항목 수가 응답 제한을 초과하면 결과가 페이지가 매겨집니다. 선택적 Link 응답 헤더를 따르고 탐색에 사용합니다 rel="next" . 또는 콘텐츠는 속성 형식의 @nextLink 다음 링크를 제공합니다.

GET /revisions?api-version={api-version} HTTP/1.1

응답:

HTTP/1.1 OK
Content-Type: application/vnd.microsoft.appconfig.kvs+json; charset=utf-8
Accept-Ranges: items
Link: <{relative uri}>; rel="next"

{
    "items": [
        ...
    ],
    "@nextLink": "{relative uri}"
}

수정 버전의 하위 집합 나열

요청 헤더를 Range 사용합니다. 응답에 Content-Range 헤더가 포함됩니다. 서버가 요청된 범위를 충족할 수 없는 경우 HTTP 416 (RangeNotSatisfiable)로 응답합니다.

GET /revisions?api-version={api-version} HTTP/1.1
Range: items=0-2

Response

HTTP/1.1 206 Partial Content
Content-Type: application/vnd.microsoft.appconfig.revs+json; charset=utf-8
Content-Range: items 0-2/80

필터링

key및 label 필터링의 조합이 지원됩니다. 선택적 key 및 label 쿼리 문자열 매개 변수를 사용합니다.

GET /revisions?key={key}&label={label}&api-version={api-version}

및 label tags 필터링의 key조합이 지원됩니다. 선택적 key및 label tags 쿼리 문자열 매개 변수를 사용합니다. 여러 태그 필터를 형식의 쿼리 문자열 매개 변수 tagName=tagValue 로 제공할 수 있습니다. 태그 필터는 정확히 일치해야 합니다.

GET /revisions?key={key}&label={label}&tags={tagFilter1}&tags={tagFilter2}&api-version={api-version}

지원되는 필터

키 필터 효과
key은 생략 또는 key=* 모든 키와 일치
key=abc abc라는 이름의 키와 일치
key=abc* abc로 시작하는 키 이름과 일치
key=*abc abc로 끝나는 키 이름과 일치
key=*abc* abc를 포함하는 키 이름과 일치
key=abc,xyz 키 이름 abc 또는 xyz 와 일치(5 CSV로 제한)
레이블 필터 효과
label은 생략 또는 label= 레이블이 없는 키 값과 일치
label=* 모든 레이블과 일치
label=prod 레이블 prod와 일치
label=prod* prod로 시작하는 레이블과 일치
label=*prod prod로 끝나는 레이블과 일치
label=*prod* prod를 포함하는 레이블과 일치
label=prod,test 레이블 prod 또는 test(5 CSV로 제한)와 일치
태그 필터 효과
tags은 생략 또는 tags= 모든 태그와 일치
tags=group=app1 값으로 명명 group 된 태그가 있는 키-값과 일치 app1
tags=group=app1&tags=env=prod 값이 있는 태그와 값이 있는 group 태그 env 가 있는 키-값 app1 prod과 일치합니다(태그 필터 5개로 제한됨).
tags=tag1=%00 값으로 명명 tag1 된 태그가 있는 키-값과 일치 null
tags=tag1= 빈 값으로 명명 tag1 된 태그가 있는 키 값과 일치

예약 문자

예약 문자는 다음과 같습니다.

*, , \,

예약 문자가 값의 일부인 \{Reserved Character}경우 . 예약되지 않은 문자도 이스케이프할 수 있습니다.

필터 유효성 검사

필터 유효성 검사 오류가 발생하는 경우, 응답은 오류 세부 정보가 있는 HTTP 400입니다.

HTTP/1.1 400 Bad Request
Content-Type: application/problem+json; charset=utf-8

{
  "type": "https://azconfig.io/errors/invalid-argument",
  "title": "Invalid request parameter '{filter}'",
  "name": "{filter}",
  "detail": "{filter}(2): Invalid character",
  "status": 400
}

예제

  • All:

    GET /revisions

  • 키 이름이 abc로 시작하는 항목:

    GET /revisions?key=abc*&api-version={api-version}

  • 키 이름이 abc 또는 xyz이고 레이블에 prod가 포함된 항목:

    GET /revisions?key=abc,xyz&label=*prod*&api-version={api-version}

요청 관련 필드

선택적 $select 쿼리 문자열 매개 변수를 사용하고 요청된 필드의 쉼표로 구분된 목록을 제공합니다. $select 매개 변수를 생략하면 응답에 기본 세트가 포함됩니다.

GET /revisions?$select=value,label,last_modified&api-version={api-version} HTTP/1.1

시간 기반 액세스

과거와 같은 결과의 표시를 얻습니다. 자세한 내용은 리소스 상태에 대한 시간 기반 액세스를 위한 HTTP Framework를 참조 하세요. Memento, 섹션 2.1.1.

GET /revisions?api-version={api-version} HTTP/1.1
Accept-Datetime: Sat, 12 May 2018 02:10:00 GMT

응답:

HTTP/1.1 200 OK
Content-Type: application/vnd.microsoft.appconfig.revs+json"
Memento-Datetime: Sat, 12 May 2018 02:10:00 GMT
Link: <{relative uri}>; rel="original"

{
    "items": [
        ....
    ]
}