Azure Cosmos DB: справочник по REST API

  • Статья
  • Чтение занимает 2 мин

База данных Azure Cosmos — это глобально распределенная база данных с несколькими моделями, которая поддерживает модели данных документов, графов и ключевых значений. Содержимое этого раздела предназначено для создания, запроса ресурсов документов и управления ими с помощью API SQL через REST.

REST API Azure Cosmos DB обеспечивает программный доступ к ресурсам Azure Cosmos DB для создания, запроса и удаления баз данных, коллекций документов и документов. Для выполнения операций с ресурсами базы данных Azure Cosmos вы отправляете HTTPS-запросы с поддерживаемым методом: GET, POSTPUTили DELETE в конечную точку, предназначенную для коллекции ресурсов или определенного ресурса. В этом разделе объясняется, как работать с ресурсами с помощью REST API.

Примечание

В этих справочных статьях по API показано, как создавать ресурсы с помощью API плоскости данных azure Cosmos DB. С помощью API плоскости данных можно настроить базовые параметры, такие как политика индексирования, ключи секций, как и с помощью пакетов SDK для баз данных Cosmos. Если требуется полная поддержка функций для всех ресурсов Базы данных Cosmos Azure, рекомендуется использовать поставщик ресурсов 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

В следующих статьях описываются поддерживаемые REST API для каждого типа ресурса. Общие сведения о модели ресурсов см. в статье "Модель ресурсов" и Cosmos URI ресурсов базы данных.

Сведения о том, как авторизовать запросы, см. в статье "Управление доступом ". Общие сведения о вариантах запроса и ответа см. в следующих статьях:

См. также