Azure Cosmos DB: справочник по REST API
Azure Cosmos DB — это глобально распределенная многомодедельная база данных, которая поддерживает модели данных документов, графов и "ключ—значение". Содержимое этого раздела предназначено для создания, запроса ресурсов документов и управления ими с помощью API SQL с помощью REST.
REST API Azure Cosmos DB обеспечивает программный доступ к ресурсам Azure Cosmos DB для создания, запроса и удаления баз данных, коллекций документов и документов. Для выполнения операций с ресурсами Azure Cosmos DB вы отправляете HTTPS-запросы с поддерживаемым методом: GET, POST, PUTили DELETE в конечную точку, предназначенную для коллекции ресурсов или определенного ресурса. В этом разделе объясняется, как работать с ресурсами с помощью REST API.
Примечание
В этих справочных статьях по API показано, как создавать ресурсы с помощью API плоскости данных Azure Cosmos DB. С помощью API плоскости данных можно настроить базовые параметры, такие как политика индексирования, ключи секций, так же, как в пакетах SDK для Cosmos DB. Если вам требуется полная поддержка функций для всех ресурсов Azure Cosmos DB, рекомендуется использовать поставщик ресурсов Cosmos DB. Справочные статьи по API приведены ниже.
Поддерживаемые версии REST API
В следующей таблице перечислены версии REST API, поддерживаемые службой Azure Cosmos DB. Версия должна быть указана с помощью заголовка x-ms-version в каждом запросе. Если заголовок не указан, используется последняя версия.
| Версия | Внесенные изменения | Дата вывода |
|---|---|---|
| 2018-12-31 | Автоматическая миграция секционированных коллекций | |
| 2018-09-17 | Составное и дополнительное пространственное индексирование | |
| 2018-08-31 | Улучшения динамического масштабирования коллекций | |
| 2018-06-18 | Поддержка для операций записи в нескольких регионах. | |
| 2017-11-15 | Строгие согласованности в нескольких регионах | |
| 2017-05-03 | Большой ключ секции | |
| 2017-02-22 | Постоянный префикс | |
| 2017-01-19 | Снижена минимальная пропускная способность для секционированных коллекций до 2500 ЕЗ/с. | |
| 2016-07-11 | Канал изменений | |
| 2015-12-16 | Секционированные коллекции | |
| 2015-08-06 | Upsert | |
| 2015-06-03 | Заказ по поддержке | |
| 2015-04-08 | Общая доступность DocumentDB (теперь является частью Azure Cosmos DB) | |
| 2014-08-21 | Общедоступная предварительная версия DocumentDB (теперь является частью Azure Cosmos DB) | 29 февраля 2016 г. |
Ресурсы Cosmos DB
В следующих статьях описаны поддерживаемые REST API для каждого типа ресурсов. Общие сведения о модели ресурсов см. в разделах Модель ресурсов и URI ресурсов Cosmos DB.
- Базы данных
- Коллекции
- Документы
- Вложения
- Хранимые процедуры
- Определенные пользователем функции
- Триггеры
- Пользователи
- Разрешения
- Предложения
Сведения об авторизации запросов см. в разделе Управление доступом . Общие сведения о параметрах запроса и ответа см. в следующих статьях: