你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
在 Azure Cosmos 数据库中创建新权限
该 Create Permission 操作在数据库中创建新权限。
请求
| 方法 | 请求 URI | 说明 |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/users/{user-name}/permissions | 请注意，{databaseaccount} 是在订阅下创建的 Azure Cosmos DB 帐户的名称。 {db-id} 值是用户生成的数据库名称/ID，而不是系统生成的 ID (rid) 。 {user-name} 值是拥有权限的用户的名称。 |
标头
有关所有 Azure Cosmos DB 请求 使用的标头，请参阅常见的 Azure Cosmos DB REST 请求标头。
| 标头 | 必需 | 类型 | 说明 |
|---|---|---|---|
| x-ms-documentdb-expiry-seconds | 可选 | 整数 | 该操作返回的资源令牌的有效期。 默认情况下，资源令牌的有效期为一小时。 要覆盖默认值，请以秒为单位通过此标头设置所需的有效期。 最大覆盖值是 18000，即五个小时。 |
正文
| 属性 | 必选 | 类型 | 说明 |
|---|---|---|---|
| id | 必须 | 字符串 | 它是用户可设置的属性。 它是用于标识权限的唯一名称，也就是说，用户拥有的两个权限都不能共享相同的 ID。 ID 不得超过 255 个字符。 |
| permissionMode | 必须 | 字符串 | 资源的访问模式： “全部 ”或“ 读取”。 All 提供对资源的读取、写入和删除访问权限。 Read 限制用户对资源的读取访问权限。 |
| resource | 必须 | 字符串 | 与权限相关联的资源的完全可寻址路径。 例如，dbs/volcanodb/colls/volcano1。 |
{
"id": "a_permission",
"permissionMode": "Read",
"resource": "dbs/volcanodb/colls/volcano1"
}
响应
标头
有关所有 Azure Cosmos DB 响应 返回的标头，请参阅常见的 Azure Cosmos DB REST 响应标头。
状态代码
下表列出了此操作返回的常见状态代码。 有关状态代码的完整列表，请参阅 HTTP 状态代码。
| HTTP 状态代码 | 说明 |
|---|---|
| 201 Created | 操作成功。 |
| 400 错误的请求 | JSON 正文无效。 检查是否缺少大括号或引号。 此外，如果至少一个可设置的属性不在请求正文中，将返回 400。 检查以确保包含所有三个可设置的属性。 |
| 409 冲突 | 为新权限提供的 ID 已由现有权限获取。 如果将新权限分配给已与该用户的另一个权限相关联的资源，也会返回 409。 |
正文
| 属性 | 说明 |
|---|---|
| _摆脱 | 它是 系统生成的属性。 资源 id (_rid) 是一个唯一标识符，它也是按资源模型上的资源堆栈分层的。 它可供内部用于放置和导航权限资源。 |
| _ts | 它是系统生成的属性。 它指定资源的上次更新时间戳。 高值是一个时间戳。 |
| _自我 | 它是系统生成的属性。 它是资源的唯一可寻址 URI。 |
| _Etag | 它是系统生成的属性，表示乐观并发控制所需的资源 etag 。 |
| _令 牌 | 它是系统为特定资源和用户生成的资源令牌。 |
{
"id": "a_permission",
"permissionMode": "Read",
"resource": "dbs/volcanodb/colls/volcano1",
"_rid": "Sl8fAG8cXgBn6Ju2GqNsAA==",
"_ts": 1449604760,
"_self": "dbs\/Sl8fAA==\/users\/Sl8fAG8cXgA=\/permissions\/Sl8fAG8cXgBn6Ju2GqNsAA==\/",
"_etag": "\"00000e00-0000-0000-0000-566736980000\"",
"_token": "type=resource&ver=1&sig=4\/IPvcZwC9TnN\/M1gPjuBg==;C1Q5UpZAgytiayVo\/GPAbBklnnRuGqGB2o\/42KTuZfmN4P6a83JP4LU34neSg25\/8Wt5wwINjy6Vf8rr9fG09FxnGX9jHAM+Zzhqyqjt4rv3Dk3pN+sjC0KTE5jDiTkCdAlxHv4TYaTLOnEWdeVUKevuAPFbmUQGSwk9ipjv11BqWPK\/cN4lUujSfRc3rRaI8pgf90p0bD6KBTJlB+0sFjdI3P1hzunNvd9s9CHJ09U=;"
}
示例
POST https://contosomarketing.documents.azure.com/dbs/volcanodb/users/a_user/permissions HTTP/1.1
x-ms-date: Tue, 08 Dec 2015 19:59:19 GMT
authorization: type%3dmaster%26ver%3d1.0%26sig%3dwBH%2bhvVN5L4fu508ixzH%2bc7pQNfg7meU62MydCoead0%3d
Cache-Control: no-cache
User-Agent: contoso/1.0
x-ms-version: 2015-08-06
Accept: application/json
Host: contosomarketing.documents.azure.com
Content-Length: 87
Expect: 100-continue
Connection: Keep-Alive
{
"id": "a_permission",
"permissionMode": "Read",
"resource": "dbs/volcanodb/colls/volcano1"
}
HTTP/1.1 201 Created
Cache-Control: no-store, no-cache
Pragma: no-cache
Content-Type: application/json
Server: Microsoft-HTTPAPI/2.0
Strict-Transport-Security: max-age=31536000
x-ms-last-state-change-utc: Sun, 29 Nov 2015 02:25:35.212 GMT
etag: "00000e00-0000-0000-0000-566736980000"
x-ms-resource-quota: permissions=2000000;
x-ms-resource-usage: permissions=1;
x-ms-schemaversion: 1.1
x-ms-alt-content-path: dbs/volcanodb/users/a_user
x-ms-content-path: Sl8fAG8cXgA=
x-ms-quorum-acked-lsn: 865
x-ms-session-token: 866
x-ms-current-write-quorum: 3
x-ms-current-replica-set-size: 4
x-ms-request-charge: 4.95
x-ms-serviceversion: version=1.5.57.3
x-ms-activity-id: 4069f7dc-3863-4ae0-8df8-828bc86d75dc
x-ms-gatewayversion: version=1.5.57.3
Date: Tue, 08 Dec 2015 19:59:21 GMT
Content-Length: 579
{
"id": "a_permission",
"permissionMode": "Read",
"resource": "dbs/volcanodb/colls/volcano1",
"_rid": "Sl8fAG8cXgBn6Ju2GqNsAA==",
"_ts": 1449604760,
"_self": "dbs\/Sl8fAA==\/users\/Sl8fAG8cXgA=\/permissions\/Sl8fAG8cXgBn6Ju2GqNsAA==\/",
"_etag": "\"00000e00-0000-0000-0000-566736980000\"",
"_token": "type=resource&ver=1&sig=4\/IPvcZwC9TnN\/M1gPjuBg==;C1Q5UpZAgytiayVo\/GPAbBklnnRuGqGB2o\/42KTuZfmN4P6a83JP4LU34neSg25\/8Wt5wwINjy6Vf8rr9fG09FxnGX9jHAM+Zzhqyqjt4rv3Dk3pN+sjC0KTE5jDiTkCdAlxHv4TYaTLOnEWdeVUKevuAPFbmUQGSwk9ipjv11BqWPK\/cN4lUujSfRc3rRaI8pgf90p0bD6KBTJlB+0sFjdI3P1hzunNvd9s9CHJ09U=;"
}