Intestazioni di risposta REST comuni di Azure Cosmos DB
Le intestazioni di risposta seguenti sono comuni a tutte le risposte dell'API SQL:
| Intestazione | Descrizione |
|---|---|
| Content-Type | Content-Type è application/json. L'API SQL restituisce sempre il corpo della risposta in formato JSON standard. |
| Data | Data e ora dell'operazione di risposta. Questo formato di data e ora è conforme allo standard RFC 1123 espresso in Coordinated Universal Time. |
| etag | L'intestazione etag mostra l'etag della risorsa recuperata. L'etag ha lo stesso valore della proprietà _etag nel corpo della risposta. |
| x-ms-activity-id | Rappresenta un identificatore univoco per l'operazione. In questo modo viene restituito il valore dell'intestazione della richiesta x-ms-activity-id e viene comunemente usato per la risoluzione dei problemi. |
| x-ms-alt-content-path | Percorso alternativo della risorsa. Le risorse possono essere indirizzate in REST tramite ID generati dal sistema o ID specificati dall'utente. x-ms-alt-content-path rappresenta il percorso costruito usando gli ID specificati dall'utente. |
| x-ms-continuation | Questa intestazione rappresenta lo stato intermedio dell'esecuzione della query (o del feed di lettura) e viene restituita quando nella risposta vengono restituiti risultati aggiuntivi. I client possono inviare di nuovo la richiesta con un'intestazione di richiesta contenente valore di x-ms-continuation. |
| x-ms-item-count | Numero di elementi restituiti per una query o una richiesta di feed di lettura. |
| x-ms-request-charge | Si tratta del numero di richieste normalizzate per l'operazione. Per altre informazioni, vedere Unità richiesta in Azure Cosmos DB. |
| x-ms-resource-quota | Mostra la quota assegnata per una risorsa in un account. |
| x-ms-resource-usage | Mostra il numero di utilizzo corrente di una risorsa in un account. Quando si elimina una risorsa, viene visualizzato il numero di risorse dopo l'eliminazione. |
| x-ms-retry-after-ms | Numero di millisecondi di attesa per ripetere l'operazione dopo che un'operazione iniziale ha ricevuto il codice di stato HTTP 429 ed è stata limitata. |
| x-ms-schemaversion | Mostra il numero di versione dello schema delle risorse. |
| x-ms-serviceversion | Mostra il numero di versione del servizio. |
| x-ms-session-token | Token di sessione della richiesta. Per la coerenza della sessione, i client devono eseguire l'eco di questa richiesta tramite l'intestazione della richiesta x-ms-session-token per le operazioni successive effettuate alla raccolta corrispondente. |
| x-ms-documentdb-partitionkeyrangeid | Intestazione interna che identifica l'intervallo di chiavi di partizione per la richiesta. È consigliabile che gli utenti non prendano alcuna dipendenza da questo valore di intestazione nelle applicazioni. |
Vedere anche