Oprávnění seznamu
Pokud chcete vypsat prostředek oprávnění konkrétní databáze, proveďte operaci GET na cestě URI oprávnění, která uživateli vrátí seznam oprávnění. Všechny tokeny prostředků se znovu vytvoří pro příslušná oprávnění vrácená jako součást odpovědi. Nové tokeny mají výchozí dobu platnosti (jednu hodinu), pokud není přepsána.
Žádost
Metoda | Identifikátor URI žádosti | Popis |
---|---|---|
GET | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/users/{user-name}/permissions | Všimněte si, že {databaseaccount} je název účtu služby Azure Cosmos DB vytvořeného v rámci vašeho předplatného. Hodnota {db-id} je uživatelem vygenerované jméno nebo id databáze, nikoli id (RID) generované systémem. Hodnota {user-name} je jméno uživatele. |
Hlavičky
Projděte si běžné hlavičky požadavkůREST služby Azure Cosmos DB pro hlavičky, které používají všechny požadavky služby Azure Cosmos DB.
Text
Žádné
Odpověď
Hlavičky
Projděte si běžné hlavičky odpovědí služby Azure Cosmos DB pro hlavičky, které vrací všechny odpovědi služby Azure Cosmos DB.
Stavové kódy
Následující tabulka obsahuje seznam běžných stavových kódů vrácených touto operací. Úplný seznam stavových kódů najdete v tématu Stavové kódy HTTP.
Kód | Description |
---|---|
200 Ok | Operace byla úspěšná. |
Text
Vlastnost | Popis |
---|---|
_Zbavit | Toto je ID prostředku uživatele, který vlastní oprávnění. |
_Počet | Tato vlastnost zobrazuje počet uživatelů vrácených jako součást operace seznamu. |
Oprávnění | Jedná se o pole obsahující oprávnění vrácená jako součást operace seznamu. |
id | Uživatel vygeneroval jedinečný název oprávnění. |
permissionMode | Režim přístupu k prostředku pro uživatele: Vše nebo Číst. Vše poskytuje přístup ke čtení, zápisu a odstranění prostředku. Čtení omezuje uživatele na přístup ke čtení prostředku. |
Zdrojů | Úplná adresovatelná cesta prostředku přidruženého k oprávnění. Například dbs/volcanodb/colls/volcano1. |
_Zbavit | Toto je systémem generovaná vlastnost. ID prostředku (_rid) je jedinečný identifikátor, který je také hierarchický podle zásobníku prostředků v modelu prostředků. Používá se interně k umístění a navigaci do prostředku uživatele. |
_Ts | Toto je systémem generovaná vlastnost. Určuje časové razítko poslední aktualizace prostředku. Hodnota je časové razítko. |
_Vlastní | Toto je systémem generovaná vlastnost. Jedná se o jedinečný adresovatelný identifikátor URI prostředku. |
_Etag | Toto je systémem vygenerovaná vlastnost, která představuje etag prostředku vyžadovanou pro řízení optimistické souběžnosti. |
_Token | Toto je systémem vygenerovaný token prostředku pro konkrétní prostředek a uživatele. |
{
"_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
}
Příklad
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
}