Azure Cosmos DB: REST API Başvurusu

  • Makale

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şturmaya, sorgulamaya ve yönetmeye yöneliktir.

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ında işlem gerçekleştirmek için desteklenen bir yöntemle HTTPS istekleri gönderirsiniz: GET, POST, PUTveya DELETE bir kaynak koleksiyonunu veya belirli bir kaynağı hedefleyen bir uç noktaya. Bu bölümde REST API kullanarak kaynaklarla çalışma açıklanmaktadır.

Not

Bu API başvuru makalelerinde Azure Cosmos DB veri düzlemi API'sini kullanarak kaynak oluşturma adımları gösterilmektedir. Veri düzlemi API'siyle dizin oluşturma ilkesi, bölüm anahtarları gibi cosmos DB SDK'ları gibi temel seçenekleri 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 en düşük aktarım hızı 2500 RU/sn'ye düşürüldu
2016-07-11 Değişiklik akışı
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

Cosmos DB Kaynakları

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.