Obter um banco de dados
Para recuperar um recurso de banco de dados, execute um GET no recurso de banco de dados.
Observação
Esses artigos de referência de API mostram como criar recursos usando a API do plano de dados do Azure Cosmos DB. Com a API do plano de dados, você pode configurar opções básicas, como a política de indexação, chaves de partição como você pode com SDKs do Cosmos DB. Se você precisar de suporte completo para todos os recursos do Azure Cosmos DB, recomendamos usar o Provedor de Recursos do Cosmos DB.
Solicitação
Método | URI da solicitação | Descrição |
---|---|---|
GET | https://{databaseaccount}.documents.azure.com/dbs/{db-id} |
Observe que {databaseaccount} é o nome da conta do Azure Cosmos DB que você criou em sua assinatura. O valor {db-id} é o nome/ID gerado pelo usuário do banco de dados, não a ID gerada pelo sistema (rid). |
Cabeçalhos
Confira Cabeçalhos comuns de solicitação REST do Azure Cosmos DB para cabeçalhos usados por todas as solicitações do Cosmos DB.
Corpo
Nenhum.
Resposta
Cabeçalhos
Consulte Cabeçalhos comuns de resposta REST do Azure Cosmos DB para obter cabeçalhos retornados por todas as respostas do Cosmos DB.
Códigos de status
A tabela a seguir lista os códigos de status comuns retornados por esta operação. Para obter uma lista completa de códigos de status, consulte Códigos de status HTTP.
Código de status HTTP | Descrição |
---|---|
200 Ok | A operação foi bem-sucedida. |
404 Não Encontrado | O banco de dados não é mais um recurso, ou seja, o recurso foi excluído. |
Corpo
Propriedade | Descrição |
---|---|
id | O nome de usuário gerado exclusivo para o banco de dados. |
_Livrar | É uma propriedade gerada pelo sistema. A ID do recurso (_rid) é um identificador exclusivo que também é hierárquico de acordo com a pilha de recursos no modelo de recurso. É usado internamente para colocação e navegação para o recurso do banco de dados. |
_Ts | É uma propriedade gerada pelo sistema. Indica o último carimbo de data/hora atualizado do recurso. O valor é um carimbo de data/hora. |
_Auto | É uma propriedade gerada pelo sistema. É o URI endereçável exclusivo do recurso. |
_Etag | É uma propriedade gerada pelo sistema que representa a etag de recurso necessária para o controle de simultaneidade otimista. |
_colls | É uma propriedade gerada pelo sistema que especifica o caminho endereçável do recurso de coleções. |
_Usuários | É uma propriedade gerada pelo sistema que especifica o caminho endereçável do recurso de usuários. |
{
"id": "volcanodb",
"_rid": "Sl8fAA==",
"_ts": 1448049502,
"_self": "dbs\/Sl8fAA==\/",
"_etag": "\"00000100-0000-0000-0000-564f7b5e0000\"",
"_colls": "colls\/",
"_users": "users\/"
}
Exemplo
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\/"
}