Partager via


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