使用英语阅读

通过


你当前正在访问 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  
}  
  

另请参阅