Share via

Перечисление баз данных

  • Статья

Чтобы получить список баз данных в учетной записи базы данных, выполните get для ресурса баз данных, то есть пути URI dbs.

Примечание

В этих справочных статьях по API показано, как создавать ресурсы с помощью API плоскости данных Azure Cosmos DB. С помощью API плоскости данных можно настроить базовые параметры, такие как политика индексирования, ключи секций, так же, как в пакетах SDK для Cosmos DB. Если вам требуется полная поддержка функций для всех ресурсов Azure Cosmos DB, рекомендуется использовать поставщик ресурсов Cosmos DB.

Запрос

Метод Универсальный код ресурса (URI) запроса Описание
GET https://{databaseaccount}.documents.azure.com/dbs {databaseaccount} — это имя учетной записи Azure Cosmos DB, созданной в вашей подписке.

Заголовки

Заголовки, используемые всеми запросами Cosmos DB, см. в статье Общие заголовки запросов REST Azure Cosmos DB .

Текст

Нет.

Ответ

Заголовки

Заголовки, возвращаемые всеми ответами Cosmos DB, см. в статье Общие заголовки ответов REST Azure Cosmos DB .

Коды состояния

В таблице ниже указаны стандартные коды состояния, возвращаемые этой операцией. Полный список кодов состояния см. в разделе Коды состояния HTTP.

Код состояния HTTP Описание
200 ОК Операция прошла успешно.

Текст

Свойство Описание
_Избавить Это свойство, созданное системой. Значение _rid пусто для этой операции.
_Рассчитывать Это свойство показывает число баз данных, возвращаемых как часть операции вывода списка.
Базы данных Это массив, содержащий базы данных, возвращаемые как часть операции вывода списка.
Свойства ресурса database
идентификатор Уникальное имя, созданное для базы данных.
_rid Это свойство, созданное системой. Идентификатор ресурса (_rid) — это уникальный идентификатор, который также является иерархическим для стека ресурсов в модели ресурсов. Он используется системой для размещения и перемещения к ресурсу базы данных.
_Ts Это свойство, созданное системой. Оно представляет метку времени последнего обновления ресурса. Значение — метка времени.
_Самостоятельно Это свойство, созданное системой. Это уникальный адресуемый URI для ресурса.
_etag Это созданное системой свойство, представляющее тег ресурса, необходимый для управления оптимистическим параллелизмом.
_colls Это созданное системой свойство, указывающее адресуемый путь к ресурсу коллекций.
_Пользователей Это созданное системой свойство, указывающее адресуемый путь к ресурсу users. 
{  
    "_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  
}

Пример

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  
}

См. также: