Azure Cosmos DB: REST API Reference (Azure Cosmos DB: Referência da API REST)

  • Artigo

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.

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:

Consulte também