Listbehörigheter

  • Artikel

Om du vill visa en lista över behörighetsresursen för en viss databas utför du en GET-åtgärd på URI-sökvägen för behörigheter, som returnerar en lista över behörigheter för användaren. Alla resurstoken återskapas för respektive behörighet som returneras som en del av svaret. De nya token har standard giltighetsperioden (en timme) om den inte åsidosätts.

Förfrågan

Metod URI för förfrågan Beskrivning
GET https://{databaseaccount}.documents.azure.com/dbs/{db-id}/users/{user-name}/permissions Observera att {databaseaccount} är namnet på det Azure Cosmos DB-konto som skapades under din prenumeration. Värdet {db-id} är det användargenererade namnet/ID:t för databasen, inte det systemgenererade ID:t (rid). Värdet {user-name} är namnet på användaren.

Sidhuvuden

Se Vanliga Azure Cosmos DBREST-begärandehuvuden för rubriker som används av alla Azure Cosmos DB-begäranden.

Brödtext

Inga.

Svarsåtgärder

Sidhuvuden

Se Vanliga Azure Cosmos DB-svarshuvuden för rubriker som returneras av alla Azure Cosmos DB-svar.

Statuskoder

I följande tabell visas vanliga statuskoder som returneras av den här åtgärden. En fullständig lista över statuskoder finns i HTTP-statuskoder.

Kod Description
200 Ok Åtgärden lyckades.

Brödtext

Egenskap Beskrivning
_Bli Det här är resurs-ID:t för den användare som äger behörigheterna.
_Räkna Den här egenskapen visar antalet användare som returneras som en del av liståtgärden.
Behörigheter Det här är matrisen som innehåller de behörigheter som returneras som en del av liståtgärden.
id Användaren genererade ett unikt namn för behörigheten.
permissionMode Åtkomstläget på resursen för användaren: Alla eller Läsa. Alla ger läs-, skriv- och borttagningsåtkomst till en resurs. Läsning begränsar användarens läsbehörighet till resursen.
Resurs Den fullständiga adresserbara sökvägen för resursen som är associerad med behörigheten. Till exempel dbs/volcanodb/colls/volcano1.
_Bli Det här är en systemgenererad egenskap. Resurs-ID :t (_rid) är en unik identifierare som också är hierarkisk per resursstacken i resursmodellen. Den används internt för placering av och navigering till användarresursen.
_Ts Det här är en systemgenererad egenskap. Den anger den senast uppdaterade tidsstämpeln för resursen. Värdet är en tidsstämpel.
_Själv Det här är en systemgenererad egenskap. Det är den unika adresserbara URI:n för resursen.
_Etag Det här är en systemgenererad egenskap som representerar resursetaggen som krävs för optimistisk samtidighetskontroll.
_Token Det här är en systemgenererad resurstoken för den specifika resursen och användaren. 
{  
    "_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  
}

Exempel

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  
}

Se även