Partager via


Interrogation des offres

Vous pouvez effectuer des requêtes sur des ressources d'offres en émettant une demande POST sur celles-ci, c'est-à-dire sur le chemin d'accès de l'URI des offres. Cette section montre un exemple simple de récupération des offres d’une collection particulière par son lien automatique.

Requête

Méthode URI de demande Description
POST https://{databaseaccount}.documents.azure.com/offers Notez que {databaseaccount} est le nom du compte Azure Cosmos DB que vous avez créé sous votre abonnement.

En-têtes

Consultez En-têtes de requête REST Azure Cosmos DB courants pour les en-têtes utilisés par toutes les requêtes Cosmos DB.

En-tête Obligatoire Description
Content-Type Obligatoire Doit être défini sur application/query+json.
x-ms-documentdb-isquery Obligatoire Doit avoir la valeur True.

body

Propriété Obligatoire Description
requête Obligatoire La valeur de cette propriété est l'instruction SQL à exécuter.
{"query":"SELECT * FROM root WHERE root.resource = \"dbs/EVQzAA==/colls/EVQzALIIEQw=/\") "}

response

Retourne un tableau de ressources d’objet qui correspondent à la requête.

En-têtes

Consultez En-têtes de réponse REST Azure Cosmos DB courants pour les en-têtes retournés par toutes les réponses Cosmos DB.

En-tête Description
x-ms-item-count Il s’agit du nombre d’éléments retournés par la requête.

Codes d’état

Le tableau suivant répertorie les codes d'état courants renvoyés par cette opération. Pour obtenir la liste complète des codes status, consultez Codes d’état HTTP.

Code d'état HTTP Description
200 Ok L'opération a réussi.
400 Demande incorrecte Le corps au format JSON n'est pas valide.
401 Non autorisé L'en-tête Autorization ou x-ms-date n'est pas défini. 401 est également renvoyé quand la valeur définie pour l'en-tête Autorization est un jeton d'autorisation non valide.

body

Propriété Description
_Débarrasser Il s’agit d’une propriété générée par le système. La valeur _rid est vide pour cette opération.
_Compter Cette propriété indique le nombre d’offres retournées dans le cadre de l’opération.
Offres Il s’agit du tableau contenant les offres retournées dans le cadre de l’opération.
Consultez Offres pour trouver les propriétés de la ressource d’offre.
{"_rid":"","Offers":[],"_count":0}  

Exemple

POST https://querydemo.documents.azure.com/offers HTTP/1.1  
x-ms-continuation:   
x-ms-documentdb-isquery: True  
x-ms-documentdb-query-enablecrosspartition: False  
x-ms-date: Tue, 29 Mar 2016 18:07:41 GMT  
authorization: type%3dmaster%26ver%3d1.0%26sig%3d0si%2fhno2pKTQhgvdkojNqlQlYdoguwQEBt79XvpobMc%3d  
Cache-Control: no-cache  
User-Agent: Microsoft.Azure.Documents.Client/1.6.0.0 samples-net/3  
x-ms-version: 2015-12-16  
Accept: application/json  
Content-Type: application/query+json  
Host: querydemo.documents.azure.com  
Content-Length: 94  
Expect: 100-continue  
  
{"query":"SELECT * FROM root WHERE root.resource = \"dbs/EVQzAA==/colls/EVQzALIIEQw=/\") "}
  
HTTP/1.1 200 Ok  
Cache-Control: no-store, no-cache  
Pragma: no-cache  
Transfer-Encoding: chunked  
Content-Type: application/json  
Server: Microsoft-HTTPAPI/2.0  
Strict-Transport-Security: max-age=31536000  
x-ms-last-state-change-utc: Fri, 25 Mar 2016 21:27:20.035 GMT  
x-ms-item-count: 0  
x-ms-schemaversion: 1.1  
x-ms-request-charge: 3.94  
x-ms-serviceversion: version=1.6.52.5  
x-ms-activity-id: b151cbe4-aae0-4949-959f-189b9884478d  
x-ms-session-token: M:8166  
x-ms-gatewayversion: version=1.6.52.5  
Date: Tue, 29 Mar 2016 18:07:41 GMT  
  
{"_rid":"","Offers":[],"_count":0}  
  

Voir aussi