List Databases
Per elencare i database nell'account del database, eseguire un get nella risorsa database, ovvero il percorso dell'URI dbs.
Nota
Questi articoli di riferimento sulle API illustrano come creare risorse usando l'API del piano dati di Azure Cosmos DB. Con l'API del piano dati è possibile configurare opzioni di base, ad esempio criteri di indicizzazione, chiavi di partizione molto simili a quelle che è possibile usare gli SDK di Cosmos DB. Se è necessario il supporto completo delle funzionalità per tutte le risorse di Azure Cosmos DB, è consigliabile usare il provider di risorse Cosmos DB.
Richiesta
| Metodo | URI richiesta | Descrizione |
|---|---|---|
| GET | https://{databaseaccount}.documents.azure.com/dbs |
{databaseaccount} è il nome dell'account Azure Cosmos DB creato nella sottoscrizione. |
Intestazioni
Vedere Intestazioni di richiesta REST di Azure Cosmos DB comuni per le intestazioni usate da tutte le richieste di Cosmos DB.
Corpo
Nessuno.
Risposta
Intestazioni
Vedere Intestazioni di risposta REST di Azure Cosmos DB comuni per le intestazioni restituite da tutte le risposte di Cosmos DB.
Codici di stato
La seguente tabella elenca i codici di stato comuni restituiti da questa operazione. Per un elenco completo dei codici di stato, vedere Codici di stato HTTP.
| Codice di stato HTTP | Descrizione |
|---|---|
| 200 - OK | L'operazione è riuscita. |
Corpo
| Proprietà | Descrizione |
|---|---|
| _liberarsi | Si tratta di una proprietà generata dal sistema. Il valore _rid è vuoto per questa operazione. |
| _Conteggio | Questa proprietà indica il numero di database restituiti come parte dell'operazione di elenco. |
| Database | Questa è la matrice contenente i database restituiti come parte dell'operazione di elenco. Proprietà della risorsa database |
| id | Nome univoco generato dall'utente per il database. |
| _rid | Si tratta di una proprietà generata dal sistema. L'ID risorsa (_rid) è un identificatore univoco che è anche gerarchico per ogni stack di risorse nel modello di risorsa. Viene usato internamente per il posizionamento e l'esplorazione della risorsa database. |
| _Ts | Si tratta di una proprietà generata dal sistema. Indica il timestamp dell'ultimo aggiornamento della risorsa. Il valore è un timestamp. |
| _stesso | Si tratta di una proprietà generata dal sistema. URI indirizzabile univoco per la risorsa. |
| _Etag | Si tratta di una proprietà generata dal sistema che rappresenta l'etag della risorsa necessaria per il controllo di concorrenza ottimistica. |
| _colls | Si tratta di una proprietà generata dal sistema che specifica il percorso indirizzabile della risorsa delle raccolte. |
| _Gli utenti | Si tratta di una proprietà generata dal sistema che specifica il percorso indirizzabile della risorsa utenti. |
{
"_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
}
Esempio
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
}