Azure Cosmos DB : Référence de l’API REST

  • Article

Azure Cosmos DB est une base de données multimodèle distribuée à l’échelle mondiale qui prend en charge les modèles de données de document, de graphique et de valeur clé. Le contenu de cette section est destiné à créer, interroger et gérer des ressources de document à l’aide de l’API SQL via REST.

L’API REST d’Azure Cosmos DB fournit un accès programmatique aux ressources d’Azure Cosmos DB pour créer, interroger et supprimer des bases de données, des collections de documents et des documents. Pour effectuer des opérations sur des ressources Azure Cosmos DB, vous envoyez des requêtes HTTPS avec une méthode prise en charge : GET, POSTPUT, ou DELETE à un point de terminaison qui cible une collection de ressources ou une ressource spécifique. Cette section explique comment utiliser des ressources à l’aide de l’API REST.

Notes

Ces articles de référence sur les API montrent comment créer des ressources à l’aide de l’API de plan de données Azure Cosmos DB. Avec l’API de plan de données, vous pouvez configurer des options de base telles que la stratégie d’indexation et les clés de partition, comme vous le pouvez avec les kits SDK Cosmos DB. Si vous avez besoin d’une prise en charge complète des fonctionnalités pour toutes les ressources Azure Cosmos DB, nous vous recommandons d’utiliser le fournisseur de ressources Cosmos DB. Les articles de référence sur les API sont répertoriés ci-dessous.

Versions d’API REST prises en charge

Le tableau suivant répertorie les versions d’API REST prises en charge par le service Azure Cosmos DB. La version doit être spécifiée via l’en-tête x-ms-version dans chaque requête. La dernière version est utilisée quand l'en-tête n'est pas fourni.

Version Modification introduite Date de mise hors service
2018-12-31 Migration automatique des collections partitionnés
2018-09-17 Indexation spatiale composite et supplémentaire
2018-08-31 Améliorations de la mise à l’échelle des collections dynamiques
2018-06-18 Prise en charge des écritures multirégions
2017-11-15 Cohérence forte multirégion
2017-05-03 Clé de partition volumineuse
2017-02-22 Préfixe cohérent
2017-01-19 Réduction du débit minimal pour les collections partitionnée à 2 500 RU/s
2016-07-11 Flux de modification
2015-12-16 Collections partitionnée
2015-08-06 Upsert
2015-06-03 Prise en charge de l’ordre par
2015-04-08 Disponibilité générale de DocumentDB (qui fait désormais partie d’Azure Cosmos DB)
2014-08-21 Préversion publique de DocumentDB (qui fait désormais partie d’Azure Cosmos DB) 29 février 2016

Ressources Cosmos DB

Les articles suivants décrivent les API REST prises en charge pour chaque type de ressource. Pour obtenir des informations générales sur le modèle de ressource, consultez Modèle de ressource et URI de ressource Cosmos DB.

Pour savoir comment autoriser les demandes, consultez Contrôle d’accès . Pour obtenir des informations générales sur les options de demande et de réponse, consultez les articles suivants :

Voir aussi