Partager via

Créer une base de données

  • Article

L’opération Create Database crée une base de données dans le compte de base de données.

Notes

Ces articles de référence sur les API montrent comment créer des ressources à l’aide de l’API de plan de données Azure Cosmos DB. Avec l’API de plan de données, vous pouvez configurer des options de base telles que la stratégie d’indexation et les clés de partition, comme vous le pouvez avec les SDK Cosmos DB. Si vous avez besoin d’une prise en charge complète des fonctionnalités pour toutes les ressources Azure Cosmos DB, nous vous recommandons d’utiliser le fournisseur de ressources Cosmos DB.

Requête

Méthode URI de demande Description
POST https://{databaseaccount}.documents.azure.com/dbs Le {databaseaccount} est le nom du compte Azure Cosmos DB que vous avez créé dans le cadre de votre abonnement.

En-têtes

Consultez En-têtes de requête REST Azure Cosmos DB courants pour les en-têtes utilisés par toutes les requêtes Azure Cosmos DB.

Propriété Obligatoire Type Description
x-ms-offer-throughput Facultatif Number L’utilisateur a spécifié un débit manuel (RU/s) pour la base de données exprimée en unités de 100 unités de requête par seconde. Le minimum est de 400 à 1 000 000 (ou plus en demandant une augmentation de la limite).

Un seul de x-ms-offer-throughput ou x-ms-cosmos-offer-autopilot-settings doit être spécifié. Ces en-têtes ne peuvent pas être spécifiés ensemble.
x-ms-cosmos-offer-autopilot-settings Facultatif JSON L’utilisateur a spécifié la mise à l’échelle automatique du nombre maximal de RU/s de la base de données. La valeur est un JSON avec la propriété maxThroughput. Par exemple : {"maxThroughput": 4000}.

Un seul de x-ms-offer-throughput ou x-ms-cosmos-offer-autopilot-settings doit être spécifié. Ces en-têtes ne peuvent pas être spécifiés ensemble.

Notes

Si vous définissez le débit sur une base de données, cela crée une base de données de débit partagée où toutes les collections à l’intérieur partagent le débit provisionné. Il existe une limite de 25 conteneurs dans une base de données à débit partagé. Si vous ne prévoyez pas d’utiliser une base de données de débit partagé, créez une base de données sans définir les en-têtes de débit ci-dessus. Plus d’informations

body

Propriété Obligatoire Type Description
id Obligatoire String Nom unique généré par l’utilisateur pour la base de données. Il s’agit d’une chaîne qui ne doit pas comporter plus de 255 caractères. 
{  
  "id": "volcanodb2"  
}

response

En-têtes

Consultez En-têtes de réponse REST Azure Cosmos DB courants pour les en-têtes retournés par toutes les réponses Azure Cosmos DB.

Codes d’état

Le tableau suivant répertorie les codes d'état courants renvoyés par cette opération. Pour obtenir la liste complète des codes status, consultez Codes d’état HTTP.

Code d'état HTTP Description
201 Créé Renvoyé lorsque l'opération a réussi.
400 Demande incorrecte Renvoyé lorsque le corps JSON n'est pas valide. Vérifiez qu'il ne manque pas d'accolades ou de guillemets.
409 Conflit Retourné lorsque l’ID fourni pour la nouvelle base de données a été pris par une base de données existante.

body

Propriété Description
id Nom unique généré par l’utilisateur pour la base de données.
_Débarrasser Il s’agit d’une propriété générée par le système. L’ID de ressource (_rid) est un identificateur unique qui est également hiérarchique en fonction de la pile de ressources sur le modèle de ressource. Il est utilisé en interne pour le positionnement de la ressource de base de données et la navigation vers celle-ci.
_Ts Il s’agit d’une propriété générée par le système. Elle spécifie l'horodateur de la dernière mise à jour de la ressource. La valeur est un horodateur.
_self Il s’agit d’une propriété générée par le système. Il s'agit de l'URI adressable unique pour la ressource.
_Etag Il s’agit d’une propriété générée par le système qui spécifie l’etag de ressources requis pour le contrôle d’accès concurrentiel optimiste.
_colls Il s’agit d’une propriété générée par le système qui spécifie le chemin d’accès adressable de la ressource de collections.
_Utilisateurs Il s’agit d’une propriété générée par le système qui spécifie le chemin d’accès adressable de la ressource utilisateur. 
{  
    "id": "volcanodb2",  
    "_rid": "CqNBAA==",  
    "_ts": 1449602962,  
    "_self": "dbs\/CqNBAA==\/",  
    "_etag": "\"00000a00-0000-0000-0000-56672f920000\"",  
    "_colls": "colls\/",  
    "_users": "users\/"  
}

Exemple 1

L’exemple suivant crée une base de données.

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

Exemple 2

L’exemple suivant crée une base de données à débit partagé avec un débit manuel de 400 RU/s. x-ms-offer-throughput l’en-tête est utilisé pour définir la valeur de débit (RU/s). Il accepte un nombre avec un minimum de 400 qui incrémente par unités de 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"}

Exemple 3

L’exemple suivant crée une base de données de débit partagée avec un débit maximal de mise à l’échelle automatique de 4 000 RU/s (mise à l’échelle entre 400 et 4 000 RU/s). x-ms-cosmos-offer-autopilot-settings l’en-tête est utilisé pour définir la maxThroughputvaleur , qui est la valeur maximale ru/s de mise à l’échelle automatique. Il accepte un nombre avec un minimum de 4 000 qui incrémente par unités de 1 000.

Notes

Pour activer la mise à l’échelle automatique sur une base de données ou un conteneur existant, ou passer de la mise à l’échelle automatique au débit manuel, consultez l’article Remplacer une offre.

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

Voir aussi