Obter um Utilizador

  • Artigo

Para obter um recurso de utilizador específico numa base de dados específica, execute uma operação GET no utilizador.

Pedir

Método URI do pedido Descrição
GET https://{databaseaccount}.documents.azure.com/dbs/{db-id}/users/{user-name} Tenha em atenção que {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 e não o ID gerado pelo sistema (rid). O valor {user-name} é o nome do utilizador.

Cabeçalhos

Veja Common Azure Cosmos DB REST request headers for headers that are used by all 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 Cosmos DB).

Corpo

Nenhum.

Resposta

Cabeçalhos

Veja Common Azure Cosmos DB REST response headers for headers that are returned by all Cosmos DB responses (Cabeçalhos de resposta REST do Azure Cosmos DB comuns para cabeçalhos devolvidos por todas as respostas do 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, consulte Códigos de Estado HTTP.

Código de estado de HTTP Descrição
200 OK A operação foi bem-sucedida.
404 Não Encontrado O utilizador já não é um recurso, ou seja, o utilizador foi eliminado.

Corpo

Propriedade Descrição
id O nome exclusivo gerado pelo utilizador.
_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 no 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 o etag de recursos necessário para o controlo de simultaneidade otimista.
_permissions É uma propriedade gerada pelo sistema que especifica 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

GET https://contosomarketing.documents.azure.com/dbs/volcanodb/users/a_user HTTP/1.1  
x-ms-date: Tue, 08 Dec 2015 19:49:05 GMT  
authorization: type%3dmaster%26ver%3d1.0%26sig%3deQXTD1sMkhhn9657uwqO72KCPRDnlQkk0emPfJh0biw%3d  
Cache-Control: no-cache  
User-Agent: contoso/1.0  
x-ms-version: 2015-08-06  
Accept: application/json  
Host: contosomarketing.documents.azure.com  
  

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:34.442 GMT  
etag: "00000b00-0000-0000-0000-566733350000"  
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-session-token: 862  
x-ms-request-charge: 2  
x-ms-serviceversion: version=1.5.57.3  
x-ms-activity-id: 4b2e6bdd-6cc7-423e-b8b1-32781166e0b1  
x-ms-gatewayversion: version=1.5.57.3  
Date: Tue, 08 Dec 2015 19:49:05 GMT  
Content-Length: 183  
  
{  
    "id": "a_user",  
    "_rid": "Sl8fAFEKCQA=",  
    "_ts": 1449603893,  
    "_self": "dbs\/Sl8fAA==\/users\/Sl8fAFEKCQA=\/",  
    "_etag": "\"00000b00-0000-0000-0000-566733350000\"",  
    "_permissions": "permissions\/"  
}

Consulte também