Uprawnienia listy

  • Artykuł

Aby wyświetlić listę zasobów uprawnień określonej bazy danych, wykonaj operację GET na ścieżce identyfikatora URI uprawnień, która zwraca listę uprawnień dla użytkownika. Wszystkie tokeny zasobów są tworzone ponownie dla odpowiednich uprawnień zwróconych w ramach odpowiedzi. Nowe tokeny mają domyślny okres ważności (jedną godzinę), chyba że zostanie zastąpiony.

Żądanie

Metoda Identyfikator URI żądania Opis
GET https://{databaseaccount}.documents.azure.com/dbs/{db-id}/users/{user-name}/permissions Pamiętaj, że {databaseaccount} jest nazwą konta usługi Azure Cosmos DB utworzonego w ramach subskrypcji. Wartość {db-id} to wygenerowana przez użytkownika nazwa/identyfikator bazy danych, a nie identyfikator wygenerowany przez system (rid). Wartość {user-name} jest nazwą użytkownika.

Nagłówki

Zobacz Typowe nagłówki żądań USŁUGI Azure Cosmos DBREST dla nagłówków używanych przez wszystkie żądania usługi Azure Cosmos DB.

Treść

Brak.

Reakcja

Nagłówki

Zobacz Typowe nagłówki odpowiedzi usługi Azure Cosmos DB dla nagłówków zwracanych przez wszystkie odpowiedzi usługi Azure Cosmos DB.

Kody stanu

W poniższej tabeli wymieniono typowe kody stanu zwracane przez tę operację. Aby uzyskać pełną listę kodów stanu, zobacz Kody stanu HTTP.

Kod Opis
200 OK Operacja zakończyła się pomyślnie.

Treść

Właściwość Opis
_Rid Jest to identyfikator zasobu użytkownika, który jest właścicielem uprawnień.
_Liczba Ta właściwość pokazuje liczbę użytkowników zwróconych w ramach operacji listy.
Uprawnienia Ta tablica zawierająca uprawnienia zwrócone w ramach operacji listy.
id Użytkownik wygenerował unikatową nazwę uprawnienia.
permissionMode Tryb dostępu w zasobie użytkownika: Wszystko lub Odczyt. Wszystkie zapewniają dostęp do odczytu, zapisu i usuwania zasobu. Odczyt ogranicza użytkownikowi dostęp do odczytu w zasobie.
Zasobów Pełna adresowa ścieżka zasobu skojarzonego z uprawnieniem. Na przykład dbs/volcanodb/colls/wulkan1.
_Rid Jest to właściwość wygenerowana przez system. Identyfikator zasobu (_rid) jest unikatowym identyfikatorem, który jest również hierarchiczny dla stosu zasobów w modelu zasobów. Jest on używany wewnętrznie do umieszczania zasobu użytkownika i nawigacji do niego.
_Ts Jest to właściwość wygenerowana przez system. Określa ostatni zaktualizowany znacznik czasu zasobu. Wartość jest znacznikiem czasu.
_Własny Jest to właściwość wygenerowana przez system. Jest to unikatowy adresowy identyfikator URI zasobu.
_Etag Jest to właściwość wygenerowana przez system, która reprezentuje tag zasobu wymagany do optymistycznej kontroli współbieżności.
_Tokenu Jest to token zasobu wygenerowany przez system dla określonego zasobu i użytkownika. 
{  
    "_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  
}

Przykład

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  
}

Zobacz też