Abrufen einer Datenbank

  • Artikel

Um eine Datenbankressource abzurufen, führen Sie einen GET für die Datenbankressource durch.

Hinweis

In diesen API-Referenzartikeln wird gezeigt, wie Ressourcen mithilfe der Azure Cosmos DB-Datenebenen-API erstellt werden. Mit der Datenebenen-API können Sie grundlegende Optionen wie Indizierungsrichtlinie und Partitionsschlüssel wie bei Cosmos DB SDKs konfigurieren. Wenn Sie vollständige Featureunterstützung für alle Azure Cosmos DB-Ressourcen benötigen, empfiehlt es sich, den Cosmos DB-Ressourcenanbieter zu verwenden.

Anforderung

Methode Anforderungs-URI BESCHREIBUNG
GET https://{databaseaccount}.documents.azure.com/dbs/{db-id} Beachten Sie, dass {databaseaccount} der Name des Azure Cosmos DB-Kontos ist, das Sie unter Ihrem Abonnement erstellt haben. Der Wert {db-id} ist der vom Benutzer generierte Name/die ID der Datenbank, nicht die vom System generierte ID (rid).

Header

Informationen zu Headern, die von allen Cosmos DB-Anforderungen verwendet werden, finden Sie unter Allgemeine Azure Cosmos DB-REST-Anforderungsheader .

Text

Keine.

Antwort

Header

Informationen zu Headern, die von allen Cosmos DB-Antworten zurückgegeben werden, finden Sie unter Allgemeine Azure Cosmos DB-REST-Antwortheader .

Statuscodes

In der folgenden Tabelle sind die allgemeinen Statuscodes aufgeführt, die von diesem Vorgang zurückgegeben werden. Eine vollständige Liste der status Codes finden Sie unter HTTP-Statuscodes.

HTTP-Statuscode BESCHREIBUNG
200 Ok Der Vorgang wurde durchgeführt.
404 – Nicht gefunden Die Datenbank stellt keine Ressource mehr dar, d. h., dass die Ressource gelöscht wurde.

Body

Eigenschaft BESCHREIBUNG
id Der eindeutige, vom Benutzer generierte Name für die Datenbank.
_los Es handelt sich um eine vom System generierte Eigenschaft. Die Ressourcen-ID (_rid) ist ein eindeutiger Bezeichner, der auch pro Ressourcenstapel im Ressourcenmodell hierarchisch ist. Sie wird intern für die Platzierung der Dokumentressource und Navigation zu dieser verwendet.
_Ts Es handelt sich um eine vom System generierte Eigenschaft. Sie gibt den zuletzt aktualisierten Zeitstempel der Ressource an. Der Wert ist ein Zeitstempel.
_Selbst Es handelt sich um eine vom System generierte Eigenschaft. Es handelt sich um den eindeutigen, adressierbaren URI für die Ressource.
_Etag Es handelt sich um eine vom System generierte Eigenschaft, die das Ressourcen-Etag darstellt, das für die Steuerung der optimistischen Parallelität erforderlich ist.
_colls Es handelt sich um eine vom System generierte Eigenschaft, die den adressierbaren Pfad der Auflistungsressource angibt.
_Benutzer Es handelt sich um eine vom System generierte Eigenschaft, die den adressierbaren Pfad der Benutzerressource angibt. 
{  
    "id": "volcanodb",  
    "_rid": "Sl8fAA==",  
    "_ts": 1448049502,  
    "_self": "dbs\/Sl8fAA==\/",  
    "_etag": "\"00000100-0000-0000-0000-564f7b5e0000\"",  
    "_colls": "colls\/",  
    "_users": "users\/"  
}

Beispiel

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

Weitere Informationen