你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
列出用户
要返回数据库中的用户列表,可对特定数据库的用户资源(即用户 URI 路径)执行 GET 操作。
方法 | 请求 URI | 说明 |
---|---|---|
GET | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/users |
{databaseaccount} 是在订阅下创建的 Azure Cosmos DB 帐户的名称。 {db-id} 值是用户生成的数据库名称/ID,而不是系统生成的 ID (rid) 。 |
有关所有 Cosmos DB 请求 使用的标头,请参阅常见的 Azure Cosmos DB REST 请求标头。
无。
有关所有 Cosmos DB 响应 返回的标头,请参阅常见的 Azure Cosmos DB REST 响应标头。
下表列出了此操作返回的常见状态代码。 有关状态代码的完整列表,请参阅 HTTP 状态代码。
HTTP 状态代码 | 说明 |
---|---|
200 正常 | 操作成功。 |
属性 | 说明 |
---|---|
_摆脱 | 它是已在其中创建用户的数据库的资源 ID。 |
_计数 | 此属性显示作为列表操作的一部分返回的用户数。 |
用户 | 它是包含作为列表操作一部分返回的用户的数组。 用户资源的属性 |
id | 为用户生成的唯一用户名。 |
_摆脱 | 它是 系统生成的属性。 资源 ID (_rid) 是一个唯一标识符,也是按资源模型上的资源堆栈分层的标识符。 它可供内部用于放置和导航用户资源。 |
_ts | 它是系统生成的属性。 它指定资源的上次更新时间戳。 高值是一个时间戳。 |
_自我 | 它是系统生成的属性。 它是资源的唯一可寻址 URI。 |
_Etag | 它是系统生成的属性,表示乐观并发控制所需的资源 etag 。 |
_权限 | 它是一个系统生成的属性,用于指定权限资源的可寻址路径。 |
{
"_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
}
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
}