Delen via


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

Zie ook