リスト権限
特定のデータベースのアクセス許可リソースを一覧表示するには、アクセス許可 URI パスに対して GET 操作を実行します。そうすると、ユーザーのアクセス許可の一覧が返されます。 応答の一部として返された個々のアクセス許可のリソース トークンがすべて再作成されます。 新しいトークンの有効期間は、オーバーライドされない限り、既定で 1 時間です。
Request
| Method | 要求 URI | 説明 |
|---|---|---|
| GET | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/users/{user-name}/permissions | {databaseaccount} は、サブスクリプションの下に作成された Azure Cosmos DB アカウントの名前であることに注意してください。 {db-id} 値は、システムによって生成された ID (rid) ではなく、データベースのユーザーによって生成された名前/ID です。 {user-name} 値はユーザーの名前です。 |
ヘッダー
すべての Azure Cosmos DB 要求 で使用されるヘッダーについては、「共通の Azure Cosmos DBREST 要求ヘッダー」を参照してください。
本文
なし。
[応答]
ヘッダー
すべての Azure Cosmos DB 応答 によって返されるヘッダーについては、「共通の Azure Cosmos DB 応答ヘッダー」を参照してください。
状態コード
次の表に、この操作で返される一般的なステータス コードを示します。 状態コードの完全な一覧については、「 HTTP 状態コード」を参照してください。
| コード | 説明 |
|---|---|
| 200 Ok | 操作に成功しました。 |
Body
| プロパティ | Description |
|---|---|
| _解消 | これは、アクセス許可を所有するユーザーのリソース ID です。 |
| _カウント | このプロパティは、一覧表示操作の一部として返されるユーザーの数を示します。 |
| アクセス許可 | これは一覧表示操作の一部として返されるアクセス許可を含む配列です。 |
| id | ユーザーによって生成されるアクセス許可の一意の名前。 |
| permissionMode | ユーザーのリソースのアクセス モード: すべて または 読み取り。 すべて によって、リソースへの読み取り、書き込み、削除のアクセスが提供されます。 Read は、リソースに対する読み取りアクセス権のみにユーザーを制限します。 |
| resource | アクセス許可に関連付けられたリソースのアクセス可能な完全パス。 たとえば、dbs/volcanodb/colls/volcano1 などです。 |
| _解消 | これは 、システムによって生成されるプロパティです。 リソース ID (_rid) は、リソース モデルのリソース スタックごとに階層化される一意識別子です。 ユーザー リソースの配置およびナビゲーションのために内部的に使用されます。 |
| _Ts | これは、システムによって生成されるプロパティです。 リソースの最終更新タイムスタンプを示します。 値は、タイムスタンプです。 |
| _自己 | これは、システムによって生成されるプロパティです。 リソースの一意のアドレス指定が可能な URI です。 |
| _Etag | これは、オプティミスティック コンカレンシー制御に必要なリソース etag を表すシステム生成プロパティです。 |
| _トークン | これは、特定のリソースとユーザー用にシステムによって生成されるリソース トークンです。 |
{
"_rid": "Sl8fAG8cXgA=",
"Permissions": [{
"id": "a_permission",
"permissionMode": "Read",
"resource": "dbs/volcanodb/colls/volcano1",
"_rid": "Sl8fAG8cXgBn6Ju2GqNsAA==",
"_ts": 1449604760,
"_self": "dbs\/Sl8fAA==\/users\/Sl8fAG8cXgA=\/permissions\/Sl8fAG8cXgBn6Ju2GqNsAA==\/",
"_etag": "\"00000e00-0000-0000-0000-566736980000\"",
"_token": "type=resource&ver=1&sig=lxKlPHeqlIx2\/J02rFs3jw==;20MwFhNUO9xNOuglK9gyL18Mt5xIhbN48pzSq6FaR\/7sKFtGd6GaxCooIoPP6rYxRHUeCabHOFkbIeT4ercXk\/F1FG70QkQTD9CxDqNJx3NImgZJWErK1NlEjxkpFDV5uslhpJ4Y3JBnc72\/vlmR95TibFS0rC\/cdND0uRvoOOWXZYvVAJFKEUKyy3GTlYOxY1nKT313ZCOSUQF7kldjo9DE3XEBf8cct1uNKMILImo=;"
}],
"_count": 1
}
例
GET https://contosomarketing.documents.azure.com/dbs/volcanodb/users/a_user/permissions HTTP/1.1
x-ms-date: Tue, 08 Dec 2015 20:01:24 GMT
authorization: type%3dmaster%26ver%3d1.0%26sig%3dIBouMlVA5x5WqHIydZ0OSYHRPAkwoliqqkAJCCeNhjw%3d
Cache-Control: no-cache
User-Agent: contoso/1.0
x-ms-version: 2015-08-06
x-ms-max-item-count: 3
Accept: application/json
Host: contosomarketing.documents.azure.com
Connection: Keep-Alive
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/users/a_user/permissions
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: permissions=2000000;
x-ms-resource-usage: permissions=1;
x-ms-item-count: 1
x-ms-schemaversion: 1.1
x-ms-alt-content-path: dbs/volcanodb/users/a_user
x-ms-content-path: Sl8fAG8cXgA=
x-ms-session-token: 866
x-ms-request-charge: 2
x-ms-serviceversion: version=1.5.57.3
x-ms-activity-id: fb0095e8-ab6b-4423-bd6f-7af9f6f6ff68
Set-Cookie: x-ms-session-token=866; Domain=contosomarketing.documents.azure.com; Path=/dbs/volcanodb/users/a_user
x-ms-gatewayversion: version=1.5.57.3
Date: Tue, 08 Dec 2015 20:01:58 GMT
Content-Length: 629
{
"_rid": "Sl8fAG8cXgA=",
"Permissions": [{
"id": "a_permission",
"permissionMode": "Read",
"resource": "dbs/volcanodb/colls/volcano1",
"_rid": "Sl8fAG8cXgBn6Ju2GqNsAA==",
"_ts": 1449604760,
"_self": "dbs\/Sl8fAA==\/users\/Sl8fAG8cXgA=\/permissions\/Sl8fAG8cXgBn6Ju2GqNsAA==\/",
"_etag": "\"00000e00-0000-0000-0000-566736980000\"",
"_token": "type=resource&ver=1&sig=lxKlPHeqlIx2\/J02rFs3jw==;20MwFhNUO9xNOuglK9gyL18Mt5xIhbN48pzSq6FaR\/7sKFtGd6GaxCooIoPP6rYxRHUeCabHOFkbIeT4ercXk\/F1FG70QkQTD9CxDqNJx3NImgZJWErK1NlEjxkpFDV5uslhpJ4Y3JBnc72\/vlmR95TibFS0rC\/cdND0uRvoOOWXZYvVAJFKEUKyy3GTlYOxY1nKT313ZCOSUQF7kldjo9DE3XEBf8cct1uNKMILImo=;"
}],
"_count": 1
}