Riferimento all'API REST di Azure Cosmos DB

  • Articolo

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 di Azure Cosmos DB consente l'accesso a livello di codice alle risorse di Azure Cosmos DB per creare, eseguire query ed eliminare database, raccolte documenti e documenti. Per eseguire operazioni sulle risorse di Azure Cosmos DB, 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 a quelle che è possibile usare con gli SDK di Cosmos DB. Se è necessario il supporto completo delle funzionalità per tutte le risorse di Azure Cosmos DB, è consigliabile usare il provider di risorse Cosmos DB. 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 delle 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 di Cosmos DB

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

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