Nahrazení uživatele
Pokud chcete nahradit celý uživatelský prostředek, proveďte operaci PUT u konkrétního prostředku uživatele. Jedinou nahraditelnou vlastností je ID uživatele. Tato operace nahrazení nemá vliv na oprávnění uživatele.
Žádost
Metoda | Identifikátor URI žádosti | Description |
---|---|---|
PUT | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/users/{user-name} | {databaseaccount} je název účtu služby Azure Cosmos DB vytvořeného v rámci vašeho předplatného. Hodnota {db-id} je uživatelem vygenerované jméno nebo ID databáze, ve které se uživatel nachází, nikoli systémově generované ID (RID). Hodnota {user-name} je jméno uživatele, který má být nahrazen. |
Hlavičky
Viz Běžné hlavičky požadavků REST služby Azure Cosmos DB pro hlavičky, které používají všechny požadavky služby Cosmos DB.
Text
Vlastnost | Požaduje se | Typ | Description |
---|---|---|---|
id | Vyžadováno | Řetězec | Zadejte nové jedinečné jméno uživatele. |
{
"id": "another_user"
}
Odpověď
Hlavičky
Viz Běžné hlavičky odpovědi REST služby Azure Cosmos DB pro hlavičky, které jsou vráceny všemi odpověďmi služby Cosmos DB.
Stavové kódy
Následující tabulka uvádí běžné stavové kódy vrácené touto operací. Úplný seznam stavových kódů najdete v tématu Stavové kódy HTTP.
Stavový kód HTTP | Popis |
---|---|
200 Ok | Operace nahrazení byla úspěšná. |
400 – Chybný požadavek | Text JSON je neplatný. Zkontrolujte, jestli nechybí složené závorky nebo uvozovky. |
404 Nenalezeno | Uživatel, který má být nahrazen, už není prostředkem, to znamená, že uživatel byl odstraněn. |
409 – Konflikt | ID zadané pro uživatele bylo převzato existujícím uživatelem. |
Text
Vlastnost | Popis |
---|---|
_Zbavit | Jedná se o systém vygenerovanou vlastnost. ID prostředku (_rid) je jedinečný identifikátor, který je také hierarchický podle zásobníku prostředků v modelu prostředků. Používá se interně k umístění a navigaci v prostředku uživatele. |
_Ts | Jedná se o systém vygenerovanou vlastnost. Určuje časové razítko poslední aktualizace prostředku. Hodnota je časové razítko. |
_Vlastní | Jedná se o systém vygenerovanou vlastnost. Jedná se o jedinečný adresovatelný identifikátor URI prostředku. |
_Etag | Vygeneruje se nová značka prostředku etag . |
_Oprávnění | Jedná se o systém vygenerovanou vlastnost označující adresovatelnou cestu prostředku oprávnění. |
{
"id": "another_user",
"_rid": "Sl8fAFEKCQA=",
"_ts": 1449604250,
"_self": "dbs\/Sl8fAA==\/users\/Sl8fAFEKCQA=\/",
"_etag": "\"00000c00-0000-0000-0000-5667349a0000\"",
"_permissions": "permissions\/"
}
Příklad
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\/"
}