Získání databáze
Pokud chcete načíst prostředek databáze, proveďte u prostředku databáze get.
Poznámka
Tyto referenční články k rozhraní API ukazují, jak vytvářet prostředky pomocí rozhraní API roviny dat služby Azure Cosmos DB. Pomocí rozhraní API roviny dat můžete nakonfigurovat základní možnosti, jako jsou zásady indexování, klíče oddílů podobně jako u sad SDK služby Cosmos DB. Pokud potřebujete úplnou podporu funkcí pro všechny prostředky Azure Cosmos DB, doporučujeme použít poskytovatele prostředků Cosmos DB.
Žádost
Metoda | Identifikátor URI žádosti | Popis |
---|---|---|
GET | https://{databaseaccount}.documents.azure.com/dbs/{db-id} |
Všimněte si, že {databaseaccount} je název účtu služby Azure Cosmos DB, který jste vytvořili v rámci předplatného. Hodnota {db-id} je uživatelem vygenerované jméno nebo ID databáze, nikoli systémově vygenerované ID (rid). |
Hlavičky
Viz Běžné hlavičky požadavků REST služby Azure Cosmos DB pro hlavičky, které používají všechny požadavky služby Cosmos DB.
Text
Žádné
Odpověď
Hlavičky
Viz Běžné hlavičky odpovědi REST služby Azure Cosmos DB pro hlavičky, které jsou vráceny všemi odpověďmi služby Cosmos DB.
Stavové kódy
Následující tabulka uvádí běžné stavové kódy vrácené touto operací. Úplný seznam stavových kódů najdete v tématu Stavové kódy HTTP.
Stavový kód HTTP | Popis |
---|---|
200 Ok | Operace byla úspěšná. |
404 Nenalezeno | Databáze již není prostředkem, tj. prostředek byl odstraněn. |
Text
Vlastnost | Popis |
---|---|
id | Jedinečný název vygenerovaný uživatelem pro databázi. |
_Zbavit | Jedná se o systém vygenerovanou vlastnost. ID prostředku (_rid) je jedinečný identifikátor, který je také hierarchický podle zásobníku prostředků v modelu prostředků. Používá se interně k umístění prostředku databáze a navigaci v něm. |
_Ts | Jedná se o systém vygenerovanou vlastnost. Označuje poslední aktualizované časové razítko prostředku. Hodnota je časové razítko. |
_Vlastní | Jedná se o systém vygenerovanou vlastnost. Jedná se o jedinečný adresovatelný identifikátor URI prostředku. |
_Etag | Jedná se o systémově vygenerovanou vlastnost představující značku prostředku etag vyžadovanou pro řízení optimistické souběžnosti. |
_colls | Jedná se o systém vygenerovanou vlastnost, která určuje adresovatelnou cestu k prostředku kolekcí. |
_Uživatelé | Jedná se o systém vygenerovanou vlastnost, která určuje adresovatelnou cestu k prostředku uživatelů. |
{
"id": "volcanodb",
"_rid": "Sl8fAA==",
"_ts": 1448049502,
"_self": "dbs\/Sl8fAA==\/",
"_etag": "\"00000100-0000-0000-0000-564f7b5e0000\"",
"_colls": "colls\/",
"_users": "users\/"
}
Příklad
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\/"
}