Aracılığıyla paylaş

Veritabanı Oluştur

İşlem Create Database , veritabanı hesabında yeni bir veritabanı oluşturur.

Uyarı

Bu API başvuru makalelerinde, Azure Cosmos DB veri düzlemi API'sini kullanarak kaynak oluşturma işlemi gösterilmektedir. Veri düzlemi API'si ile dizin oluşturma ilkesi, bölüm anahtarları gibi temel seçenekleri Cosmos DB yazılım geliştirme setlerinde (SDK) olduğu gibi 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.

İstek

Yöntem İstenilen URI Açıklama
PAYLAŞ https://{databaseaccount}.documents.azure.com/dbs {databaseaccount}, aboneliğiniz altında oluşturduğunuz Azure Cosmos DB hesabının adıdır.

Başlıklar

Tüm Azure Cosmos DB istekleri tarafından kullanılan üst bilgiler için Ortak Azure Cosmos DB REST istek üst bilgilerine bakın.

Mülkiyet Gerekli Türü Açıklama
x-ms-teklif-aktarım hızı Opsiyonel Sayı Veritabanı için kullanıcı tarafından belirtilen el ile aktarım hızı (RU/sn), saniyede 100 istek birimi birimi olarak ifade edilir. Minimum tutar 400'den 1.000.000'a kadardır (veya limit artışı talep ederek daha yüksek).

Şunlardan x-ms-offer-throughput yalnızca biri veya x-ms-cosmos-offer-autopilot-settings belirtilmelidir. Bu üst bilgiler birlikte belirtilemez.
x-ms-cosmos-teklif-otopilot-ayarları Opsiyonel JSON veri formatı Kullanıcı, veritabanının en fazla RU/sn'sini otomatik ölçeklendirme olarak belirtti. Değer, özelliğine maxThroughputsahip bir JSON'dur. Örneğin: {"maxThroughput": 4000}.

Şunlardan x-ms-offer-throughput yalnızca biri veya x-ms-cosmos-offer-autopilot-settings belirtilmelidir. Bu üst bilgiler birlikte belirtilemez.

Uyarı

Bir veritabanında aktarım hızını ayarlarsanız, bu, içindeki tüm koleksiyonların sağlanan aktarım hızını paylaştığı paylaşılan bir aktarım hızı veritabanı oluşturur. Paylaşılan aktarım hızı veritabanında 25 kapsayıcı sınırı vardır. Paylaşılan bir aktarım hızı veritabanı kullanmayı planlamıyorsanız, aktarım hızı üst bilgilerini ayarlamadan bir veritabanı oluşturun. Daha fazla bilgi edinin.

Vücut

Mülkiyet Gerekli Türü Açıklama
kimlik Gerekli Dize Veritabanı için kullanıcı tarafından oluşturulan benzersiz ad. 255 karakterden fazla olmaması gereken bir dizedir. 
{  
  "id": "volcanodb2"  
}

Yanıt

Başlıklar

Tüm Azure Cosmos DB yanıtları tarafından döndürülen üst bilgiler için Ortak Azure Cosmos DB REST yanıt üst bilgilerine bakın.

Durum kodları

Aşağıdaki tabloda, bu işlem tarafından döndürülen ortak durum kodları listelenmektedir. Durum kodlarının tam listesi için HTTP Durum Kodları bölümüne bakın.

HTTP durum kodu Açıklama
201 Oluşturuldu İşlem başarılı olduğunda geri döner.
400 Hatalı İstek JSON gövdesi geçersiz olduğunda döndürülür. Eksik küme ayraçlarını veya tırnak işaretlerini denetleyin.
409 Çakışma Yeni veritabanı için sağlanan kimlik mevcut bir veritabanı tarafından alındığında döndürülür.

Vücut

Mülkiyet Açıklama
ID Veritabanı için kullanıcı tarafından oluşturulan benzersiz ad.
_Kurtulmak Sistem tarafından oluşturulan bir özelliktir. Kaynak kimliği (_rid), kaynak modelinde kaynak yığını başına da hiyerarşik olan benzersiz bir tanımlayıcıdır. Veritabanı kaynağının yerleştirilmesi ve bu kaynağa gezinme için dahili olarak kullanılır.
_Ts Sistem tarafından oluşturulan bir özelliktir. Kaynağın son güncelleştirilmiş zaman damgasını belirtir. Değer bir zaman damgasıdır.
_kendi Sistem tarafından oluşturulan bir özelliktir. Kaynak için benzersiz adreslenebilir URI'dir.
_etag İyimser eşzamanlılık denetimi için gereken kaynak etiketini belirten sistem tarafından oluşturulan bir özelliktir.
_colls Koleksiyon kaynağının adreslenebilir yolunu belirten, sistem tarafından oluşturulan bir özelliktir.
_Kullanıcı Kullanıcı kaynağının adreslenebilir yolunu belirten sistem tarafından oluşturulan bir özelliktir. 
{  
    "id": "volcanodb2",  
    "_rid": "CqNBAA==",  
    "_ts": 1449602962,  
    "_self": "dbs\/CqNBAA==\/",  
    "_etag": "\"00000a00-0000-0000-0000-56672f920000\"",  
    "_colls": "colls\/",  
    "_users": "users\/"  
}

