Pobieranie bazy danych
Aby pobrać zasób bazy danych, wykonaj polecenie GET w zasobie bazy danych.
Uwaga
Te artykuły referencyjne dotyczące interfejsu API pokazują, jak tworzyć zasoby przy użyciu interfejsu API płaszczyzny danych usługi Azure Cosmos DB. Za pomocą interfejsu API płaszczyzny danych można skonfigurować podstawowe opcje, takie jak zasady indeksowania, klucze partycji, podobnie jak w przypadku zestawów SDK usługi Cosmos DB. Jeśli potrzebujesz pełnej obsługi funkcji dla wszystkich zasobów usługi Azure Cosmos DB, zalecamy użycie dostawcy zasobów usługi Cosmos DB.
Żądanie
| Metoda | Identyfikator URI żądania | Opis |
|---|---|---|
| GET | https://{databaseaccount}.documents.azure.com/dbs/{db-id} |
Pamiętaj, że {databaseaccount} jest nazwą konta usługi Azure Cosmos DB utworzonego w ramach subskrypcji. Wartość {db-id} jest wygenerowaną przez użytkownika nazwą/identyfikatorem bazy danych, a nie identyfikatorem wygenerowanym przez system (rid). |
Nagłówki
Zobacz Typowe nagłówki żądań REST usługi Azure Cosmos DB dla nagłówków , które są używane przez wszystkie żądania usługi Cosmos DB.
Treść
Brak.
Reakcja
Nagłówki
Zobacz Typowe nagłówki odpowiedzi REST usługi Azure Cosmos DB dla nagłówków zwracanych przez wszystkie odpowiedzi usługi Cosmos DB.
Kody stanu
Poniższa tabela zawiera listę typowych kodów stanu zwracanych 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 | Baza danych nie jest już zasobem, tj. zasób został usunięty. |
Treść
| Właściwość | Opis |
|---|---|
| id | Unikatowy użytkownik wygenerował nazwę bazy danych. |
| _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 zasobów bazy danych i nawigacji. |
| _Ts | Jest to właściwość wygenerowana przez system. Oznacza on ostatni zaktualizowany znacznik czasu zasobu. Wartość jest znacznikiem czasu. |
| _Własny | Jest to właściwość wygenerowana przez system. Jest to unikatowy adresowy identyfikator URI zasobu. |
| _Etag | Jest to właściwość wygenerowana przez system reprezentująca tag zasobu wymagany do optymistycznej kontroli współbieżności. |
| _colls | Jest to właściwość wygenerowana przez system, która określa ścieżkę adresową zasobu kolekcji. |
| _Użytkowników | Jest to właściwość wygenerowana przez system, która określa ścieżkę adresową zasobu użytkowników. |
{
"id": "volcanodb",
"_rid": "Sl8fAA==",
"_ts": 1448049502,
"_self": "dbs\/Sl8fAA==\/",
"_etag": "\"00000100-0000-0000-0000-564f7b5e0000\"",
"_colls": "colls\/",
"_users": "users\/"
}
Przykład
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\/"
}