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}