Megosztás a következőn keresztül:

Adatbázis létrehozása

A Create Database művelet létrehoz egy új adatbázist az adatbázisfiókban.

Megjegyzés:

Ezek az API-referenciacikkek bemutatják, hogyan hozhat létre erőforrásokat az Azure Cosmos DB adatsík API-jával. Az adatsík API-val olyan alapvető beállításokat konfigurálhat, mint az indexelési szabályzat és a partíciókulcsok, hasonlóan a Cosmos DB szoftverfejlesztői készletekhez (SDK-khoz). Ha teljes körű funkciótámogatásra van szüksége az összes Azure Cosmos DB-erőforráshoz, javasoljuk a Cosmos DB erőforrás-szolgáltató használatát.

Kérelem

Metódus URI-kérés Leírás
poszt https://{databaseaccount}.documents.azure.com/dbs A {databaseaccount} az előfizetés alatt létrehozott Azure Cosmos DB-fiók neve.

Fejlécek

Az összes Azure Cosmos DB kérés által használt fejlécek gyakori Azure Cosmos DB REST-kérelemfejlécei című témakörben találhatók.

Ingatlan Kötelező Típus Leírás
x-ms-ajánlat-átviteli sebesség Opcionális Szám A felhasználó által megadott manuális átviteli sebesség (RU/s) az adatbázishoz másodpercenként 100 kérelemegységben kifejezve. A minimum 400 és 1 000 000 között van (vagy magasabb a korlát növelésével).

Csak az egyiket x-ms-offer-throughputx-ms-cosmos-offer-autopilot-settings kell megadni. Ezek a fejlécek nem adhatók meg együtt.
x-ms-cosmos-offer-autopilot-settings Opcionális JSON A felhasználó megadta az adatbázis automatikus skálázásának maximális RU/s-át. Az érték egy JSON a tulajdonsággal maxThroughput. Például: {"maxThroughput": 4000}.

Csak az egyiket x-ms-offer-throughputx-ms-cosmos-offer-autopilot-settings kell megadni. Ezek a fejlécek nem adhatók meg együtt.

Megjegyzés:

Ha átviteli sebességet állít be egy adatbázison, ez létrehoz egy megosztott átviteli sebességű adatbázist , amelyben a benne lévő összes gyűjtemény megosztja a kiépített átviteli sebességet. A megosztott átviteli sebességű adatbázisokban legfeljebb 25 tároló lehet. Ha nem tervez megosztott átviteli sebességű adatbázis használatát, hozzon létre egy adatbázist az átviteli sebesség fejléceinek beállítása nélkül. További információ.

Törzs

Ingatlan Kötelező Típus Leírás
azonosító Kötelező Lánc Az adatbázis felhasználó által létrehozott egyedi neve. Ez egy karakterlánc, amely nem lehet hosszabb 255 karakternél. 
{  
  "id": "volcanodb2"  
}

Válasz

Fejlécek

Az összes Azure Cosmos DB-válasz által visszaadott fejlécekhez lásd: Gyakori Azure Cosmos DB REST-válaszfejlécek .

Állapotkódok

Az alábbi táblázat a művelet által visszaadott gyakori állapotkódokat sorolja fel. Az állapotkódok teljes listáját lásd: HTTP-állapotkódok.

HTTP-állapotkód Leírás
201 Létrehozva A művelet sikeres végrehajtása esetén adja vissza.
400 Hibás kérés Akkor adja vissza, ha a JSON-törzs érvénytelen. Ellenőrizze, hogy nincsenek-e hiányzó kapcsos zárójelek vagy idézőjelek.
409 Ütközés Akkor adja vissza, ha az új adatbázishoz megadott azonosítót egy meglévő adatbázis vette át.

Törzs

Ingatlan Leírás
azonosító Az adatbázis felhasználó által létrehozott egyedi neve.
_megszabadít Ez egy rendszer által generált tulajdonság. Az erőforrás-azonosító (_rid) egy egyedi azonosító, amely szintén hierarchikus az erőforrásmodell erőforrásveremén. Belsőleg az adatbázis-erőforrás elhelyezésére és navigálására szolgál.
_ts Ez egy rendszer által generált tulajdonság. Az erőforrás utolsó frissített időbélyegét adja meg. Az érték időbélyeg.
_önmaga Ez egy rendszer által generált tulajdonság. Ez az erőforrás egyedi címezhető URI-ja.
_etag Ez egy rendszer által generált tulajdonság, amely meghatározza az optimista egyidejűség-vezérléshez szükséges erőforrás-címkét .
_colls Ez egy rendszer által generált tulajdonság, amely meghatározza a gyűjtemények erőforrásának címezhető elérési útját.
_Felhasználók Ez egy rendszer által generált tulajdonság, amely meghatározza a felhasználói erőforrás címezhető elérési útját. 
{  
    "id": "volcanodb2",  
    "_rid": "CqNBAA==",  
    "_ts": 1449602962,  
    "_self": "dbs\/CqNBAA==\/",  
    "_etag": "\"00000a00-0000-0000-0000-56672f920000\"",  
    "_colls": "colls\/",  
    "_users": "users\/"  
}

1. példa

Az alábbi példa létrehoz egy adatbázist.

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\/"  
}

2. példa

Az alábbi példa egy megosztott átviteli sebességű adatbázist hoz létre 400 RU/s manuális átviteli sebességgel. x-ms-offer-throughput fejléc az átviteli sebesség (RU/s) értékének beállítására szolgál. Legalább 400-as számot fogad el, amely 100-as egységgel növekszik.

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"}

3. példa

Az alábbi példa egy megosztott átviteli sebességű adatbázist hoz létre 4000 RU/s automatikus skálázási maximális átviteli sebességgel (400–4000 RU/s skálázással). x-ms-cosmos-offer-autopilot-settings fejléc a maxThroughput, amely az automatikus skálázás maximális RU/s értéke. Legalább 4000-es számot fogad el, amely 1000-es egységekkel növekszik.

Megjegyzés:

Ha engedélyezni szeretné az automatikus skálázást egy meglévő adatbázison vagy tárolón, vagy az automatikus skálázásról a manuális átviteli sebességre szeretne váltani, tekintse meg az Ajánlat cseréje című cikket.

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"}

Lásd még:

  • Last updated on