Condividi tramite

Intestazioni

  • Articolo

Questo articolo fornisce collegamenti alle pagine di riferimento per le intestazioni usate con l'API REST Configurazione app di Azure.

Intestazioni richiesta

Nella tabella seguente vengono descritte le intestazioni di richiesta comuni usate in Configurazione app di Azure.

Intestazione Descrizione Esempio
Autorizzazione Usato per autenticare una richiesta al servizio. Vedere la sezione 14.8 Authorization: HMAC-SHA256 Credential=<Credential>&SignedHeaders=Host;x-ms-date;x-ms-content-sha256&Signature=<Signature>
Accettare Indica al server il tipo di supporto che il client accetterà in una risposta HTTP. Vedere la sezione 14.1 Accept: application/vnd.microsoft.appconfig.kv+json;
Accept-Datetime Richiede al server di restituire il contenuto come rappresentazione dello stato precedente. Il valore di questa intestazione è il valore datetime richiesto di tale stato. Vedere RFC 7089 Accept-Datetime: Sat, 12 May 2018 02:10:00 GMT
Content-Type Contiene il tipo di supporto del contenuto all'interno del corpo della richiesta HTTP. Vedere la sezione 14.17 Content-Type: application/vnd.microsoft.appconfig.kv+json; charset=utf-8;
Data Data e ora in cui è stata eseguita la richiesta HTTP. Questa intestazione viene usata nell'autenticazione HMAC. Vedere la sezione 14.18 Date: Fri, 11 May 2018 18:48:36 GMT
Host Specifica il tenant per cui è stata eseguita la richiesta. Questa intestazione viene usata nell'autenticazione HMAC. Vedere la sezione 14.23 Host: contoso.azconfig.io
If-Match Usato per rendere condizionale una richiesta HTTP. Questa richiesta deve avere esito positivo solo se L'ETag della risorsa di destinazione corrisponde al valore di questa intestazione. Il valore '*' corrisponde a qualsiasi ETag. Vedere la sezione 14.24 If-Match: "4f6dd610dd5e4deebc7fbaef685fb903"
If-None-Match Usato per rendere condizionale una richiesta HTTP. Questa richiesta deve avere esito positivo solo se L'ETag della risorsa di destinazione non corrisponde al valore di questa intestazione. Il valore '*' corrisponde a qualsiasi ETag. Vedere la sezione 14.26 If-None-Match: "4f6dd610dd5e4deebc7fbaef685fb903"
Token di sincronizzazione Usato per abilitare la coerenza in tempo reale durante una sequenza di richieste. Sync-Token: jtqGc1I4=MDoyOA==;sn=28
x-ms-client-request-id ID univoco fornito dal client usato per tenere traccia del round trip di una richiesta. x-ms-client-request-id: 00000000-0000-0000-0000-000000000000
x-ms-content-sha256 Digest sha256 del corpo della richiesta HTTP. Questa intestazione viene usata nell'autenticazione HMAC. x-ms-content-sha256: 47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=
x-ms-date Questa intestazione può essere impostata e utilizzata al posto dell'intestazione Date se non è possibile accedere all'intestazione data. Questa intestazione viene usata nell'autenticazione HMAC. x-ms-date: Fri, 11 May 2018 18:48:36 GMT
x-ms-return-client-request-id Usato in combinazione con l'intestazione x-ms-client-request-id . Se il valore di questa intestazione è "true", verrà richiesto al server di restituire il valore dell'intestazione della x-ms-client-request-id richiesta. x-ms-return-client-request-id: true

Intestazioni della risposta

Il server può includere le intestazioni HTTP seguenti nelle relative risposte.

Intestazione Descrizione Esempio
Content-Type Contiene il tipo di supporto del contenuto all'interno del corpo della risposta HTTP. Vedere la sezione 14.17 Content-Type: application/vnd.microsoft.appconfig.kv+json; charset=utf-8;
ETag Token opaco che rappresenta lo stato di una determinata risorsa. Può essere usato nelle operazioni condizionali. Vedere la sezione 14.19 ETag: "4f6dd610dd5e4deebc7fbaef685fb903"
Last-Modified Descrive quando la risorsa richiesta è stata modificata per l'ultima volta. Formattato come HTTP-Date. Vedere la sezione 14.29 Last-Modified: Tue, 05 Dec 2017 02:41:26 GMT
Collegamento Fornisce collegamenti alle risorse correlate alla risposta. Questa intestazione viene usata per il paging usando il collegamento successivo . Vedere RFC 5988 Link: </kv?after={token}>; rel="next"
Memento-Datetime Indica che il contenuto contenuto contenuto in una risposta rappresenta uno stato precedente. Il valore di questa intestazione è il valore datetime di tale stato. Vedere RFC 7089 Memento-Datetime: Sat, 12 May 2018 02:10:00 GMT
retry-after-ms Fornisce un periodo suggerito (in millisecondi) che il client deve attendere prima di riprovare a una richiesta non riuscita. retry-after-ms: 10
x-ms-request-id ID univoco generato dal server usato per tenere traccia della richiesta all'interno del servizio. x-ms-request-id: 00000000-0000-0000-0000-000000000000
WWW-Authenticate Usato per sfidare i client per l'autenticazione e fornire un motivo per cui un tentativo di autenticazione non è riuscito. Vedere la sezione 14.47 WWW-Authenticate: HMAC-SHA256 error="invalid_token" error_description="Invalid Signature"