若要列出資料庫帳戶下的資料庫,請在資料庫資源上執行 GET,也就是 dbs URI 路徑。
注意
這些 API 參考文章示範如何使用 Azure Cosmos DB 資料平面 API 建立資源。 透過資料平面 API,您可以設定基本選項,例如編制索引原則,資料分割索引鍵就像使用 Cosmos DB SDK 一樣。 如果您需要所有 Azure Cosmos DB 資源的完整功能支援,建議您使用 Cosmos DB 資源提供者。
要求
| 方法 | 要求 URI | 描述 |
|---|---|---|
| GET | https://{databaseaccount}.documents.azure.com/dbs |
{databaseaccount} 是您訂用帳戶下建立的 Azure Cosmos DB 帳戶名稱。 |
標題
如需所有 Cosmos DB 要求所使用的標頭,請參閱常見的 Azure Cosmos DB REST 要求標頭 。
主體
無。
回應
標題
如需所有 Cosmos DB 回應所傳回的標頭,請參閱 常見的 Azure Cosmos DB REST 回應標頭 。
狀態碼
下表列出此作業所傳回的常見狀態碼。 如需狀態碼的完整清單,請參閱 HTTP 狀態碼。
| HTTP 狀態碼 | Description |
|---|---|
| 200 確定 | 作業成功。 |
主體
| 屬性 | Description |
|---|---|
| _擺脫 | 它是 系統產生的屬性。 此作業 _rid 值是空的。 |
| _計數 | 此屬性會顯示在清單作業中傳回的資料庫數目。 |
| 資料庫 | 這是一個陣列,包含在清單作業中傳回的資料庫。 資料庫資源的屬性 |
| id | 使用者為資料庫產生的唯一名稱。 |
| _擺脫 | 它是系統產生的屬性。 資源識別碼 (_rid) 是資源模型上每個資源堆疊的階層式唯一識別碼。 在內部用來放置和導覽資料庫資源。 |
| _Ts | 它是系統產生的屬性。 代表資源的上次更新時間戳記。 值為時間戳記。 |
| _自我 | 它是系統產生的屬性。 代表資源的唯一可定址 URI。 |
| _Etag | 這是系統產生的屬性,代表開放式並行控制所需的資源 etag 。 |
| _colls | 它是系統產生的屬性,指定集合資源的可定址路徑。 |
| _使用者 | 它是系統產生的屬性,指定使用者資源的可定址路徑。 |
{
"_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
}
範例
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
}