Sidhuvuden
Den här artikeln innehåller länkar till referenssidor för rubriker som används med Azure App Configuration REST API.
Rubriker för begäran
I följande tabell beskrivs vanliga begärandehuvuden som används i Azure App Configuration.
Huvud | Beskrivning | Exempel |
---|---|---|
Auktorisering | Används för att autentisera en begäran till tjänsten. Se avsnitt 14.8 | Authorization: HMAC-SHA256 Credential=<Credential>&SignedHeaders=Host;x-ms-date;x-ms-content-sha256&Signature=<Signature> |
Godkänn | Informerar servern om vilken medietyp klienten accepterar i ett HTTP-svar. Se avsnitt 14.1 | Accept: application/vnd.microsoft.appconfig.kv+json; |
Accept-Datetime | Begär att servern ska returnera dess innehåll som en representation av dess tidigare tillstånd. Värdet för det här huvudet är den begärda datetime för det tillståndet. Se RFC 7089 | Accept-Datetime: Sat, 12 May 2018 02:10:00 GMT |
Innehållstyp | Innehåller medietypen för innehållet i HTTP-begärandetexten. Se avsnitt 14.17 | Content-Type: application/vnd.microsoft.appconfig.kv+json; charset=utf-8; |
Datum | Den datetime som HTTP-begäran utfärdades. Det här huvudet används i HMAC-autentisering. Se avsnitt 14.18 | Date: Fri, 11 May 2018 18:48:36 GMT |
Värd | Anger den klientorganisation som begäran har utfärdats för. Det här huvudet används i HMAC-autentisering. Se avsnitt 14.23 | Host: contoso.azconfig.io |
If-Match | Används för att göra en HTTP-begäran villkorsstyrd. Den här begäran bör endast lyckas om målresursens ETag matchar värdet för det här huvudet. Värdet *matchar valfri ETag. Se avsnitt 14.24 | If-Match: "4f6dd610dd5e4deebc7fbaef685fb903" |
If-None-Match | Används för att göra en HTTP-begäran villkorsstyrd. Den här begäran bör endast lyckas om målresursens ETag inte matchar värdet för det här huvudet. Värdet *matchar valfri ETag. Se avsnitt 14.26 | If-None-Match: "4f6dd610dd5e4deebc7fbaef685fb903" |
Synkroniseringstoken | Används för att aktivera konsekvens i realtid under en sekvens med begäranden. | Sync-Token: jtqGc1I4=MDoyOA==;sn=28 |
x-ms-client-request-id | Ett unikt ID som tillhandahålls av klienten som används för att spåra en begärans tur-och-retur-resa. | x-ms-client-request-id: 00000000-0000-0000-0000-000000000000 |
x-ms-content-sha256 | En sha256-sammanfattning av HTTP-begärandetexten. Det här huvudet används i HMAC-autentisering. | x-ms-content-sha256: 47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU= |
x-ms-date | Det här huvudet kan anges och användas i stället för Date rubriken om datumrubriken inte kan nås. Det här huvudet används i HMAC-autentisering. |
x-ms-date: Fri, 11 May 2018 18:48:36 GMT |
x-ms-return-client-request-id | Används tillsammans med x-ms-client-request-id rubriken. Om värdet för det här huvudet är "sant" instrueras servern att returnera värdet för x-ms-client-request-id begärandehuvudet. |
x-ms-return-client-request-id: true |
Svarsrubriker
Servern kan innehålla följande HTTP-huvuden i sina svar.
Huvud | Beskrivning | Exempel |
---|---|---|
Innehållstyp | Innehåller medietypen för innehållet i HTTP-svarstexten. Se avsnitt 14.17 | Content-Type: application/vnd.microsoft.appconfig.kv+json; charset=utf-8; |
Etag | En täckande token som representerar tillståndet för en viss resurs. Kan användas i villkorsstyrda åtgärder. Se avsnitt 14.19 | ETag: "4f6dd610dd5e4deebc7fbaef685fb903" |
Senast ändrad | Beskriver när den begärda resursen senast ändrades. Formaterad som ett HTTP-datum. Se avsnitt 14.29 | Last-Modified: Tue, 05 Dec 2017 02:41:26 GMT |
Länk | Innehåller länkar till resurser som är relaterade till svaret. Det här huvudet används för växling med hjälp av nästa länk. Se RFC 5988 | Link: </kv?after={token}>; rel="next" |
Memento-Datetime | Anger att innehållet i ett svar representerar ett tidigare tillstånd. Värdet för det här huvudet är datetime för det tillståndet. Se RFC 7089 | Memento-Datetime: Sat, 12 May 2018 02:10:00 GMT |
försök igen efter ms | Ger en föreslagen period (i millisekunder) för klienten att vänta innan en misslyckad begäran försöker igen. | retry-after-ms: 10 |
x-ms-request-id | Ett unikt ID som genereras av servern som används för att spåra begäran i tjänsten. | x-ms-request-id: 00000000-0000-0000-0000-000000000000 |
WWW-Autentisera | Används för att utmana klienter för autentisering och ange en anledning till varför ett autentiseringsförsök har misslyckats. Se avsnitt 14.47 | WWW-Authenticate: HMAC-SHA256 error="invalid_token" error_description="Invalid Signature" |