Riferimento all'API REST di Azure Cosmos DB

Azure Cosmos DB è un database multimodello distribuito a livello globale che supporta i modelli di dati document, graph e key-value. Il contenuto di questa sezione riguarda la creazione, l'esecuzione di query e la gestione delle risorse documento tramite l'API SQL tramite REST.

L'API REST del database Cosmos di Azure fornisce l'accesso a livello di codice alle risorse del database Cosmos di Azure per creare, eseguire query ed eliminare database, raccolte documenti e documenti. Per eseguire operazioni sulle risorse del database Cosmos di Azure, inviare richieste HTTPS con un metodo supportato: GET, POST, PUTo DELETE a un endpoint destinato a una raccolta di risorse o a una risorsa specifica. Questa sezione illustra come usare le risorse usando l'API REST.

Nota

Questi articoli di riferimento sulle API illustrano come creare risorse usando l'API del piano dati di Azure Cosmos DB. Con l'API del piano dati è possibile configurare opzioni di base, ad esempio criteri di indicizzazione, chiavi di partizione molto simili alle Cosmos SDK del database. Se è necessario il supporto completo delle funzionalità per tutte le risorse del database di Azure Cosmos, è consigliabile usare il provider di risorse del database Cosmos. Gli articoli di riferimento sulle API sono elencati di seguito.

Versioni dell'API REST supportate

La tabella seguente elenca le versioni dell'API REST supportate dal servizio azure Cosmos DB. La versione deve essere specificata tramite l'intestazione x-ms-version in ogni richiesta. Quando l'intestazione non è specificata, si usa la versione più recente.

Versione Modifica introdotta Data di ritiro
2018-12-31 Migrazione automatica delle raccolte partizionate
2018-09-17 Indicizzazione spaziale composita e aggiuntiva
2018-08-31 Miglioramenti del ridimensionamento delle raccolte dinamiche
2018-06-18 Supporto per la scrittura in più aree
2017-11-15 Coerenza assoluta in più aree
2017-05-03 Chiave di partizione di grandi dimensioni
2017-02-22 Prefisso coerente
2017-01-19 Velocità effettiva minima ridotta per le raccolte partizionate a 2500 UR/sec
2016-07-11 Feed di modifiche
2015-12-16 Raccolte partizionate
2015-08-06 Upsert
2015-06-03 Supporto di Order By
08/04/2015 Disponibilità generale di DocumentDB (ora parte di Azure Cosmos DB)
2014-08-21 Anteprima pubblica di DocumentDB (ora parte di Azure Cosmos DB) 29 febbraio 2016

Risorse del database Cosmos

Gli articoli seguenti descrivono le API REST supportate per ogni tipo di risorsa. Per informazioni generali sul modello di risorse, vedere Modello di risorse e URI delle risorse del database Cosmos.

Per informazioni su come autorizzare le richieste, vedere Controllo di accesso . Per informazioni generali sulle opzioni di richiesta e risposta, vedere gli articoli seguenti:

Vedere anche