Liste des utilisateurs
Permet de renvoyer la liste des utilisateurs dans une base de données, en effectuant une opération GET sur la ressource d'utilisateurs d'une base de données particulière, c'est-à-dire le chemin d'accès par URI users.
Requête
| Méthode | URI de demande | Description |
|---|---|---|
| GET | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/users |
Le {databaseaccount} est le nom du compte Azure Cosmos DB créé sous votre abonnement. La valeur {db-id} est le nom/l’ID généré par l’utilisateur de la base de données, et non l’ID généré par le système (rid). |
En-têtes
Consultez En-têtes de requête REST Azure Cosmos DB courants pour les en-têtes utilisés par toutes les requêtes Cosmos DB.
Corps
Aucun.
response
En-têtes
Consultez En-têtes de réponse REST Azure Cosmos DB courants pour les en-têtes retournés par toutes les réponses Cosmos DB.
Codes d’état
Le tableau suivant répertorie les codes d'état courants renvoyés par cette opération. Pour obtenir la liste complète des codes status, consultez Codes d’état HTTP.
| Code d'état HTTP | Description |
|---|---|
| 200 Ok | L'opération a réussi. |
body
| Propriété | Description |
|---|---|
| _Débarrasser | Il s’agit de l’ID de ressource de la base de données dans laquelle les utilisateurs ont été créés. |
| _Compter | Cette propriété indique le nombre d'utilisateurs renvoyé dans le cadre de l'opération de liste. |
| Utilisateurs | Il s’agit du tableau contenant les utilisateurs retournés dans le cadre de l’opération de liste. Propriétés de la ressource d'utilisateur |
| id | Nom d'utilisateur unique généré par l'utilisateur. |
| _Débarrasser | Il s’agit d’une propriété générée par le système. L’ID de ressource (_rid) est un identificateur unique qui est également hiérarchique en fonction de la pile de ressources sur le modèle de ressource. Il est utilisé en interne pour le positionnement de la ressource utilisateur et la navigation vers celle-ci. |
| _Ts | Il s’agit d’une propriété générée par le système. Elle spécifie l'horodateur de la dernière mise à jour de la ressource. La valeur est un horodateur. |
| _self | Il s’agit d’une propriété générée par le système. Il s'agit de l'URI adressable unique pour la ressource. |
| _Etag | Il s’agit d’une propriété générée par le système qui représente l’etag de ressources requis pour le contrôle d’accès concurrentiel optimiste. |
| _Autorisations | Il s’agit d’une propriété générée par le système qui spécifie le chemin d’accès adressable de la ressource d’autorisations. |
{
"_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
}
Exemple
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
}