Azure Cosmos DB: REST API Reference (Azure Cosmos DB: Referenz zur REST-API)
Azure Cosmos DB ist eine global verteilte Datenbank mit mehreren Modellen, die die Dokument-, Graph- und Schlüssel-Wert-Datenmodelle unterstützt. Der Inhalt in diesem Abschnitt dient zum Erstellen, Abfragen und Verwalten von Dokumentressourcen mithilfe der SQL-API über REST.
Die Azure Cosmos DB REST-API bietet programmgesteuerten Zugriff auf Azure Cosmos DB-Ressourcen zum Erstellen, Abfragen und Löschen von Datenbanken, Dokumentsammlungen und Dokumenten. Zum Ausführen von Vorgängen für Azure Cosmos DB-Ressourcen senden Sie HTTPS-Anforderungen mit einer unterstützten Methode: GET, POST, PUToder DELETE an einen Endpunkt, der auf eine Ressourcensammlung oder eine bestimmte Ressource abzielt. In diesem Abschnitt wird erläutert, wie Sie mit Ressourcen mithilfe der REST-API arbeiten.
Hinweis
In diesen API-Referenzartikeln wird gezeigt, wie Ressourcen mithilfe der Azure Cosmos DB-Datenebenen-API erstellt werden. Mit der Datenebenen-API können Sie grundlegende Optionen wie Indizierungsrichtlinie und Partitionsschlüssel wie bei Cosmos DB SDKs konfigurieren. Wenn Sie vollständige Featureunterstützung für alle Azure Cosmos DB-Ressourcen benötigen, empfiehlt es sich, den Cosmos DB-Ressourcenanbieter zu verwenden. Api-Referenzartikel sind unten aufgeführt.
Unterstützte REST-API-Versionen
In der folgenden Tabelle sind die vom Azure Cosmos DB-Dienst unterstützten REST-API-Versionen aufgeführt. Die Version muss über den x-ms-version Header in jeder Anforderung angegeben werden. Die neueste Version wird verwendet, wenn der Header nicht angegeben ist.
| Version | Änderung eingeführt | Deaktivierungstermin |
|---|---|---|
| 2018-12-31 | Automatische Migration partitionierte Sammlungen | |
| 2018-09-17 | Zusammengesetzte und zusätzliche räumliche Indizierung | |
| 2018-08-31 | Verbesserungen bei der dynamischen Sammlungsskalierung | |
| 2018-06-18 | Unterstützung von Schreibvorgängen in mehreren Regionen | |
| 2017-11-15 | Starke Konsistenz in mehreren Regionen | |
| 2017-05-03 | Großer Partitionsschlüssel | |
| 2017-02-22 | Präfixkonsistenz | |
| 2017-01-19 | Verringerter Mindestdurchsatz für partitionierte Sammlungen auf 2500 RU/s | |
| 2016-07-11 | Änderungsfeed | |
| 2015-12-16 | Partitionierte Sammlungen | |
| 2015-08-06 | Upsert | |
| 2015-06-03 | Order By Support | |
| 2015-04-08 | Allgemeine Verfügbarkeit von DocumentDB (jetzt Teil von Azure Cosmos DB) | |
| 2014-08-21 | DocumentDB Public Preview (jetzt Teil von Azure Cosmos DB) | 29. Februar 2016 |
Cosmos DB-Ressourcen
In den folgenden Artikeln werden die unterstützten REST-APIs für jeden Ressourcentyp beschrieben. Allgemeine Informationen zum Ressourcenmodell finden Sie unter Ressourcenmodell und Cosmos DB-Ressourcen-URIs.
- Datenbanken
- Sammlungen
- Dokumente
- Attachments
- Gespeicherte Prozeduren
- Benutzerdefinierte Funktionen
- Trigger
- Benutzer
- Berechtigungen
- Angebote
Informationen zum Autorisieren von Anforderungen finden Sie unter Zugriffssteuerung . Allgemeine Informationen zu Anforderungs- und Antwortoptionen finden Sie in den folgenden Artikeln: