Lista databaser
Om du vill visa en lista över databaserna under databaskontot utför du en GET på databasresursen, d.v.s. dbs-URI-sökvägen.
Anteckning
Dessa API-referensartiklar visar hur du skapar resurser med azure Cosmos DB-dataplanets API. Med dataplanets API kan du konfigurera grundläggande alternativ, till exempel indexeringsprincip, partitionsnycklar ungefär som du kan med Cosmos DB SDK:er. Om du behöver fullständigt funktionsstöd för alla Azure Cosmos DB-resurser rekommenderar vi att du använder Cosmos DB-resursprovidern.
Förfrågan
| Metod | URI för förfrågan | Beskrivning |
|---|---|---|
| GET | https://{databaseaccount}.documents.azure.com/dbs |
{databaseaccount} är namnet på det Azure Cosmos DB-konto som skapats under din prenumeration. |
Sidhuvuden
Se Vanliga REST-begärandehuvuden för Azure Cosmos DB för rubriker som används av alla Cosmos DB-begäranden.
Brödtext
Inga.
Svarsåtgärder
Sidhuvuden
Se Vanliga AZURE Cosmos DB REST-svarshuvuden för rubriker som returneras av alla Cosmos DB-svar.
Statuskoder
I följande tabell visas vanliga statuskoder som returneras av den här åtgärden. En fullständig lista över statuskoder finns i HTTP-statuskoder.
| HTTP-statuskod | Beskrivning |
|---|---|
| 200 OK | Åtgärden har slutförts. |
Brödtext
| Egenskap | Beskrivning |
|---|---|
| _Bli | Det är en systemgenererad egenskap. Värdet _rid är tomt för den här åtgärden. |
| _Räkna | Den här egenskapen visar antalet databaser som returneras som en del av liståtgärden. |
| Databaser | Det här är matrisen som innehåller databaserna som returneras som en del av liståtgärden. Egenskaper för databasresursen |
| id | Det unika användargenererade namnet för databasen. |
| _Bli | Det är en systemgenererad egenskap. Resurs-ID :t (_rid) är en unik identifierare som också är hierarkisk per resursstacken i resursmodellen. Den används internt för placering av och navigering till databasresursen. |
| _Ts | Det är en systemgenererad egenskap. Den anger resursens senast uppdaterade tidsstämpel. Värdet är en tidsstämpel. |
| _Själv | Det är en systemgenererad egenskap. Det är den unika adresserbara URI:n för resursen. |
| _Etag | Det är en systemgenererad egenskap som representerar resursetaggen som krävs för optimistisk samtidighetskontroll. |
| _colls | Det är en systemgenererad egenskap som anger den adresserbara sökvägen för samlingsresursen. |
| _Användare | Det är en systemgenererad egenskap som anger den adresserbara sökvägen för användarresursen. |
{
"_rid": "",
"Databases": [{
"id": "iot2",
"_rid": "qicAAA==",
"_ts": 1446192371,
"_self": "dbs\/qicAAA==\/",
"_etag": "\"00001800-0000-0000-0000-563324f30000\"",
"_colls": "colls\/",
"_users": "users\/"
},
{
"id": "TestDB2",
"_rid": "KI0YAA==",
"_ts": 1446243863,
"_self": "dbs\/KI0YAA==\/",
"_etag": "\"00001f00-0000-0000-0000-5633ee170000\"",
"_colls": "colls\/",
"_users": "users\/"
},
{
"id": "FoodDB",
"_rid": "vdoeAA==",
"_ts": 1442511602,
"_self": "dbs\/vdoeAA==\/",
"_etag": "\"00000100-0000-0000-0000-55fafaf20000\"",
"_colls": "colls\/",
"_users": "users\/"
}],
"_count": 3
}
Exempel
GET https://contosomarketing.documents.azure.com/dbs HTTP/1.1
x-ms-date: Tue, 08 Dec 2015 19:33:17 GMT
x-ms-max-item-count: 3
authorization: type%3dmaster%26ver%3d1.0%26sig%3d8aZP3gx24rXdqshQ3f4EIfwiD%2bBFxmqypnVg9GQkpwU%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
Server: Microsoft-HTTPAPI/2.0
Strict-Transport-Security: max-age=31536000
x-ms-last-state-change-utc: Thu, 26 Nov 2015 06:37:26.906 GMT
x-ms-resource-quota: databases=100;collections=5000;users=500000;permissions=2000000;
x-ms-resource-usage: databases=15;collections=34;users=0;permissions=0;
x-ms-item-count: 3
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: 67b6b831-3516-46ed-a36e-6b34fb345a29
x-ms-continuation: vdoeAA==
x-ms-gatewayversion: version=1.5.57.3
Date: Tue, 08 Dec 2015 19:37:57 GMT
Content-Length: 533
{
"_rid": "",
"Databases": [{
"id": "iot2",
"_rid": "qicAAA==",
"_ts": 1446192371,
"_self": "dbs\/qicAAA==\/",
"_etag": "\"00001800-0000-0000-0000-563324f30000\"",
"_colls": "colls\/",
"_users": "users\/"
},
{
"id": "TestDB2",
"_rid": "KI0YAA==",
"_ts": 1446243863,
"_self": "dbs\/KI0YAA==\/",
"_etag": "\"00001f00-0000-0000-0000-5633ee170000\"",
"_colls": "colls\/",
"_users": "users\/"
},
{
"id": "FoodDB",
"_rid": "vdoeAA==",
"_ts": 1442511602,
"_self": "dbs\/vdoeAA==\/",
"_etag": "\"00000100-0000-0000-0000-55fafaf20000\"",
"_colls": "colls\/",
"_users": "users\/"
}],
"_count": 3
}