Azure Cosmos DB: REST API Başvurusu

Azure Cosmos DB, belge, grafik ve anahtar-değer veri modellerini destekleyen genel olarak dağıtılmış çok modelli bir veritabanıdır. Bu bölümdeki içerik, REST aracılığıyla SQL API'sini kullanarak belge kaynaklarını oluşturmak, sorgulamak ve yönetmek içindir.

Azure Cosmos DB REST API'si veritabanlarını, belge koleksiyonlarını ve belgeleri oluşturmak, sorgulamak ve silmek için Azure Cosmos DB kaynaklarına programlı erişim sağlar. Azure Cosmos DB kaynakları üzerinde işlem gerçekleştirmek için desteklenen bir yöntemle HTTPS istekleri gönderirsiniz: GET, POST, PUTveya bir kaynak koleksiyonunu veya DELETE belirli bir kaynağı hedefleyen bir uç noktaya. Bu bölümde, REST API'yi kullanarak kaynaklarla çalışma açıklanmaktadır.

Not

Bu API başvuru makaleleri, Azure Cosmos DB veri düzlemi API'sini kullanarak kaynak oluşturmayı gösterir. Veri düzlemi API'siyle dizin oluşturma ilkesi, bölüm anahtarları gibi temel seçenekleri Cosmos DB SDK'larıyla yapılandırabilirsiniz. Tüm Azure Cosmos DB kaynakları için tam özellik desteğine ihtiyacınız varsa Cosmos DB Kaynak Sağlayıcısı'nı kullanmanızı öneririz. API başvuru makaleleri aşağıda listelenmiştir.

Desteklenen REST API Sürümleri

Aşağıdaki tabloda Azure Cosmos DB hizmeti tarafından desteklenen REST API sürümleri listelenmiştir. Sürüm her istekte x-ms-version üst bilgi aracılığıyla belirtilmelidir. Üst bilgi sağlanmadığında en son sürüm kullanılır.

Sürüm Değişiklik kullanıma sunulmuştur Kullanımdan kaldırma tarihi
2018-12-31 Bölümlenmiş koleksiyonlar otomatik geçişi
2018-09-17 Bileşik ve ek uzamsal dizin oluşturma
2018-08-31 Dinamik koleksiyon ölçeklendirme geliştirmeleri
2018-06-18 Çok bölgeli yazma desteği
2017-11-15 Çok bölgeli Güçlü Tutarlılık
2017-05-03 Büyük bölüm anahtarı
2017-02-22 Tutarlı ön ek
2017-01-19 Bölümlenmiş koleksiyonlar için minimum aktarım hızı 2500 RU/sn'ye düşürüld
2016-07-11 Akışı değiştir
2015-12-16 Bölümlenmiş koleksiyonlar
2015-08-06 Upsert
2015-06-03 Order By desteği
2015-04-08 DocumentDB genel kullanılabilirliği (artık Azure Cosmos DB'nin bir parçası)
2014-08-21 DocumentDB genel önizlemesi (artık Azure Cosmos DB'nin bir parçası) 29 Şubat 2016

veritabanı kaynaklarını Cosmos

Aşağıdaki makalelerde her kaynak türü için desteklenen REST API'ler açıklanmaktadır. Kaynak modeli hakkında genel bilgi için bkz. Kaynak modeli ve Cosmos DB kaynak URI'leri.

İstekleri yetkilendirmek için bkz. Erişim denetimi . İstek ve yanıt seçenekleri hakkında genel bilgi için aşağıdaki makalelere bakın:

Ayrıca Bkz.