你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
替换权限
针对特定权限资源执行 PUT 操作将替换整个用户资源。 要进行替换，必须在正文中提交用户可设置的所有属性，例如 id、permissionMode 和 resource。 虽然必须在请求正文中提交所有可设置的属性，但并非必须更改所有属性。 在成功替换权限后，将创建一个新的资源令牌。 除非使用 x-ms-documentdb-expiry-seconds 标头重写，否则新资源令牌将在一小时内过期，这是默认期限。
请求
| 方法 | 请求 URI | 说明 |
|---|---|---|
| PUT | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/users/{user-name}/permissions/{permission-name} | 请注意，{databaseaccount} 是在订阅下创建的 Azure Cosmos DB 帐户的名称。 {db-id} 值是用户生成的数据库名称/ID，而不是系统生成的 id (rid) 。 {user-name} 值是用户的名称。 {permission-name} 值是要替换的权限的名称。 |
标头
有关所有 Cosmos DB 请求 使用的标头，请参阅常见的 Azure Cosmos DB REST 请求标头。
| 标头 | 必需 | 类型 | 说明 |
|---|---|---|---|
| x-ms-documentdb-expiry-seconds | 可选 | 整数 | 该操作返回的资源令牌的有效期。 默认情况下，资源令牌的有效期为一小时。 要覆盖默认值，请以秒为单位通过此标头设置所需的有效期。 最大覆盖值是 18000，即五个小时。 |
正文
| 属性 | 必选 | 说明 |
|---|---|---|
| id | 必需 | 它是标识权限的唯一名称，即用户拥有的两个权限都不能共享同一 ID。 ID 不得超过 255 个字符 |
| permissionMode | 必需 | 用户的资源访问模式： “全部 ”或“ 读取”。 “全部 ”提供对资源的读取、写入和删除访问权限。 Read 限制用户对资源的读取访问权限。 |
| resource | 必需 | 与权限相关联的资源的完全可寻址路径。 例如，dbs/volcanodb/colls/volcano1。 |
{
"id": "another_permission",
"permissionMode": "All",
"resource": "dbs/volcanodb/colls/volcano1"
}
响应
标头
有关所有 Cosmos DB 响应 返回的标头，请参阅常见的 Azure Cosmos DB REST 响应标头。
状态代码
下表列出了此操作返回的常见状态代码。 有关状态代码的完整列表，请参阅 HTTP 状态代码。
| HTTP 状态代码 | 说明 |
|---|---|
| 200 正常 | 替换操作成功。 |
| 400 错误的请求 | JSON 正文无效。 检查是否缺少大括号或引号。 此外，如果至少一个可设置的属性不在请求正文中，将返回 400。 检查以确保包含所有三个可设置的属性。 |
| 404 未找到 | 要替换的用户不再是资源，即权限已删除。 |
| 409 冲突 | 为权限提供的 ID 已被现有权限占用。 如果已将新权限分配给用户的另一个权限，也会返回 409。 |
正文
| 属性 | 说明 |
|---|---|
| _摆脱 | 它是系统生成的属性。 资源 ID (_rid) 是一个唯一标识符，也是根据资源模型上的资源堆栈分层的。 它可供内部用于放置和导航权限资源。 |
| _ts | 它是系统生成的属性。 它指定资源的上次更新时间戳。 高值是一个时间戳。 |
| _自我 | 它是系统生成的属性。 它是资源的唯一可寻址 URI。 |
| _Etag | 它是系统生成的属性，表示乐观并发控制所需的资源 etag 。 |
| _令 牌 | 它是系统为特定资源和用户生成的资源令牌。 |
{
"id": "another_permission",
"permissionMode": "All",
"resource": "dbs/volcanodb/colls/volcano1",
"_rid": "Sl8fAG8cXgBn6Ju2GqNsAA==",
"_ts": 1449605172,
"_self": "dbs\/Sl8fAA==\/users\/Sl8fAG8cXgA=\/permissions\/Sl8fAG8cXgBn6Ju2GqNsAA==\/",
"_etag": "\"00000f00-0000-0000-0000-566738340000\"",
"_token": "type=resource&ver=1&sig=liT1vyY6rvPBZXRuXNluPA==;A4zwoVw1GcQUSF3N2d1D5J1s3DhN0547KlhdYkkfT5UzGWecIDJf+LInlbYjqgZKwHKrFfeHLJWq0OFfH9KUOaeMCkPPlu8yKNM098las28ClqVNwmi9Ir\/jC3UVFU\/yFQl4z4wiMxxbrCkpnA\/ZsKqmxZ1LAosimPgF4zKvC9isWjgmB1N8+X9pH49wDg62tGkHF0HoSu+KpF7bkjP4VpHfo9u9jV86l7brrOvUYyE=;"
}
示例
PUT https://contosomarketing.documents.azure.com/dbs/volcanodb/users/a_user/permissions/a_permission HTTP/1.1
x-ms-date: Tue, 08 Dec 2015 20:06:11 GMT
authorization: type%3dmaster%26ver%3d1.0%26sig%3d8PTpiHHJvUq7ra07iWGYpiLJ%2fMyglgJZxfyGKHWjbaQ%3d
Cache-Control: no-cache
User-Agent: contoso/1.0
x-ms-version: 2015-08-06
Accept: application/json
Host: contosomarketing.documents.azure.com
Cookie: x-ms-session-token=866
Content-Length: 554
Expect: 100-continue
Connection: Keep-Alive
{
"id": "another_permission",
"permissionMode": "All",
"resource": "dbs/volcanodb/colls/volcano1",
"_rid": "Sl8fAG8cXgBn6Ju2GqNsAA==",
"_ts": 1449604760,
"_self": "dbs/volcanodb/users/a_user/permissions/a_permission",
"_etag": "\"00000e00-0000-0000-0000-566736980000\"",
"_token": "type=resource&ver=1&sig=zv2AYJFeWMhks0Ezv2WVKQ==;x2fUwajIajvwi+vfQ6GHmf82HTK4qppkhRHMk1Nx8ei0g8zuxIBQ6cyu0d3hOV06fC/PdyIj2/bmNCwpfkxFI++QI1eVPP0/tGTQuMPyqNVCCM5t8KFx6rVNUReBHlWNp0y8iAZ3pRvA2Wl6uaE0K7tFQKmPKqUbumYbOMWKk1kDCfCeCF0Qkt7RYUXlmvawFNoYnVRN/mgnpzX23vW63mU/GoeRXnMOI1HXcdrnf4M=;"
}
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/permissions/a_permission
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: "00000f00-0000-0000-0000-566738340000"
x-ms-resource-quota: permissions=2000000;
x-ms-resource-usage: permissions=2;
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: 866
x-ms-session-token: 867
x-ms-current-write-quorum: 3
x-ms-current-replica-set-size: 4
x-ms-request-charge: 9.9
x-ms-serviceversion: version=1.5.57.3
x-ms-activity-id: 4b91c955-ebd4-4059-a58e-91c99226f225
Set-Cookie: x-ms-session-token=867; Domain=contosomarketing.documents.azure.com; Path=/dbs/volcanodb/users/a_user
x-ms-gatewayversion: version=1.5.57.3
Date: Tue, 08 Dec 2015 20:06:10 GMT
Content-Length: 581
{
"id": "another_permission",
"permissionMode": "All",
"resource": "dbs/volcanodb/colls/volcano1",
"_rid": "Sl8fAG8cXgBn6Ju2GqNsAA==",
"_ts": 1449605172,
"_self": "dbs\/Sl8fAA==\/users\/Sl8fAG8cXgA=\/permissions\/Sl8fAG8cXgBn6Ju2GqNsAA==\/",
"_etag": "\"00000f00-0000-0000-0000-566738340000\"",
"_token": "type=resource&ver=1&sig=liT1vyY6rvPBZXRuXNluPA==;A4zwoVw1GcQUSF3N2d1D5J1s3DhN0547KlhdYkkfT5UzGWecIDJf+LInlbYjqgZKwHKrFfeHLJWq0OFfH9KUOaeMCkPPlu8yKNM098las28ClqVNwmi9Ir\/jC3UVFU\/yFQl4z4wiMxxbrCkpnA\/ZsKqmxZ1LAosimPgF4zKvC9isWjgmB1N8+X9pH49wDg62tGkHF0HoSu+KpF7bkjP4VpHfo9u9jV86l7brrOvUYyE=;"
}