Hämta en databas

  • Artikel

Om du vill hämta en databasresurs utför du en GET på databasresursen.

Anteckning

Dessa API-referensartiklar visar hur du skapar resurser med hjälp av Azure Cosmos DB-dataplans-API:et. Med API:et för dataplanet 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/{db-id} Observera att {databaseaccount} är namnet på det Azure Cosmos DB-konto som du skapade 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.
404 – Hittades inte Databasen är inte längre en resurs, d.v.s. resursen har tagits bort.

Brödtext

Egenskap Beskrivning
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. Det används internt för placering av och navigering till databasresursen.
_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.
_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. 
{  
    "id": "volcanodb",  
    "_rid": "Sl8fAA==",  
    "_ts": 1448049502,  
    "_self": "dbs\/Sl8fAA==\/",  
    "_etag": "\"00000100-0000-0000-0000-564f7b5e0000\"",  
    "_colls": "colls\/",  
    "_users": "users\/"  
}

Exempel

GET https://contosomarketing.documents.azure.com/dbs/volcanodb HTTP/1.1  
x-ms-date: Tue, 08 Dec 2015 19:41:22 GMT  
authorization: type%3dmaster%26ver%3d1.0%26sig%3d0kZDPXylaMLpTI%2bxJYe7Xk5HiSv%2bX%2bpUGPKBMtY3My8%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/volcanodb  
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  
etag: "00000100-0000-0000-0000-564f7b5e0000"  
x-ms-resource-quota: databases=100;  
x-ms-resource-usage: databases=15;  
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: d319e186-8e5f-4861-bcd0-59fb249769f3  
x-ms-gatewayversion: version=1.5.57.3  
Date: Tue, 08 Dec 2015 19:41:21 GMT  
Content-Length: 168  
  
{  
    "id": "volcanodb",  
    "_rid": "Sl8fAA==",  
    "_ts": 1448049502,  
    "_self": "dbs\/Sl8fAA==\/",  
    "_etag": "\"00000100-0000-0000-0000-564f7b5e0000\"",  
    "_colls": "colls\/",  
    "_users": "users\/"  
}

Se även