Dela via

Lista databaser

Om du vill visa en lista över databaserna under databaskontot utför du en GET på databasresursen, d.v.s. dbs-URI-sökvägen.

Anteckning

Dessa API-referensartiklar visar hur du skapar resurser med azure Cosmos DB-dataplanets API. Med dataplanets API kan du konfigurera grundläggande alternativ, till exempel indexeringsprincip, partitionsnycklar ungefär som du kan med Cosmos DB SDK:er. Om du behöver fullständigt funktionsstöd för alla Azure Cosmos DB-resurser rekommenderar vi att du använder Cosmos DB-resursprovidern.

Förfrågan

Metod URI för förfrågan Beskrivning
GET https://{databaseaccount}.documents.azure.com/dbs {databaseaccount} är namnet på det Azure Cosmos DB-konto som skapats under din prenumeration.

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 AZURE Cosmos DB REST-svarshuvuden 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 har slutförts.

Brödtext

Egenskap Beskrivning
_Bli Det är en systemgenererad egenskap. Värdet _rid är tomt för den här åtgärden.
_Räkna Den här egenskapen visar antalet databaser som returneras som en del av liståtgärden.
Databaser Det här är matrisen som innehåller databaserna som returneras som en del av liståtgärden.
Egenskaper för databasresursen
id Det unika användargenererade namnet för databasen.
_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 databasresursen.
_Ts Det är en systemgenererad egenskap. Den anger resursens senast uppdaterade tidsstämpel. 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.
_colls Det är en systemgenererad egenskap som anger den adresserbara sökvägen för samlingsresursen.
_Användare Det är en systemgenererad egenskap som anger den adresserbara sökvägen för användarresursen. 
{  
    "_rid": "",  
    "Databases": [{  
        "id": "iot2",  
        "_rid": "qicAAA==",  
        "_ts": 1446192371,  
        "_self": "dbs\/qicAAA==\/",  
        "_etag": "\"00001800-0000-0000-0000-563324f30000\"",  
        "_colls": "colls\/",  
        "_users": "users\/"  
    },  
    {  
        "id": "TestDB2",  
        "_rid": "KI0YAA==",  
        "_ts": 1446243863,  
        "_self": "dbs\/KI0YAA==\/",  
        "_etag": "\"00001f00-0000-0000-0000-5633ee170000\"",  
        "_colls": "colls\/",  
        "_users": "users\/"  
    },  
    {  
        "id": "FoodDB",  
        "_rid": "vdoeAA==",  
        "_ts": 1442511602,  
        "_self": "dbs\/vdoeAA==\/",  
        "_etag": "\"00000100-0000-0000-0000-55fafaf20000\"",  
        "_colls": "colls\/",  
        "_users": "users\/"  
    }],  
    "_count": 3  
}

Exempel

GET https://contosomarketing.documents.azure.com/dbs HTTP/1.1  
x-ms-date: Tue, 08 Dec 2015 19:33:17 GMT  
x-ms-max-item-count: 3  
authorization: type%3dmaster%26ver%3d1.0%26sig%3d8aZP3gx24rXdqshQ3f4EIfwiD%2bBFxmqypnVg9GQkpwU%3d  
Cache-Control: no-cache  
User-Agent: contoso/1.0  
x-ms-version: 2015-08-06  
Accept: application/json  
Host: contosomarketing.documents.azure.com  
  

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  
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: databases=100;collections=5000;users=500000;permissions=2000000;  
x-ms-resource-usage: databases=15;collections=34;users=0;permissions=0;  
x-ms-item-count: 3  
x-ms-schemaversion: 1.1  
x-ms-session-token: 860  
x-ms-request-charge: 2  
x-ms-serviceversion: version=1.5.57.3  
x-ms-activity-id: 67b6b831-3516-46ed-a36e-6b34fb345a29  
x-ms-continuation: vdoeAA==  
x-ms-gatewayversion: version=1.5.57.3  
Date: Tue, 08 Dec 2015 19:37:57 GMT  
Content-Length: 533  
  
{  
    "_rid": "",  
    "Databases": [{  
        "id": "iot2",  
        "_rid": "qicAAA==",  
        "_ts": 1446192371,  
        "_self": "dbs\/qicAAA==\/",  
        "_etag": "\"00001800-0000-0000-0000-563324f30000\"",  
        "_colls": "colls\/",  
        "_users": "users\/"  
    },  
    {  
        "id": "TestDB2",  
        "_rid": "KI0YAA==",  
        "_ts": 1446243863,  
        "_self": "dbs\/KI0YAA==\/",  
        "_etag": "\"00001f00-0000-0000-0000-5633ee170000\"",  
        "_colls": "colls\/",  
        "_users": "users\/"  
    },  
    {  
        "id": "FoodDB",  
        "_rid": "vdoeAA==",  
        "_ts": 1442511602,  
        "_self": "dbs\/vdoeAA==\/",  
        "_etag": "\"00000100-0000-0000-0000-55fafaf20000\"",  
        "_colls": "colls\/",  
        "_users": "users\/"  
    }],  
    "_count": 3  
}

Se även