En-têtes de réponse REST courants d’Azure Cosmos DB
Les en-têtes de réponse suivants sont communs à toutes les réponses de l’API SQL :
| En-tête | Description |
|---|---|
| Content-Type | Content-Type est application/json. L’API SQL retourne toujours le corps de la réponse au format JSON standard. |
| Date | Date/heure de l'opération de réponse. Ce format date/heure est conforme au format date/heure défini dans la RFC 1123 exprimé en temps universel coordonné. |
| etag | L’en-tête etag affiche l’etag de la ressource récupérée. L’etag a la même valeur que la propriété _etag dans le corps de la réponse. |
| x-ms-activity-id | Représente un identificateur unique pour l’opération. Cela fait écho à la valeur de l’en-tête de requête x-ms-activity-id, couramment utilisé à des fins de résolution des problèmes. |
| x-ms-alt-content-path | Chemin d’accès alternatif à la ressource. Les ressources peuvent être traitées dans REST via des ID générés par le système ou des ID fournis par l’utilisateur. x-ms-alt-content-path représente le chemin construit à l’aide d’ID fournis par l’utilisateur. |
| x-ms-continuation | Cet en-tête représente l’état intermédiaire de l’exécution de la requête (ou du flux de lecture) et est retourné lorsqu’il existe des résultats supplémentaires en dehors de ce qui a été retourné dans la réponse. Les clients peuvent soumettre à nouveau la demande avec un en-tête de requête contenant valeur de x-ms-continuation. |
| x-ms-item-count | Nombre d’éléments retournés pour une requête ou une demande de flux de lecture. |
| x-ms-request-charge | Il s’agit du nombre de requêtes normalisées, c’est-à-dire des unités de requête (RU) pour l’opération. Pour en savoir plus, voir Unités de requête dans Azure Cosmos DB. |
| x-ms-resource-quota | Affiche le quota alloué pour une ressource dans un compte. |
| x-ms-resource-usage | Affiche le nombre d’utilisation actuel d’une ressource dans un compte. Lors de la suppression d’une ressource, cela indique le nombre de ressources après la suppression. |
| x-ms-retry-after-ms | Nombre de millisecondes à attendre pour réessayer l’opération après qu’une opération initiale a reçu le code HTTP status 429 et a été limitée. |
| x-ms-schemaversion | Affiche le numéro de version du schéma de ressources. |
| x-ms-serviceversion | Affiche le numéro de version du service. |
| x-ms-session-token | Jeton de session de la demande. Pour la cohérence de session, les clients doivent faire écho à cette demande via l’en-tête de requête x-ms-session-token pour les opérations suivantes effectuées dans la collection correspondante. |
| x-ms-documentdb-partitionkeyrangeid | En-tête interne identifiant la plage de clés de partition pour la demande. Il est recommandé aux utilisateurs de ne pas dépendre de cette valeur d’en-tête dans leurs applications. |
Voir aussi