Criar Utilizador
A Create User operação cria um novo utilizador numa base de dados.
Pedir
| Método | URI do pedido | Description |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/users |
A {databaseaccount} é o nome da conta do Azure Cosmos DB criada na sua subscrição. O valor {db-id} é o nome/ID gerado pelo utilizador da base de dados, não o ID gerado pelo sistema (rid). |
Cabeçalhos
Veja Common Azure Cosmos DB REST request headers for headers that are used by all Azure Cosmos DB requests (Cabeçalhos de pedido REST do Azure Cosmos DB comuns para cabeçalhos que são utilizados por todos os pedidos do Azure Cosmos DB).
Corpo
| Propriedade | Necessário | Tipo | Descrição |
|---|---|---|---|
| ID | Necessário | String | O utilizador gerou um nome exclusivo para o utilizador. Nenhum utilizador partilha o mesmo valor de ID . É uma cadeia que não pode ter mais de 255 carateres. |
{
"id": "a_user"
}
Resposta
Cabeçalhos
Veja Common Azure Cosmos DB REST response headers for headers that are returned by all Azure Cosmos DB responses (Cabeçalhos de resposta REST do Azure Cosmos DB comuns para cabeçalhos devolvidos por todas as respostas do Azure Cosmos DB).
Códigos de estado
A tabela seguinte lista os códigos de estado comuns devolvidos por esta operação. Para obter uma lista completa dos códigos de estado, veja Códigos de Estado HTTP.
| Código de estado de HTTP | Descrição |
|---|---|
| 201 Criado | A operação foi efetuada com êxito. |
| 400 Pedido Incorreto | O corpo JSON é inválido. Verifique se existem parênteses ou aspas curvas em falta. |
| 409 Conflito | O ID fornecido para o novo utilizador foi utilizado por um utilizador existente. |
Corpo
| Propriedade | Descrição |
|---|---|
| _rid | É uma propriedade gerada pelo sistema. O ID do recurso (_rid) é um identificador exclusivo que também é hierárquico de acordo com a pilha de recursos no modelo de recursos. É utilizado internamente para colocação e navegação para o recurso do utilizador. |
| _ts | É uma propriedade gerada pelo sistema. Especifica o último carimbo de data/hora atualizado do recurso. O valor é um carimbo de data/hora. |
| _self | É uma propriedade gerada pelo sistema. É o URI endereçável exclusivo para o recurso. |
| _etag | É uma propriedade gerada pelo sistema que representa a etag de recursos necessária para o controlo de simultaneidade otimista. |
| _permissions | É uma propriedade gerada pelo sistema que indica o caminho endereçável do recurso de permissões. |
{
"id": "a_user",
"_rid": "Sl8fAFEKCQA=",
"_ts": 1449603893,
"_self": "dbs\/Sl8fAA==\/users\/Sl8fAFEKCQA=\/",
"_etag": "\"00000b00-0000-0000-0000-566733350000\"",
"_permissions": "permissions\/"
}
Exemplo
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\/"
}