Listar Bases de Dados
Para listar as bases de dados na conta de base de dados, execute um GET no recurso de bases de dados, ou seja, o caminho do URI de dbs.
Nota
Estes artigos de referência da API mostram como criar recursos com a API do plano de dados do Azure Cosmos DB. Com a API do plano de dados, pode configurar opções básicas, como a política de indexação, chaves de partição tal como com os SDKs do Cosmos DB. Se precisar de suporte completo de funcionalidades para todos os recursos do Azure Cosmos DB, recomendamos que utilize o Fornecedor de Recursos do Cosmos DB.
Pedir
| Método | URI do pedido | Descrição |
|---|---|---|
| GET | https://{databaseaccount}.documents.azure.com/dbs |
A {databaseaccount} é o nome da conta do Azure Cosmos DB criada na sua subscrição. |
Cabeçalhos
Veja Common Azure Cosmos DB REST request headers for headers that are used by all Cosmos DB requests (Cabeçalhos de pedido REST do Azure Cosmos DB comuns para cabeçalhos que são utilizados por todos os pedidos do Cosmos DB).
Corpo
Nenhum.
Resposta
Cabeçalhos
Veja Common Azure Cosmos DB REST response headers for headers that are returned by all Cosmos DB responses (Cabeçalhos de resposta REST do Azure Cosmos DB comuns para cabeçalhos devolvidos por todas as respostas do Cosmos DB).
Códigos de estado
A tabela seguinte lista os códigos de estado comuns devolvidos por esta operação. Para obter uma lista completa dos códigos de estado, veja Códigos de Estado HTTP.
| Código de estado de HTTP | Descrição |
|---|---|
| 200 OK | A operação foi efetuada com êxito. |
Corpo
| Propriedade | Descrição |
|---|---|
| _rid | É uma propriedade gerada pelo sistema. O valor _rid está vazio para esta operação. |
| _count | Esta propriedade mostra o número de bases de dados devolvidas como parte da operação de lista. |
| Bases de dados | Esta é a matriz que contém as bases de dados devolvidas como parte da operação de lista. Propriedades do recurso da base de dados |
| id | O nome exclusivo gerado pelo utilizador para a base de dados. |
| _rid | É uma propriedade gerada pelo sistema. O ID do recurso (_rid) é um identificador exclusivo que também é hierárquico de acordo com a pilha de recursos no modelo de recursos. É utilizado internamente para colocação e navegação no recurso da base de dados. |
| _ts | É uma propriedade gerada pelo sistema. Especifica o último carimbo de data/hora atualizado do recurso. O valor é um carimbo de data/hora. |
| _self | É uma propriedade gerada pelo sistema. É o URI endereçável exclusivo para o recurso. |
| _etag | É uma propriedade gerada pelo sistema que representa a etag de recursos necessária para o controlo de simultaneidade otimista. |
| _colls | É uma propriedade gerada pelo sistema que especifica o caminho endereçável do recurso de coleções. |
| _users | É uma propriedade gerada pelo sistema que especifica o caminho endereçável do recurso dos utilizadores. |
{
"_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
}
Exemplo
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
}