Create Database
L'operazione Create Database crea un nuovo database nell'account del database.
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 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.
Richiesta
| Metodo | URI richiesta | Descrizione |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/dbs |
{databaseaccount} è il nome dell'account Azure Cosmos DB creato nella sottoscrizione. |
Intestazioni
Vedere Intestazioni di richiesta REST di Azure Cosmos DB comuni per le intestazioni usate da tutte le richieste di Azure Cosmos DB.
| Proprietà | Obbligatoria | Tipo | Descrizione |
|---|---|---|---|
| x-ms-offer-throughput | Facoltativo | Number | L'utente ha specificato la velocità effettiva manuale (UR/s) per il database espresso in unità di 100 unità richiesta al secondo. Il minimo è pari a 400 fino a 1.000.000 (o superiore richiedendo un aumento del limite). È necessario specificare solo uno di x-ms-offer-throughput o x-ms-cosmos-offer-autopilot-settings . Queste intestazioni non possono essere specificate insieme. |
| x-ms-cosmos-offer-autopilot-settings | Facoltativo | JSON | L'utente ha specificato la scalabilità automatica max UR/s del database. Il valore è json con la proprietà maxThroughput. Ad esempio: {"maxThroughput": 4000}.È necessario specificare solo uno di x-ms-offer-throughput o x-ms-cosmos-offer-autopilot-settings . Queste intestazioni non possono essere specificate insieme. |
Nota
Se si imposta la velocità effettiva in un database, viene creato un database di velocità effettiva condivisa in cui tutte le raccolte all'interno condividono la velocità effettiva di cui è stato effettuato il provisioning. Esiste un limite di 25 contenitori in un database di velocità effettiva condivisa. Se non si prevede di usare un database di velocità effettiva condivisa, creare un database senza impostare le intestazioni di velocità effettiva precedenti. Altre informazioni
Corpo
| Proprietà | Obbligatoria | Tipo | Descrizione |
|---|---|---|---|
| id | Necessario | string | Nome univoco generato dall'utente per il database. Si tratta di una stringa che non deve essere superiore a 255 caratteri. |
{
"id": "volcanodb2"
}
Risposta
Intestazioni
Vedere Intestazioni di risposta REST di Azure Cosmos DB comuni per le intestazioni restituite da tutte le risposte di Azure Cosmos DB.
Codici di stato
La seguente tabella elenca i codici di stato comuni restituiti da questa operazione. Per un elenco completo dei codici di stato, vedere Codici di stato HTTP.
| Codice di stato HTTP | Descrizione |
|---|---|
| 201 Creato | Restituito quando l'operazione riesce. |
| 400 - Richiesta non valida | Restituito quando il corpo JSON non è valido. Controllare parentesi graffe o virgolette mancanti. |
| 409 - Conflitto | Restituito quando l'ID specificato per il nuovo database è stato acquisito da un database esistente. |
Corpo
| Proprietà | Descrizione |
|---|---|
| id | Nome univoco generato dall'utente per il database. |
| _rid | Si tratta di una proprietà generata dal sistema. L'ID risorsa (_rid) è un identificatore univoco che è anche gerarchico per ogni stack di risorse nel modello di risorsa. Viene usato internamente per il posizionamento e l'esplorazione della risorsa database. |
| _Ts | È una proprietà generata dal sistema. Indica il timestamp dell'ultimo aggiornamento della risorsa. Il valore è un timestamp. |
| _stesso | È una proprietà generata dal sistema. URI indirizzabile univoco per la risorsa. |
| _Etag | Si tratta di una proprietà generata dal sistema che specifica l'etag della risorsa necessaria per il controllo di concorrenza ottimistica. |
| _colls | Si tratta di una proprietà generata dal sistema che specifica il percorso indirizzabile della risorsa delle raccolte. |
| _Gli utenti | Si tratta di una proprietà generata dal sistema che specifica il percorso indirizzabile della risorsa utenti. |
{
"id": "volcanodb2",
"_rid": "CqNBAA==",
"_ts": 1449602962,
"_self": "dbs\/CqNBAA==\/",
"_etag": "\"00000a00-0000-0000-0000-56672f920000\"",
"_colls": "colls\/",
"_users": "users\/"
}
Esempio 1
Nell'esempio seguente viene creato un database.
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\/"
}
Esempio 2
Nell'esempio seguente viene creato un database con velocità effettiva condivisa con velocità effettiva manuale pari a 400 UR/s.
x-ms-offer-throughput intestazione viene usata per impostare il valore della velocità effettiva (UR/s). Accetta un numero con almeno 400 che incrementa per unità pari a 100.
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"}
Esempio 3
Nell'esempio seguente viene creato un database con velocità effettiva condivisa con velocità effettiva massima di scalabilità automatica pari a 4000 UR/s (scalabilità compresa tra 400 - 4000 UR/s).
x-ms-cosmos-offer-autopilot-settings intestazione viene usata per impostare maxThroughput, ovvero il valore massimo di UR/s di scalabilità automatica. Accetta un numero con almeno 4000 che incrementa per unità di 1000.
Nota
Per abilitare la scalabilità automatica in un database o un contenitore esistente o passare dalla scalabilità automatica alla velocità effettiva manuale, vedere l'articolo Sostituire un'offerta.
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"}