Azure Cosmos DB: REST API Reference (Azure Cosmos DB: Referência da API REST)
O Azure Cosmos DB é uma base de dados com vários modelos distribuída globalmente que suporta os modelos de dados de documentos, gráficos e chave-valor. O conteúdo desta secção destina-se a criar, consultar e gerir recursos de documentos com a API SQL através do REST.
A API REST do Azure Cosmos DB fornece acesso programático aos recursos do Azure Cosmos DB para criar, consultar e eliminar bases de dados, coleções de documentos e documentos. Para efetuar operações em recursos do Azure Cosmos DB, envie pedidos HTTPS com um método suportado: GET, POST, PUTou DELETE para um ponto final que visa uma coleção de recursos ou um recurso específico. Esta secção explica como trabalhar com recursos com a API REST.
Nota
Estes artigos de referência da API mostram como criar recursos com a API do plano de dados do Azure Cosmos DB. Com a API do plano de dados, pode configurar opções básicas, como a política de indexação, chaves de partição tal como com os SDKs do Cosmos DB. Se precisar de suporte completo de funcionalidades para todos os recursos do Azure Cosmos DB, recomendamos que utilize o Fornecedor de Recursos do Cosmos DB. Os artigos de referência da API estão listados abaixo.
Versões da API REST suportadas
A tabela seguinte lista as versões da API REST suportadas pelo serviço Azure Cosmos DB. A versão tem de ser especificada através do x-ms-version cabeçalho em cada pedido. A versão mais recente é utilizada quando o cabeçalho não é fornecido.
| Versão | Alteração introduzida | Data de descontinuação |
|---|---|---|
| 2018-12-31 | Migração automática de coleções particionadas | |
| 2018-09-17 | Indexação espacial composta e adicional | |
| 2018-08-31 | Melhorias no dimensionamento da coleção dinâmica | |
| 2018-06-18 | Suporte de escrita de várias regiões | |
| 2017-11-15 | Consistência Forte de Várias Regiões | |
| 2017-05-03 | Chave de partição grande | |
| 2017-02-22 | Prefixo consistente | |
| 2017-01-19 | Débito mínimo reduzido para coleções particionadas para 2500 RU/s | |
| 2016-07-11 | Feed de alterações | |
| 2015-12-16 | Coleções particionadas | |
| 2015-08-06 | Upsert | |
| 2015-06-03 | Encomendar Por suporte | |
| 2015-04-08 | Disponibilidade geral do DocumentDB (agora parte do Azure Cosmos DB) | |
| 2014-08-21 | Pré-visualização pública do DocumentDB (agora parte do Azure Cosmos DB) | 29 de fevereiro de 2016 |
Recursos do Cosmos DB
Os artigos seguintes descrevem as APIs REST suportadas para cada tipo de recurso. Para obter informações gerais sobre o modelo de recursos, veja Modelo de recursos e URIs de recursos do Cosmos DB.
- Bases de dados
- Coleções
- Documentos
- Anexos
- Procedimentos Armazenados
- Funções Definidas pelo Utilizador
- Acionadores
- Utilizadores
- Permissões
- Ofertas
Veja Controlo de acesso para saber como autorizar pedidos. Para obter informações gerais sobre as opções de pedido e resposta, consulte os seguintes artigos: