Udostępnij za pośrednictwem

Nagłówki

  • Artykuł

Ten artykuł zawiera linki do stron referencyjnych nagłówków używanych z interfejsem API REST Azure App Configuration.

Nagłówki żądań

W poniższej tabeli opisano typowe nagłówki żądań używane w Azure App Configuration.

Nagłówek Opis Przykład
Autoryzacja Służy do uwierzytelniania żądania w usłudze. Zobacz sekcję 14.8 Authorization: HMAC-SHA256 Credential=<Credential>&SignedHeaders=Host;x-ms-date;x-ms-content-sha256&Signature=<Signature>
Zaakceptowanie Informuje serwer o typie nośnika, który klient zaakceptuje w odpowiedzi HTTP. Zobacz sekcję 14.1 Accept: application/vnd.microsoft.appconfig.kv+json;
Accept-Datetime Żąda, aby serwer zwrócił jego zawartość jako reprezentację poprzedniego stanu. Wartość tego nagłówka to żądana data/godzina tego stanu. Zobacz RFC 7089 Accept-Datetime: Sat, 12 May 2018 02:10:00 GMT
Typ zawartości Zawiera typ nośnika zawartości w treści żądania HTTP. Zobacz sekcję 14.17 Content-Type: application/vnd.microsoft.appconfig.kv+json; charset=utf-8;
Data Data/godzina wystawienia żądania HTTP. Ten nagłówek jest używany w uwierzytelnianiu HMAC. Zobacz sekcję 14.18 Date: Fri, 11 May 2018 18:48:36 GMT
Host Określa dzierżawę, dla której zostało wystawione żądanie. Ten nagłówek jest używany w uwierzytelnianiu HMAC. Zobacz sekcję 14.23 Host: contoso.azconfig.io
Dopasowanie warunkowe Służy do warunkowego żądania HTTP. To żądanie powinno zakończyć się powodzeniem tylko wtedy, gdy element ETag zasobu docelowego jest zgodny z wartością tego nagłówka. Wartość "*" pasuje do dowolnego elementu ETag. Zobacz sekcję 14.24 If-Match: "4f6dd610dd5e4deebc7fbaef685fb903"
Dopasowanie if-none Służy do warunkowego żądania HTTP. To żądanie powinno zakończyć się powodzeniem tylko wtedy, gdy element ETag zasobu docelowego nie jest zgodny z wartością tego nagłówka. Wartość "*" pasuje do dowolnego elementu ETag. Zobacz sekcję 14.26 If-None-Match: "4f6dd610dd5e4deebc7fbaef685fb903"
Token synchronizacji Służy do włączania spójności w czasie rzeczywistym podczas sekwencji żądań. Sync-Token: jtqGc1I4=MDoyOA==;sn=28
x-ms-client-request-id Unikatowy identyfikator dostarczony przez klienta służący do śledzenia rundy żądania. x-ms-client-request-id: 00000000-0000-0000-0000-000000000000
x-ms-content-sha256 Skrót sha256 treści żądania HTTP. Ten nagłówek jest używany w uwierzytelnianiu HMAC. x-ms-content-sha256: 47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=
x-ms-date Ten nagłówek może być ustawiony i używany zamiast nagłówka Date , jeśli nie można uzyskać dostępu do nagłówka daty. Ten nagłówek jest używany w uwierzytelnianiu HMAC. x-ms-date: Fri, 11 May 2018 18:48:36 GMT
x-ms-return-client-request-id Używany w połączeniu z nagłówkiem x-ms-client-request-id . Jeśli wartość tego nagłówka ma wartość "true", serwer zostanie poproszony o zwrócenie wartości nagłówka x-ms-client-request-id żądania. x-ms-return-client-request-id: true

Nagłówki odpowiedzi

Serwer może zawierać następujące nagłówki HTTP w odpowiedziach.

Nagłówek Opis Przykład
Typ zawartości Zawiera typ nośnika zawartości w treści odpowiedzi HTTP. Zobacz sekcję 14.17 Content-Type: application/vnd.microsoft.appconfig.kv+json; charset=utf-8;
Etag Nieprzezroczysty token reprezentujący stan danego zasobu. Może być używany w operacjach warunkowych. Zobacz sekcję 14.19 ETag: "4f6dd610dd5e4deebc7fbaef685fb903"
Ostatnia modyfikacja Opisuje, kiedy żądany zasób został ostatnio zmodyfikowany. Sformatowany jako data HTTP. Zobacz sekcję 14.29 Last-Modified: Tue, 05 Dec 2017 02:41:26 GMT
Link Udostępnia linki do zasobów, które są powiązane z odpowiedzią. Ten nagłówek jest używany do stronicowania przy użyciu następnego linku. Zobacz RFC 5988 Link: </kv?after={token}>; rel="next"
Memento-Datetime Wskazuje, że zawartość zawarta w odpowiedzi reprezentuje poprzedni stan. Wartość tego nagłówka to data/godzina tego stanu. Zobacz RFC 7089 Memento-Datetime: Sat, 12 May 2018 02:10:00 GMT
retry-after-ms Zawiera sugerowany okres (w milisekundach), który klient będzie czekał przed ponowieniu próby żądania, które zakończyło się niepowodzeniem. retry-after-ms: 10
x-ms-request-id Unikatowy identyfikator wygenerowany przez serwer, który jest używany do śledzenia żądania w usłudze. x-ms-request-id: 00000000-0000-0000-0000-000000000000
Uwierzytelnianie WWW Służy do kwestionowania klientów na potrzeby uwierzytelniania i podawania przyczyny niepowodzenia próby uwierzytelnienia. Zobacz sekcję 14.47 WWW-Authenticate: HMAC-SHA256 error="invalid_token" error_description="Invalid Signature"