Örnek 1

Aşağıdaki örnek bir veritabanı oluşturur.

POST https://contosomarketing.documents.azure.com/dbs HTTP/1.1  
x-ms.date: 04/20/2021
authorization: type%3dmaster%26ver%3d1.0%26sig%3dsc0%2fu25RB8wSqbY1%2bUZqTGD0yCQC5KkGOAP%2bgnHFceQ%3d  
Cache-Control: no-cache  
User-Agent: contoso/1.0  
x-ms-version: 2015-08-06  
Accept: application/json  
Host: contosomarketing.documents.azure.com  
Content-Length: 19  
Expect: 100-continue  
  
{"id":"volcanodb2"}  
  

HTTP/1.1 201 Created  
Cache-Control: no-store, no-cache  
Pragma: no-cache  
Content-Type: application/json  
Server: Microsoft-HTTPAPI/2.0  
Strict-Transport-Security: max-age=31536000  
x-ms-last-state-change-utc: Sun, 29 Nov 2015 02:25:35.212 GMT  
etag: "00000a00-0000-0000-0000-56672f920000"  
x-ms-resource-quota: databases=100;  
x-ms-resource-usage: databases=15;  
x-ms-schemaversion: 1.1  
x-ms-quorum-acked-lsn: 859  
x-ms-session-token: 860  
x-ms-current-write-quorum: 3  
x-ms-current-replica-set-size: 4  
x-ms-request-charge: 4.95  
x-ms-serviceversion: version=1.5.57.3  
x-ms-activity-id: f171e571-994e-4dc2-b443-7c3d5fa4a293  
x-ms-gatewayversion: version=1.5.57.3  
Date: Tue, 08 Dec 2015 19:29:21 GMT  
Content-Length: 169  
  
{  
    "id": "volcanodb2",  
    "_rid": "CqNBAA==",  
    "_ts": 1449602962,  
    "_self": "dbs\/CqNBAA==\/",  
    "_etag": "\"00000a00-0000-0000-0000-56672f920000\"",  
    "_colls": "colls\/",  
    "_users": "users\/"  
}

Örnek 2

Aşağıdaki örnek, el ile 400 RU/sn aktarım hızına sahip paylaşılan bir aktarım hızı veritabanı oluşturur. x-ms-offer-throughput üst bilgi, aktarım hızı (RU/sn) değerini ayarlamak için kullanılır. En az 400 olan ve 100'lük birimlerle artan bir sayıyı kabul eder.

POST https://contosomarketing.documents.azure.com/dbs HTTP/1.1  
x-ms-date: Tue, 08 Dec 2015 19:29:22 GMT  
authorization: type%3dmaster%26ver%3d1.0%26sig%3dsc0%2fu25RB8wSqbY1%2bUZqTGD0yCQC5KkGOAP%2bgnHFceQ%3d  
Cache-Control: no-cache  
User-Agent: contoso/1.0  
x-ms-version: 2015-08-06  
Accept: application/json  
x-ms-offer-throughput = 400
Host: contosomarketing.documents.azure.com  
Content-Length: 19  
Expect: 100-continue  
  
{"id":"volcanodb2"}

Örnek 3

Aşağıdaki örnek, 4000 RU/sn otomatik ölçeklendirme maksimum aktarım hızına sahip paylaşılan bir aktarım hızı veritabanı oluşturur (400 - 4000 RU/sn arasında ölçeklendirilir). x-ms-cosmos-offer-autopilot-settings üst bilgisi, otomatik ölçeklendirme maksimum RU/sn değeri olan ayarlamak için maxThroughputkullanılır. En az 4000 olan ve 1000'lik birimlerle artan bir sayıyı kabul eder.

Uyarı

Mevcut bir veritabanında veya kapsayıcıda otomatik ölçeklendirmeyi etkinleştirmek ya da otomatik ölçeklendirmeden el ile aktarım hızına geçmek için Teklifi Değiştirme makalesine bakın.

POST https://contosomarketing.documents.azure.com:443/dbs HTTP/1.1 
x-ms-version: 2018-12-31
x-ms-date: Wed, 22 Jul 2020 20:09:50 GMT
authorization: type%3dmaster%26ver%3d1.0%26sig%3dsc0%2fu25RB8wSqbY1%2bUZqTGD0yCQC5KkGOAP%2bgnHFceQ%3d 
Accept: application/json
x-ms-cosmos-offer-autopilot-settings: {"maxThroughput": 4000}
Content-Type: application/json
User-Agent: contoso/1.0
Postman-Token: 81c0a4ac-4b7c-4f98-8d46-8c662969bc7e
Host: contosomarketing.documents.azure.com:443
Accept-Encoding: gzip, deflate, br
Connection: keep-alive
Content-Length: 27

{"id":"volcanodb3"}

Ayrıca Bkz.

  • Azure Cosmos DB
  • Azure Cosmos DB SQL API
  • Azure Cosmos DB SQL API SDK'larını
  • .NET Örnek REST
  • Last updated on