Permissões de Lista

  • Artigo

Para listar o recurso de permissões de uma base de dados específica, execute uma operação GET no caminho do URI de permissões, que devolve uma lista de permissões para o utilizador. Todos os tokens de recursos são recriados para as respetivas permissões devolvidas como parte da resposta. Os novos tokens têm o período de validade predefinido (uma hora), a menos que seja substituído.

Pedir

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

Cabeçalhos

Veja Common Azure Cosmos DBREST request headers for headers that are used by all Azure Cosmos DB requests (Cabeçalhos de pedido do Azure Cosmos DBREST comuns para cabeçalhos que são utilizados por todos os pedidos do Azure Cosmos DB).

Corpo

Nenhum.

Resposta

Cabeçalhos

Veja Cabeçalhos de resposta comuns do Azure Cosmos DB 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 Descrição
200 Ok A operação foi efetuada com êxito.

Corpo

Propriedade Descrição
_rid Este é o ID de recurso do utilizador que possui as permissões.
_count Esta propriedade mostra o número de utilizadores devolvidos como parte da operação de lista.
Permissões Esta é a matriz que contém as permissões devolvidas como parte da operação de lista.
id O utilizador gerou um nome exclusivo para a permissão.
permissionMode O modo de acesso no recurso para o utilizador: Tudo ou Leitura. Todos fornecem acesso de leitura, escrita e eliminação a um recurso. A funcionalidade Ler restringe o acesso de leitura do utilizador ao recurso.
recurso O caminho endereçável completo do recurso associado à permissão. Por exemplo, dbs/volcanodb/colls/volcano1.
_rid Esta é 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 Esta é uma propriedade gerada pelo sistema. Especifica o último carimbo de data/hora atualizado do recurso. O valor é um carimbo de data/hora.
_self Esta é uma propriedade gerada pelo sistema. É o URI endereçável exclusivo para o recurso.
_etag Esta é uma propriedade gerada pelo sistema que representa a etag de recursos necessária para o controlo de simultaneidade otimista.
_token Este é um token de recurso gerado pelo sistema para o utilizador e o recurso específicos. 
{  
    "_rid": "Sl8fAG8cXgA=",  
    "Permissions": [{  
        "id": "a_permission",  
        "permissionMode": "Read",  
        "resource": "dbs/volcanodb/colls/volcano1",  
        "_rid": "Sl8fAG8cXgBn6Ju2GqNsAA==",  
        "_ts": 1449604760,  
        "_self": "dbs\/Sl8fAA==\/users\/Sl8fAG8cXgA=\/permissions\/Sl8fAG8cXgBn6Ju2GqNsAA==\/",  
        "_etag": "\"00000e00-0000-0000-0000-566736980000\"",  
        "_token": "type=resource&ver=1&sig=lxKlPHeqlIx2\/J02rFs3jw==;20MwFhNUO9xNOuglK9gyL18Mt5xIhbN48pzSq6FaR\/7sKFtGd6GaxCooIoPP6rYxRHUeCabHOFkbIeT4ercXk\/F1FG70QkQTD9CxDqNJx3NImgZJWErK1NlEjxkpFDV5uslhpJ4Y3JBnc72\/vlmR95TibFS0rC\/cdND0uRvoOOWXZYvVAJFKEUKyy3GTlYOxY1nKT313ZCOSUQF7kldjo9DE3XEBf8cct1uNKMILImo=;"  
    }],  
    "_count": 1  
}

Exemplo

GET https://contosomarketing.documents.azure.com/dbs/volcanodb/users/a_user/permissions HTTP/1.1  
x-ms-date: Tue, 08 Dec 2015 20:01:24 GMT  
authorization: type%3dmaster%26ver%3d1.0%26sig%3dIBouMlVA5x5WqHIydZ0OSYHRPAkwoliqqkAJCCeNhjw%3d  
Cache-Control: no-cache  
User-Agent: contoso/1.0  
x-ms-version: 2015-08-06  
x-ms-max-item-count: 3  
Accept: application/json  
Host: contosomarketing.documents.azure.com  
Connection: Keep-Alive  
  

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/permissions  
Server: Microsoft-HTTPAPI/2.0  
Strict-Transport-Security: max-age=31536000  
x-ms-last-state-change-utc: Thu, 26 Nov 2015 06:37:26.906 GMT  
x-ms-resource-quota: permissions=2000000;  
x-ms-resource-usage: permissions=1;  
x-ms-item-count: 1  
x-ms-schemaversion: 1.1  
x-ms-alt-content-path: dbs/volcanodb/users/a_user  
x-ms-content-path: Sl8fAG8cXgA=  
x-ms-session-token: 866  
x-ms-request-charge: 2  
x-ms-serviceversion: version=1.5.57.3  
x-ms-activity-id: fb0095e8-ab6b-4423-bd6f-7af9f6f6ff68  
Set-Cookie: x-ms-session-token=866; Domain=contosomarketing.documents.azure.com; Path=/dbs/volcanodb/users/a_user  
x-ms-gatewayversion: version=1.5.57.3  
Date: Tue, 08 Dec 2015 20:01:58 GMT  
Content-Length: 629  
  
{  
    "_rid": "Sl8fAG8cXgA=",  
    "Permissions": [{  
        "id": "a_permission",  
        "permissionMode": "Read",  
        "resource": "dbs/volcanodb/colls/volcano1",  
        "_rid": "Sl8fAG8cXgBn6Ju2GqNsAA==",  
        "_ts": 1449604760,  
        "_self": "dbs\/Sl8fAA==\/users\/Sl8fAG8cXgA=\/permissions\/Sl8fAG8cXgBn6Ju2GqNsAA==\/",  
        "_etag": "\"00000e00-0000-0000-0000-566736980000\"",  
        "_token": "type=resource&ver=1&sig=lxKlPHeqlIx2\/J02rFs3jw==;20MwFhNUO9xNOuglK9gyL18Mt5xIhbN48pzSq6FaR\/7sKFtGd6GaxCooIoPP6rYxRHUeCabHOFkbIeT4ercXk\/F1FG70QkQTD9CxDqNJx3NImgZJWErK1NlEjxkpFDV5uslhpJ4Y3JBnc72\/vlmR95TibFS0rC\/cdND0uRvoOOWXZYvVAJFKEUKyy3GTlYOxY1nKT313ZCOSUQF7kldjo9DE3XEBf8cct1uNKMILImo=;"  
    }],  
    "_count": 1  
}

Consulte também