Разрешения списка
Чтобы получить список ресурсов разрешений определенной базы данных, выполните операцию GET над путем к универсальному коду ресурса разрешений, которая возвращает список разрешений для пользователя. Все маркеры ресурсов повторно создаются для соответствующих возвращенных разрешений в качестве части ответа. У новых маркеров используется срок действия по умолчанию (один час) до тех пор, пока он не будет переопределен.
Запрос
| Метод | Универсальный код ресурса (URI) запроса | Описание |
|---|---|---|
| GET | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/users/{имя_пользователя}/permissions | Обратите внимание, что {databaseaccount} — это имя учетной записи Azure Cosmos DB, созданной в рамках вашей подписки. Значение {db-id} — это созданное пользователем имя/идентификатор базы данных, а не системный идентификатор (rid). Значение {user-name} — это имя пользователя. |
Заголовки
Заголовки, используемые всеми запросами Azure Cosmos DB, см. в статье Общие заголовки запросов DBREST Azure Cosmos DB.
Текст
Нет.
Ответ
Заголовки
Заголовки, возвращаемые всеми ответами Azure Cosmos DB, см. в статье Общие заголовки ответов Azure Cosmos DB.
Коды состояния
В таблице ниже указаны стандартные коды состояния, возвращаемые этой операцией. Полный список кодов состояния см. в разделе Коды состояния HTTP.
| Код | Описание |
|---|---|
| 200 (ОК) | Операция выполнена успешно. |
Текст
| Свойство | Описание |
|---|---|
| _Избавить | Это идентификатор ресурса пользователя, у которого есть эти разрешения. |
| _Рассчитывать | Это свойство показывает число пользователей, возвращаемых как часть операции вывода списка. |
| Разрешения | Это массив, содержащий разрешения, возвращаемые как часть операции вывода списка. |
| идентификатор | Пользователь создает уникальное имя для разрешения. |
| permissionMode | Режим доступа к ресурсу для пользователя: Все или Чтение. Все предоставляет доступ на чтение, запись и удаление к ресурсу. Режим Read ограничивает право доступа на чтение для ресурса. |
| resource | Полный адресуемый путь к ресурсу, который связан с разрешением. Например, dbs/volcanodb/colls/volcano1. |
| _rid | Это свойство, созданное системой. Идентификатор ресурса (_rid) — это уникальный идентификатор, который также является иерархическим для стека ресурсов в модели ресурсов. Он используется системой для размещения и перемещения к ресурсу пользователя. |
| _Ts | Это системное свойство. Оно представляет метку времени последнего обновления ресурса. Значение — метка времени. |
| _Самостоятельно | Это системное свойство. Это уникальный адресуемый URI для ресурса. |
| _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
}