Delen via

Kopteksten

  • Artikel

Dit artikel bevat koppelingen naar referentiepagina's voor headers die worden gebruikt met de Azure App Configuration REST API.

Aanvraagheaders

In de volgende tabel worden algemene aanvraagheaders beschreven die in Azure App Configuration worden gebruikt.

Header Beschrijving Voorbeeld
Autorisatie Wordt gebruikt om een aanvraag bij de service te verifiëren . Zie sectie 14.8 Authorization: HMAC-SHA256 Credential=<Credential>&SignedHeaders=Host;x-ms-date;x-ms-content-sha256&Signature=<Signature>
Accepteren Informeert de server welk mediatype de client accepteert in een HTTP-antwoord. Zie sectie 14.1 Accept: application/vnd.microsoft.appconfig.kv+json;
Accept-Datetime Vraagt de server om de inhoud ervan te retourneren als een weergave van de vorige status. De waarde van deze header is de aangevraagde datum/tijd van die status. Zie RFC 7089 Accept-Datetime: Sat, 12 May 2018 02:10:00 GMT
Content-Type Bevat het mediatype van de inhoud in de hoofdtekst van de HTTP-aanvraag. Zie sectie 14.17 Content-Type: application/vnd.microsoft.appconfig.kv+json; charset=utf-8;
Datum De datum waarop de HTTP-aanvraag is uitgegeven. Deze header wordt gebruikt in HMAC-verificatie. Zie sectie 14.18 Date: Fri, 11 May 2018 18:48:36 GMT
Host Hiermee geeft u de tenant waarvoor de aanvraag is uitgegeven. Deze header wordt gebruikt in HMAC-verificatie. Zie sectie 14.23 Host: contoso.azconfig.io
Als-overeenkomst Wordt gebruikt om een HTTP-aanvraag voorwaardelijk te maken. Deze aanvraag moet alleen slagen als de ETag van de doelresource overeenkomt met de waarde van deze header. De waarde *komt overeen met een willekeurige ETag. Zie sectie 14.24 If-Match: "4f6dd610dd5e4deebc7fbaef685fb903"
If-None-Match Wordt gebruikt om een HTTP-aanvraag voorwaardelijk te maken. Deze aanvraag moet alleen slagen als de ETag van de doelresource niet overeenkomt met de waarde van deze header. De waarde *komt overeen met een willekeurige ETag. Zie sectie 14.26 If-None-Match: "4f6dd610dd5e4deebc7fbaef685fb903"
Synchronisatietoken Wordt gebruikt om realtimeconsistentie in te schakelen tijdens een reeks aanvragen. Sync-Token: jtqGc1I4=MDoyOA==;sn=28
x-ms-client-request-id Een unieke id die is opgegeven door de client die wordt gebruikt om de retour van een aanvraag bij te houden. x-ms-client-request-id: 00000000-0000-0000-0000-000000000000
x-ms-content-sha256 Een sha256-samenvatting van de HTTP-aanvraagbody. Deze header wordt gebruikt in HMAC-verificatie. x-ms-content-sha256: 47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=
x-ms-date Deze header kan worden ingesteld en gebruikt in plaats van de Date koptekst als de datumkoptekst niet kan worden geopend. Deze header wordt gebruikt in HMAC-verificatie. x-ms-date: Fri, 11 May 2018 18:48:36 GMT
x-ms-return-client-request-id Wordt gebruikt in combinatie met de x-ms-client-request-id header. Als de waarde van deze header 'true' is, wordt de server geïnstrueerd om de waarde van de x-ms-client-request-id aanvraagheader te retourneren. x-ms-return-client-request-id: true

Antwoordheaders

De server kan de volgende HTTP-headers in de antwoorden opnemen.

Header Beschrijving Voorbeeld
Content-Type Bevat het mediatype van de inhoud in de hoofdtekst van het HTTP-antwoord. Zie sectie 14.17 Content-Type: application/vnd.microsoft.appconfig.kv+json; charset=utf-8;
ETag Een ondoorzichtig token dat de status van een bepaalde resource vertegenwoordigt. Kan worden gebruikt in voorwaardelijke bewerkingen. Zie sectie 14.19 ETag: "4f6dd610dd5e4deebc7fbaef685fb903"
Laatst gewijzigd Beschrijft wanneer de aangevraagde resource voor het laatst is gewijzigd. Opgemaakt als een HTTP-datum. Zie sectie 14.29 Last-Modified: Tue, 05 Dec 2017 02:41:26 GMT
Koppeling Bevat koppelingen naar resources die zijn gerelateerd aan het antwoord. Deze koptekst wordt gebruikt voor paging met behulp van de volgende koppeling. Zie RFC 5988 Link: </kv?after={token}>; rel="next"
Aandenken-datum/tijd Geeft aan dat de inhoud in een antwoord een eerdere status vertegenwoordigt. De waarde van deze koptekst is de datum/tijd van die status. Zie RFC 7089 Memento-Datetime: Sat, 12 May 2018 02:10:00 GMT
opnieuw proberen na ms Biedt een voorgestelde periode (in milliseconden) voor de client om te wachten voordat een mislukte aanvraag opnieuw wordt geprobeerd. retry-after-ms: 10
x-ms-request-id Een unieke id die wordt gegenereerd door de server die wordt gebruikt om de aanvraag binnen de service bij te houden. x-ms-request-id: 00000000-0000-0000-0000-000000000000
WWW-verificatie Wordt gebruikt om clients te vragen om verificatie en een reden op te geven waarom een verificatiepoging is mislukt. Zie sectie 14.47 WWW-Authenticate: HMAC-SHA256 error="invalid_token" error_description="Invalid Signature"