Anahtar-değer düzeltmeleri

Anahtar-değer düzeltmesi , anahtar-değer kaynağının geçmiş gösterimini tanımlar. Düzeltmelerin süresi Ücretsiz katman depoları için 7 gün, Standart katman depoları için 30 gün sonra sona erer. Düzeltmeler işlemi destekler List .

Tüm işlemler için isteğe key bağlı bir parametredir. Atlanırsa herhangi bir anahtar anlamına gelir.

Tüm işlemler için isteğe label bağlı bir parametredir. Atlanırsa herhangi bir etiket anlamına gelir.

Önkoşullar

• Tüm HTTP isteklerinin kimliği doğrulanmalıdır. Kimlik doğrulama bölümüne bakın.
• Tüm HTTP istekleri açık api-versionsağlamalıdır. Sürüm oluşturma bölümüne bakın.

Düzeltmeleri listeleme

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

Yanıt:

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}"
}

Sayfalandırma

Döndürülen öğe sayısı yanıt sınırını aşarsa sonuç sayfalanır. İsteğe bağlı Link yanıt üst bilgisini izleyin ve gezinti için kullanın rel="next" . Alternatif olarak, içerik özelliği biçiminde @nextLink bir sonraki bağlantı sağlar.

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

Yanıt:

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}"
}

Düzeltmelerin alt kümesini listeleme

Range İstek üst bilgisini kullanın. Yanıt, bir Content-Range üst bilgisi içeriyor. Sunucu istenen aralığı karşılayamazsa HTTP 416 (RangeNotSatisfiable ) ile yanıt verir.

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

Filtreleme

ve filtrelemenin key label bir bileşimi desteklenir. İsteğe bağlı key ve label sorgu dizesi parametrelerini kullanın.

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

ve filtrelemenin keylabel tags birleşimi desteklenir. İsteğe bağlı keyve label tags sorgu dizesi parametrelerini kullanın. Biçiminde sorgu dizesi parametresi tagName=tagValue olarak birden çok etiket filtresi sağlanabilir. Etiket filtreleri tam eşleşmelidir.

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

Desteklenen filtreler

Ayrılmış karakterler

Ayrılmış karakterler şunlardır:

*, \, ,

Ayrılmış karakter değerin bir parçasıysa, kullanılarak \{Reserved Character}kaçış karakteri kullanılmalıdır. Ayrılmış olmayan karakterler de kaçılabilir.

Filtre doğrulama

Bir filtre doğrulama hatası oluşursa yanıt, hata ayrıntılarını içeren HTTP'dir 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
}

Örnekler

• Tümü:

  GET /revisions
  

• Anahtar adının abc ile başladığı öğeler:

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

• Anahtar adının abc veya xyz olduğu ve etiketlerin prod içerdiği öğeler:

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

Belirli alanlar isteme

İsteğe bağlı $select sorgu dizesi parametresini kullanın ve istenen alanların virgülle ayrılmış listesini sağlayın. $select Parametresi atlanırsa, yanıt varsayılan kümeyi içerir.

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

Zamana bağlı erişim

Sonucun geçmiş bir zamanda olduğu gibi bir gösterimini elde edin. Daha fazla bilgi için bkz . Kaynak Durumlarına Zamana Dayalı Erişim için HTTP Çerçevesi -- Memento, bölüm 2.1.1.

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

Yanıt:

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