Vytvořit uživatele
Operace Create User vytvoří v databázi nového uživatele.
Žádost
| Metoda | Identifikátor URI žádosti | Description |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/users |
{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/ID databáze, nikoli systémem generované ID (RID). |
Hlavičky
Projděte si běžné hlavičky požadavků REST služby Azure Cosmos DB pro hlavičky, které používají všechny požadavky služby Azure Cosmos DB.
Text
| Vlastnost | Požaduje se | Typ | Description |
|---|---|---|---|
| id | Vyžadováno | Řetězec | Uživatel vygeneroval jedinečné jméno pro uživatele. Žádní dva uživatelé nesdílí stejnou hodnotu ID . Jedná se o řetězec, který nesmí být delší než 255 znaků. |
{
"id": "a_user"
}
Odpověď
Hlavičky
Informace o hlavičkách, které vrací všechny odpovědi služby Azure Cosmos DB, najdete v tématu Běžné hlavičky odpovědi REST služby Azure Cosmos DB.
Stavové kódy
Následující tabulka obsahuje seznam běžných stavových kódů vrácených touto operací. Úplný seznam stavových kódů najdete v tématu Stavové kódy HTTP.
| Stavový kód HTTP | Popis |
|---|---|
| 201 Vytvořeno | Operace byla úspěšná. |
| 400 – Chybný požadavek | Text JSON je neplatný. Zkontrolujte, jestli nechybí složené závorky nebo uvozovky. |
| 409 – Konflikt | ID zadané pro nového uživatele bylo převzato existujícím uživatelem. |
Text
| Vlastnost | Popis |
|---|---|
| _Zbavit | Jedná se o systémem 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 do prostředku uživatele. |
| _Ts | Jedná se o systémem vygenerovanou vlastnost. Určuje časové razítko poslední aktualizace prostředku. Hodnota je časové razítko. |
| _Vlastní | Jedná se o systémem vygenerovanou vlastnost. Jedná se o jedinečný adresovatelný identifikátor URI prostředku. |
| _Etag | Jedná se o systémem vygenerovanou vlastnost představující etag prostředku vyžadovanou pro optimistické řízení souběžnosti. |
| _Oprávnění | Jedná se o systémem vygenerovanou vlastnost, která označuje adresovatelnou cestu prostředku oprávnění. |
{
"id": "a_user",
"_rid": "Sl8fAFEKCQA=",
"_ts": 1449603893,
"_self": "dbs\/Sl8fAA==\/users\/Sl8fAFEKCQA=\/",
"_etag": "\"00000b00-0000-0000-0000-566733350000\"",
"_permissions": "permissions\/"
}
Příklad
POST https://contosomarketing.documents.azure.com/dbs/volcanodb/users HTTP/1.1
x-ms-date: Tue, 08 Dec 2015 19:44:53 GMT
authorization: type%3dmaster%26ver%3d1.0%26sig%3dkcsSpfnCwqkJEmIonYBaf%2fnRZSKwaQ0nagG7IthW130%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: 15
Expect: 100-continue
{
"id": "a_user"
}
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: "00000b00-0000-0000-0000-566733350000"
x-ms-resource-quota: users=500000;
x-ms-resource-usage: users=1;
x-ms-schemaversion: 1.1
x-ms-alt-content-path: dbs/volcanodb
x-ms-content-path: Sl8fAA==
x-ms-quorum-acked-lsn: 861
x-ms-session-token: 862
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: f123ec48-72ec-4aad-94bb-915a64f067cc
x-ms-gatewayversion: version=1.5.57.3
Date: Tue, 08 Dec 2015 19:44:54 GMT
Content-Length: 183
{
"id": "a_user",
"_rid": "Sl8fAFEKCQA=",
"_ts": 1449603893,
"_self": "dbs\/Sl8fAA==\/users\/Sl8fAFEKCQA=\/",
"_etag": "\"00000b00-0000-0000-0000-566733350000\"",
"_permissions": "permissions\/"
}