Ottenere un utente
Per recuperare una risorsa utente specifica in un database, eseguire un'operazione GET sull'utente.
Richiesta
| Metodo | URI richiesta | Descrizione |
|---|---|---|
| GET | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/users/{user-name} | Si noti che {databaseaccount} è il nome dell'account Azure Cosmos DB creato nella sottoscrizione. Il valore {db-id} è il nome/ID generato dall'utente del database, non l'ID generato dal sistema (rid). Il valore {user-name} è il nome dell'utente. |
Intestazioni
Vedere Intestazioni di richiesta REST di Azure Cosmos DB comuni per le intestazioni usate da tutte le richieste di Cosmos DB.
Corpo
Nessuno.
Risposta
Intestazioni
Vedere Intestazioni di risposta REST di Azure Cosmos DB comuni per le intestazioni restituite da tutte le risposte di Cosmos DB.
Codici di stato
La seguente tabella elenca i codici di stato comuni restituiti da questa operazione. Per un elenco completo dei codici di stato, vedere Codici di stato HTTP.
| Codice di stato HTTP | Descrizione |
|---|---|
| 200 - OK | L'operazione è stata completata. |
| 404 - Non trovato | L'utente non è più una risorsa, ovvero l'utente è stato eliminato. |
Corpo
| Proprietà | Descrizione |
|---|---|
| id | Nome univoco generato dall'utente per l'utente. |
| _rid | Si tratta di una proprietà generata dal sistema. L'ID risorsa (_rid) è un identificatore univoco che è anche gerarchico per ogni stack di risorse nel modello di risorsa. Viene usato internamente per il posizionamento e l'esplorazione della risorsa del'utente. |
| _Ts | Si tratta di una proprietà generata dal sistema. Indica il timestamp dell'ultimo aggiornamento della risorsa. Il valore è un timestamp. |
| _stesso | Si tratta di una proprietà generata dal sistema. URI indirizzabile univoco per la risorsa. |
| _Etag | Si tratta di una proprietà generata dal sistema che rappresenta l'etag della risorsa necessaria per il controllo di concorrenza ottimistica. |
| _Autorizzazioni | Si tratta di una proprietà generata dal sistema che specifica il percorso indirizzabile della risorsa autorizzazioni. |
{
"id": "a_user",
"_rid": "Sl8fAFEKCQA=",
"_ts": 1449603893,
"_self": "dbs\/Sl8fAA==\/users\/Sl8fAFEKCQA=\/",
"_etag": "\"00000b00-0000-0000-0000-566733350000\"",
"_permissions": "permissions\/"
}
Esempio
GET https://contosomarketing.documents.azure.com/dbs/volcanodb/users/a_user HTTP/1.1
x-ms-date: Tue, 08 Dec 2015 19:49:05 GMT
authorization: type%3dmaster%26ver%3d1.0%26sig%3deQXTD1sMkhhn9657uwqO72KCPRDnlQkk0emPfJh0biw%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/volcanodb/users/a_user
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
etag: "00000b00-0000-0000-0000-566733350000"
x-ms-resource-quota: users=500000;
x-ms-resource-usage: users=2;
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: 4b2e6bdd-6cc7-423e-b8b1-32781166e0b1
x-ms-gatewayversion: version=1.5.57.3
Date: Tue, 08 Dec 2015 19:49:05 GMT
Content-Length: 183
{
"id": "a_user",
"_rid": "Sl8fAFEKCQA=",
"_ts": 1449603893,
"_self": "dbs\/Sl8fAA==\/users\/Sl8fAFEKCQA=\/",
"_etag": "\"00000b00-0000-0000-0000-566733350000\"",
"_permissions": "permissions\/"
}