Felhasználók listázása
Ha egy adatbázis felhasználóinak listáját szeretné visszaadni, get műveletet kell végrehajtania egy adott adatbázis felhasználói erőforrásán, azaz a felhasználók URI-útvonalán.
Kérés
| Metódus | Kérés URI-ja | Leírás |
|---|---|---|
| GET | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/users |
A(z) {databaseaccount} az előfizetése alatt létrehozott Azure Cosmos DB-fiók neve. A(z) {db-id} érték az adatbázis felhasználó által létrehozott neve/azonosítója, nem pedig a rendszer által létrehozott azonosító (rid). |
Fejlécek
Az összes Cosmos DB-kérés által használt fejlécekhez tekintse meg az Azure Cosmos DB REST-kérések gyakori fejléceit .
Törzs
Nincsenek.
Reagálás
Fejlécek
Az összes Cosmos DB-válasz által visszaadott fejléceket az Azure Cosmos DB REST-válaszfejlécei között tekintheti meg.
Állapotkódok
Az alábbi táblázat a művelet által visszaadott gyakori állapotkódokat sorolja fel. Az állapotkódok teljes listáját lásd: HTTP-állapotkódok.
| HTTP-állapotkód | Leírás |
|---|---|
| 200 OK | A művelet sikeres volt. |
Törzs
| Tulajdonság | Leírás |
|---|---|
| _Megszabadulni | Ez annak az adatbázisnak az erőforrás-azonosítója, amelyben a felhasználók létre lettek hozva. |
| _Számít | Ez a tulajdonság a listaművelet részeként visszaadott felhasználók számát jeleníti meg. |
| Felhasználók | Ez a listaművelet részeként visszaadott felhasználókat tartalmazó tömb. A felhasználói erőforrás tulajdonságai |
| id | A felhasználó egyedi felhasználó által létrehozott neve. |
| _Megszabadulni | Ez egy rendszer által létrehozott tulajdonság. Az erőforrás-azonosító (_rid) egy egyedi azonosító, amely szintén hierarchikus az erőforrásmodell erőforrás-vermében. Belsőleg használják a felhasználói erőforrás elhelyezéséhez és navigációhoz. |
| _Ts | Ez egy rendszer által létrehozott tulajdonság. Meghatározza az erőforrás utolsó frissített időbélyegét. Az érték egy időbélyeg. |
| _Önálló | Ez egy rendszer által létrehozott tulajdonság. Ez az erőforrás egyedi címezhető URI-ja. |
| _Etag | Ez egy rendszer által létrehozott tulajdonság, amely az optimista egyidejűség-vezérléshez szükséges erőforráscímkét jelöli. |
| _Engedélyek | Ez egy rendszer által létrehozott tulajdonság, amely meghatározza az engedélyerőforrás címzhető elérési útját. |
{
"_rid": "Sl8fAA==",
"Users": [{
"id": "a_user",
"_rid": "Sl8fAFEKCQA=",
"_ts": 1449603893,
"_self": "dbs\/Sl8fAA==\/users\/Sl8fAFEKCQA=\/",
"_etag": "\"00000b00-0000-0000-0000-566733350000\"",
"_permissions": "permissions\/"
}],
"_count": 1
}
Példa
GET https://contosomarketing.documents.azure.com/dbs/volcanodb/users HTTP/1.1
x-ms-date: Tue, 08 Dec 2015 19:47:28 GMT
authorization: type%3dmaster%26ver%3d1.0%26sig%3due2e%2fHxTsLU%2fEftrjRd176ku%2bKC5efuw8CHzy7B4%2bTc%3d
Cache-Control: no-cache
User-Agent: contoso/1.0
x-ms-version: 2015-08-06
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
Server: Microsoft-HTTPAPI/2.0
Strict-Transport-Security: max-age=31536000
x-ms-last-state-change-utc: Sun, 29 Nov 2015 02:25:34.442 GMT
x-ms-resource-quota: users=500000;
x-ms-resource-usage: users=2;
x-ms-item-count: 1
x-ms-schemaversion: 1.1
x-ms-alt-content-path: dbs/volcanodb
x-ms-content-path: Sl8fAA==
x-ms-session-token: 862
x-ms-request-charge: 2
x-ms-serviceversion: version=1.5.57.3
x-ms-activity-id: ed9bf479-65fe-48f6-923f-572920b57c21
x-ms-gatewayversion: version=1.5.57.3
Date: Tue, 08 Dec 2015 19:47:28 GMT
Content-Length: 224
{
"_rid": "Sl8fAA==",
"Users": [{
"id": "a_user",
"_rid": "Sl8fAFEKCQA=",
"_ts": 1449603893,
"_self": "dbs\/Sl8fAA==\/users\/Sl8fAFEKCQA=\/",
"_etag": "\"00000b00-0000-0000-0000-566733350000\"",
"_permissions": "permissions\/"
}],
"_count": 1
}