データベースの一覧表示
データベース アカウントの下にあるデータベースを一覧表示するには、データベース リソース (つまり、dbs URI パス) に対して GET を実行します。
注意
これらの API リファレンス記事では、Azure Cosmos DB データ プレーン API を使用してリソースを作成する方法について説明します。 データ プレーン API を使用すると、Cosmos DB SDK と同様に、インデックス作成ポリシー、パーティション キーなどの基本的なオプションを構成できます。 すべての Azure Cosmos DB リソースの完全な機能サポートが必要な場合は、 Cosmos DB リソース プロバイダーを使用することをお勧めします。
Request
| Method | 要求 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 状態コード | 説明 |
|---|---|
| 200 OK | 操作が成功しました。 |
Body
| プロパティ | 説明 |
|---|---|
| _解消 | これは、システムによって生成されるプロパティです。 この操作の_rid値は空です。 |
| _カウント | このプロパティは、一覧表示操作の一部として返されるデータベースの数を示します。 |
| データベース | これは一覧表示操作の一部として返されるデータベースを含む配列です。 データベース リソースのプロパティ |
| id | ユーザーによって生成されるデータベースの一意の名前。 |
| _解消 | これは、システムによって生成されるプロパティです。 リソース 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
}