Kullanıcıyı Değiştirme
Bir kullanıcı kaynağının tamamını değiştirmek için, belirli bir kullanıcı kaynağı üzerinde put işlemi gerçekleştirin. Değiştirilebilir tek özellik, kullanıcının kimliğidir. Bu değiştirme işlemi kullanıcının izinlerini etkilemez.
İstek
| Yöntem | İstek URI'si | Description |
|---|---|---|
| PUT | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/users/{user-name} | {databaseaccount}, aboneliğiniz altında oluşturulan Azure Cosmos DB hesabının adıdır. {db-id} değeri, sistem tarafından oluşturulan kimlik (rid) değil kullanıcının bulunduğu veritabanının kullanıcı tarafından oluşturulan adı/kimliğidir. {user-name} değeri değiştirilecek kullanıcının adıdır. |
Üst Bilgiler
Tüm Cosmos DB istekleri tarafından kullanılan üst bilgiler için bkz. Yaygın Azure Cosmos DB REST istek üst bilgileri.
Gövde
| Özellik | Gerekli | Tür | Description |
|---|---|---|---|
| id | Gerekli | Dize | Kullanıcı için yeni bir benzersiz ad sağlayın. |
{
"id": "another_user"
}
Yanıt
Üst Bilgiler
Tüm Cosmos DB yanıtları tarafından döndürülen üst bilgiler için bkz. Yaygın Azure Cosmos DB REST yanıt üst bilgileri.
Durum kodları
Aşağıdaki tabloda bu işlem tarafından döndürülen genel durum kodları listelenmektedir. Durum kodlarının tam listesi için bkz. HTTP Durum Kodları.
| HTTP durum kodu | Açıklama |
|---|---|
| 200 Tamam | Değiştirme işlemi başarılı oldu. |
| 400 Hatalı İstek | JSON gövdesi geçersiz. Eksik küme ayraçlarını veya tırnakları denetleyin. |
| 404 Bulunamadı | Değiştirilecek kullanıcı artık bir kaynak değil, yani kullanıcı silinmiş. |
| 409 Çakışma | Kullanıcı için sağlanan kimlik mevcut bir kullanıcı tarafından alındı. |
Gövde
| Özellik | Açıklama |
|---|---|
| _Kurtulmak | Sistem tarafından oluşturulan bir özelliktir. Kaynak kimliği (_rid), kaynak modelinde kaynak yığını başına da hiyerarşik olan benzersiz bir tanımlayıcıdır. Kullanıcı kaynağının yerleştirilmesi ve bu kaynakta gezinme için dahili olarak kullanılır. |
| _Ts | Sistem tarafından oluşturulan bir özelliktir. Kaynağın son güncelleştirilen zaman damgasını belirtir. Değer bir zaman damgasıdır. |
| _Kendini | Sistem tarafından oluşturulan bir özelliktir. Kaynak için benzersiz adreslenebilir URI'dir. |
| _Etag | Yeni bir kaynak etag'i oluşturulur. |
| _Izin | İzin kaynağının adreslenebilir yolunu belirten sistem tarafından oluşturulan bir özelliktir. |
{
"id": "another_user",
"_rid": "Sl8fAFEKCQA=",
"_ts": 1449604250,
"_self": "dbs\/Sl8fAA==\/users\/Sl8fAFEKCQA=\/",
"_etag": "\"00000c00-0000-0000-0000-5667349a0000\"",
"_permissions": "permissions\/"
}
Örnek
PUT https://contosomarketing.documents.azure.com/dbs/volcanodb/users/a_user HTTP/1.1
x-ms-date: Tue, 08 Dec 2015 19:50:50 GMT
authorization: type%3dmaster%26ver%3d1.0%26sig%3d%2by3RxtfXTgRnAMx2zwCmMFx%2bbKetAvuaGmVYeS1psjE%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: 148
Expect: 100-continue
Connection: Keep-Alive
{
"id": "another_user",
}
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
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: "00000c00-0000-0000-0000-5667349a0000"
x-ms-resource-quota: users=500000;
x-ms-resource-usage: users=2;
x-ms-schemaversion: 1.1
x-ms-alt-content-path: dbs/volcanodb
x-ms-content-path: Sl8fAA==
x-ms-quorum-acked-lsn: 862
x-ms-session-token: 863
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: 8089fc55-a82c-432f-83d2-6a9ad712addd
x-ms-gatewayversion: version=1.5.57.3
Date: Tue, 08 Dec 2015 19:50:51 GMT
Content-Length: 189
{
"id": "another_user",
"_rid": "Sl8fAFEKCQA=",
"_ts": 1449604250,
"_self": "dbs\/Sl8fAA==\/users\/Sl8fAFEKCQA=\/",
"_etag": "\"00000c00-0000-0000-0000-5667349a0000\"",
"_permissions": "permissions\/"
}