Udostępnij przez

Uzyskiwanie uprawnień

Wykonanie operacji GET dla określonego zasobu uprawnień pobiera właściwości uprawnień, w tym token, dla określonego uprawnienia. Nowy token zasobu jest tworzony za każdym razem, gdy na zasobie uprawnień jest wywoływany get. Ten nowy token ma domyślny okres ważności jednej godziny, chyba że zostanie zastąpiony.

Żądanie

Metoda Żądanie URI Opis
GET https://{databaseaccount}.documents.azure.com/dbs/{db-id}/users/{user-name}/permissions/{permission-name} 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. Wartość {permission-name} to nazwa uprawnienia do pobrania.

Nagłówki

Zobacz typowe nagłówki żądań REST usługi Azure Cosmos DB nagłówków używanych przez wszystkie żądania usługi Cosmos DB.

Nagłówek Wymagane Typ Opis
x-ms-documentdb-expiry-seconds Opcjonalnie Integer Okres ważności tokenu zasobu zwrócony przez operację. Domyślnie token zasobu jest ważny przez jedną godzinę. Aby zastąpić wartość domyślną, ustaw ten nagłówek na żądany okres ważności w sekundach. Maksymalna wartość przesłonięcia to 18000, czyli pięć godzin.

Ciało

Żaden.

Odpowiedź

Nagłówki

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

Kody stanu

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

Kod stanu HTTP Opis
200 OK Operacja zakończyła się pomyślnie.
404 Nie znaleziono Uprawnienie nie jest już zasobem, czyli uprawnienie zostało usunięte.

Ciało

Nieruchomość Opis
identyfikator Jest to unikatowa nazwa identyfikująca uprawnienie, czyli brak dwóch uprawnień należących do użytkownika, które mogą współdzielić ten sam identyfikator. Identyfikator nie może przekraczać 255 znaków
permissionMode Tryb dostępu dla zasobu użytkownika: Wszystkie lub Odczyt. Wszystkie zapewnia dostęp do zasobu do odczytu, zapisu i usuwania. odczyt ogranicza użytkownikowi dostęp do odczytu w zasobie.
zasobów Pełna ścieżka adresowa zasobu skojarzonego z uprawnieniem. Na przykład dbs/volcanodb/colls/wulkan1.
_rid Jest to właściwość wygenerowana przez system . Identyfikator zasobu (_rid) to unikatowy identyfikator, który jest również hierarchiczny dla stosu zasobów w modelu zasobów. Jest on używany wewnętrznie do umieszczania i nawigacji zasobu uprawnień.
_Ts Jest to właściwość wygenerowana przez system. Określa ostatni zaktualizowany znacznik czasu zasobu. Wartość jest znacznikiem czasu.
_self Jest to właściwość wygenerowana przez system. Jest to unikatowy adresowalny identyfikator URI zasobu.
_etag Jest to właściwość wygenerowana przez system, która reprezentuje zasób etag wymagany do optymistycznej kontroli współbieżności.
_token Jest to system wygenerowany token zasobu dla określonego zasobu i użytkownika. 
{  
    "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=ocPyc9QQFybITu1EqzX0kg==;w+WR1aWafB3+yZq5JSoBwgz78XDlU+k9Xiqvc+Q7TlAl1P4h4t721Cn5cjhZ9h3TSd2\/MJLy+wG+YkhDL9UlGkVv05RZGy2fMaLGdeQkWc7TShkc\/M2boPc3GXq2yiERKl5CN4AZWSOcrFhOFuuTOqF4ZdBlflmNudaakodr\/8qTip0i+a7moz1Jkc5+9iLAsDFyqTR1sirp7kAVNFbiqPdYTjNkvZUHF3nYYmRskOg=;"  
}

Przykład

GET https://contosomarketing.documents.azure.com/dbs/volcanodb/users/a_user/permissions/a_permission HTTP/1.1  
x-ms-date: Tue, 08 Dec 2015 20:03:33 GMT  
authorization: type%3dmaster%26ver%3d1.0%26sig%3dATBq0Z3UotT51ArSPrNTu0QcRSqft7HaLa8GuRYx%2f5U%3d  
Cache-Control: no-cache  
User-Agent: contoso/1.0  
x-ms-version: 2015-08-06  
Accept: application/json  
Host: contosomarketing.documents.azure.com  
Cookie: x-ms-session-token=866  
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/a_permission  
Server: Microsoft-HTTPAPI/2.0  
Strict-Transport-Security: max-age=31536000  
x-ms-last-state-change-utc: Thu, 03 Dec 2015 06:35:23.178 GMT  
etag: "00000e00-0000-0000-0000-566736980000"  
x-ms-resource-quota: permissions=2000000;  
x-ms-resource-usage: permissions=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: 0bdfba42-3b01-40b3-b066-8b16f0362581  
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:03:34 GMT  
Content-Length: 576  
  
{  
    "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=ocPyc9QQFybITu1EqzX0kg==;w+WR1aWafB3+yZq5JSoBwgz78XDlU+k9Xiqvc+Q7TlAl1P4h4t721Cn5cjhZ9h3TSd2\/MJLy+wG+YkhDL9UlGkVv05RZGy2fMaLGdeQkWc7TShkc\/M2boPc3GXq2yiERKl5CN4AZWSOcrFhOFuuTOqF4ZdBlflmNudaakodr\/8qTip0i+a7moz1Jkc5+9iLAsDFyqTR1sirp7kAVNFbiqPdYTjNkvZUHF3nYYmRskOg=;"  
}

Zobacz też

  • Last updated on