你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Azure Cosmos DB：REST API 参考
Azure Cosmos DB 是一个全球分布式多模型数据库，支持文档、图形和键值数据模型。 本部分中的内容用于通过 REST 使用 SQL API 创建、查询和管理文档资源。
Azure Cosmos DB REST API 提供对 Azure Cosmos DB 资源的编程访问权限，以创建、查询和删除数据库、文档集合和文档。 若要对 Azure Cosmos DB 资源执行操作，请使用受支持的方法（GETPOST、、 PUT或 DELETE ）将 HTTPS 请求发送到面向资源集合或特定资源的终结点。 本部分介绍如何使用 REST API 处理资源。
注意
这些 API 参考文章介绍如何使用 Azure Cosmos DB 数据平面 API 创建资源。 使用数据平面 API，可以配置基本选项，例如索引策略、分区键，就像使用 Cosmos DB SDK 一样。 如果需要对所有 Azure Cosmos DB 资源提供完整的功能支持，建议使用 Cosmos DB 资源提供程序。 下面列出了 API 参考文章。
支持的 REST API 版本
下表列出了 Azure Cosmos DB 服务支持的 REST API 版本。 版本必须通过 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 RU/秒 | |
| 2016-07-11 | 更改源 | |
| 2015-12-16 | 已分区集合 | |
| 2015-08-06 | Upsert | |
| 2015-06-03 | Order By support | |
| 2015-04-08 | DocumentDB 正式发布 (Azure Cosmos DB) | |
| 2014-08-21 | DocumentDB 公共预览版 (现在属于 Azure Cosmos DB) | 2016 年 2 月 29 日 |
Cosmos DB 资源
以下文章介绍了每种资源类型支持的 REST API。 有关资源模型的常规信息，请参阅 资源模型 和 Cosmos DB 资源 URI。
请参阅 访问控制 ，了解如何授权请求。 有关请求和响应选项的一般信息，请参阅以下文章：