Compartilhar via


Azure Cosmos DB: Referência da API REST

O Azure Cosmos DB é um banco de dados multimodelo distribuído globalmente que dá suporte aos modelos de dados de documento, grafo e chave-valor. O conteúdo nesta seção destina-se à criação, consulta e gerenciamento de recursos de documento usando a API do SQL por meio do REST.

A API REST do Azure Cosmos DB fornece acesso programático aos recursos do Azure Cosmos DB para criar, consultar e excluir bancos de dados, coleções de documentos e documentos. Para executar operações em recursos do Azure Cosmos DB, envie solicitações HTTPS com um método com suporte: GET, POST, PUTou DELETE para um ponto de extremidade direcionado a uma coleção de recursos ou a um recurso específico. Esta seção explica como trabalhar com recursos usando a API REST.

Observação

Esses artigos de referência de API mostram como criar recursos usando a API do plano de dados do Azure Cosmos DB. Com a API do plano de dados, você pode configurar opções básicas, como a política de indexação, chaves de partição da mesma forma que você pode com os SDKs do Cosmos DB. Se você precisar de suporte completo a recursos para todos os recursos do Azure Cosmos DB, recomendamos usar o Provedor de Recursos do Cosmos DB. Os artigos de referência de API estão listados abaixo.

Versões da API REST com suporte

A tabela a seguir lista as versões da API REST com suporte pelo serviço do Azure Cosmos DB. A versão deve ser especificada por meio do x-ms-version cabeçalho em cada solicitação. A versão mais recente é usada quando o cabeçalho não é fornecido.

Versão Alteração introduzida Data de baixa
2018-12-31 Migração automática de coleções particionadas
2018-09-17 Composição e indexação espacial adicional
2018-08-31 Melhorias de dimensionamento de coleção dinâmica
2018-06-18 Compatibilidade com gravação em 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 coerente
2017-01-19 Taxa de transferência mínima reduzida 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 Ordem por suporte
2015-04-08 Disponibilidade geral do DocumentDB (agora parte do Azure Cosmos DB)
2014-08-21 Visualização pública do DocumentDB (agora parte do Azure Cosmos DB) 29 de fevereiro de 2016

Recursos do Cosmos DB

Os artigos a seguir descrevem as APIs REST com suporte para cada tipo de recurso. Para obter informações gerais sobre o modelo de recurso, consulte Modelo de recurso e URIs de recurso do Cosmos DB.

Confira Controle de acesso para saber como autorizar solicitações. Para obter informações gerais sobre as opções de solicitação e resposta, consulte os seguintes artigos:

Consulte Também