Visa användare

  • Artikel

Om du vill returnera en lista över användare under en databas utför du en GET-åtgärd på användarresursen för en viss databas, d.v.s. användarens URI-sökväg.

Förfrågan

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

Sidhuvuden

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

Brödtext

Inga.

Svarsåtgärder

Sidhuvuden

Se Vanliga REST-svarshuvuden för Azure Cosmos DB för rubriker som returneras av alla 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.

HTTP-statuskod Beskrivning
200 Ok Åtgärden lyckades.

Brödtext

Egenskap Beskrivning
_Bli Det är resurs-ID:t för databasen där användarna har skapats.
_Räkna Den här egenskapen visar antalet användare som returneras som en del av liståtgärden.
Användare Det är matrisen som innehåller de användare som returneras som en del av liståtgärden.

Egenskaper för användarresursen
id Det unika användargenererade namnet för användaren.
_Bli Det ä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 är en systemgenererad egenskap. Den anger den senast uppdaterade tidsstämpeln för resursen. Värdet är en tidsstämpel.
_Själv Det är en systemgenererad egenskap. Det är den unika adresserbara URI:n för resursen.
_Etag Det är en systemgenererad egenskap som representerar resursetaggen som krävs för optimistisk samtidighetskontroll.
_Behörigheter Det är en systemgenererad egenskap som anger den adresserbara sökvägen för behörighetsresursen. 
{  
    "_rid": "Sl8fAA==",  
    "Users": [{  
        "id": "a_user",  
        "_rid": "Sl8fAFEKCQA=",  
        "_ts": 1449603893,  
        "_self": "dbs\/Sl8fAA==\/users\/Sl8fAFEKCQA=\/",  
        "_etag": "\"00000b00-0000-0000-0000-566733350000\"",  
        "_permissions": "permissions\/"  
    }],  
    "_count": 1  
}

Exempel

GET https://contosomarketing.documents.azure.com/dbs/volcanodb/users HTTP/1.1  
x-ms-date: Tue, 08 Dec 2015 19:47:28 GMT  
authorization: type%3dmaster%26ver%3d1.0%26sig%3due2e%2fHxTsLU%2fEftrjRd176ku%2bKC5efuw8CHzy7B4%2bTc%3d  
Cache-Control: no-cache  
User-Agent: contoso/1.0  
x-ms-version: 2015-08-06  
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  
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  
x-ms-resource-quota: users=500000;  
x-ms-resource-usage: users=2;  
x-ms-item-count: 1  
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: ed9bf479-65fe-48f6-923f-572920b57c21  
x-ms-gatewayversion: version=1.5.57.3  
Date: Tue, 08 Dec 2015 19:47:28 GMT  
Content-Length: 224  
  
{  
    "_rid": "Sl8fAA==",  
    "Users": [{  
        "id": "a_user",  
        "_rid": "Sl8fAFEKCQA=",  
        "_ts": 1449603893,  
        "_self": "dbs\/Sl8fAA==\/users\/Sl8fAFEKCQA=\/",  
        "_etag": "\"00000b00-0000-0000-0000-566733350000\"",  
        "_permissions": "permissions\/"  
    }],  
    "_count": 1  
}

Se även