Een database ophalen
Als u een databaseresource wilt ophalen, voert u een GET uit op de databaseresource.
Notitie
Deze API-referentieartikelen laten zien hoe u resources maakt met behulp van de Azure Cosmos DB-gegevensvlak-API. Met de gegevensvlak-API kunt u basisopties configureren, zoals indexeringsbeleid en partitiesleutels, net als met Cosmos DB SDK's. Als u volledige functieondersteuning nodig hebt voor alle Azure Cosmos DB-resources, raden we u aan de Cosmos DB-resourceprovider te gebruiken.
Aanvraag
| Methode | Aanvraag-URI | Beschrijving |
|---|---|---|
| GET | https://{databaseaccount}.documents.azure.com/dbs/{db-id} |
{databaseaccount} is de naam van het Azure Cosmos DB-account dat u hebt gemaakt onder uw abonnement. De waarde {db-id} is de door de gebruiker gegenereerde naam/id van de database, niet de door het systeem gegenereerde id (rid). |
Kopteksten
Zie Algemene Azure Cosmos DB REST-aanvraagheaders voor headers die worden gebruikt door alle Cosmos DB-aanvragen.
Hoofdtekst
Geen.
Antwoord
Kopteksten
Zie Algemene Azure Cosmos DB REST-antwoordheaders voor headers die worden geretourneerd door alle Cosmos DB-antwoorden.
Statuscodes
De volgende tabel bevat algemene statuscodes die door deze bewerking worden geretourneerd. Zie HTTP-statuscodes voor een volledige lijst met statuscodes.
| HTTP-statuscode | Beschrijving |
|---|---|
| 200 Ok | De bewerking is geslaagd. |
| 404 Niet gevonden | De database is geen resource meer, dat wil zeggen dat de resource is verwijderd. |
Hoofdtekst
| Eigenschap | Beschrijving |
|---|---|
| id | De unieke door de gebruiker gegenereerde naam voor de database. |
| _Ontdoen | Het is een door het systeem gegenereerde eigenschap. De resource-id (_rid) is een unieke id die ook hiërarchisch is per resourcestack in het resourcemodel. Het wordt intern gebruikt voor de plaatsing van en navigatie naar de databaseresource. |
| _Ts | Het is een door het systeem gegenereerde eigenschap. Het geeft het laatst bijgewerkte tijdstempel van de resource aan. De waarde is een tijdstempel. |
| _Zelf | Het is een door het systeem gegenereerde eigenschap. Dit is de unieke adresseerbare URI voor de resource. |
| _etag | Het is een door het systeem gegenereerde eigenschap die de resource-etag vertegenwoordigt die is vereist voor optimistisch gelijktijdigheidsbeheer. |
| _colls | Het is een door het systeem gegenereerde eigenschap die het adresseerbare pad van de verzamelingsresource aangeeft. |
| _Gebruikers | Het is een door het systeem gegenereerde eigenschap die het adresseerbare pad van de gebruikersresource aangeeft. |
{
"id": "volcanodb",
"_rid": "Sl8fAA==",
"_ts": 1448049502,
"_self": "dbs\/Sl8fAA==\/",
"_etag": "\"00000100-0000-0000-0000-564f7b5e0000\"",
"_colls": "colls\/",
"_users": "users\/"
}
Voorbeeld
GET https://contosomarketing.documents.azure.com/dbs/volcanodb HTTP/1.1
x-ms-date: Tue, 08 Dec 2015 19:41:22 GMT
authorization: type%3dmaster%26ver%3d1.0%26sig%3d0kZDPXylaMLpTI%2bxJYe7Xk5HiSv%2bX%2bpUGPKBMtY3My8%3d
Cache-Control: no-cache
User-Agent: contoso/1.0
x-ms-version: 2015-08-06
Accept: application/json
Host: contosomarketing.documents.azure.com
HTTP/1.1 200 Ok
Cache-Control: no-store, no-cache
Pragma: no-cache
Content-Type: application/json
Content-Location: https://contosomarketing.documents.azure.com/dbs/volcanodb
Server: Microsoft-HTTPAPI/2.0
Strict-Transport-Security: max-age=31536000
x-ms-last-state-change-utc: Sun, 29 Nov 2015 02:25:34.442 GMT
etag: "00000100-0000-0000-0000-564f7b5e0000"
x-ms-resource-quota: databases=100;
x-ms-resource-usage: databases=15;
x-ms-schemaversion: 1.1
x-ms-session-token: 860
x-ms-request-charge: 2
x-ms-serviceversion: version=1.5.57.3
x-ms-activity-id: d319e186-8e5f-4861-bcd0-59fb249769f3
x-ms-gatewayversion: version=1.5.57.3
Date: Tue, 08 Dec 2015 19:41:21 GMT
Content-Length: 168
{
"id": "volcanodb",
"_rid": "Sl8fAA==",
"_ts": 1448049502,
"_self": "dbs\/Sl8fAA==\/",
"_etag": "\"00000100-0000-0000-0000-564f7b5e0000\"",
"_colls": "colls\/",
"_users": "users\/"
}