Managed Databases - Get

Служба:: SQL Database

Версия API:: 2025-01-01

Возвращает управляемую базу данных.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}?api-version=2025-01-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
databaseName	path	True	string	Имя базы данных.
managedInstanceName	path	True	string	Имя управляемого экземпляра.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя регистронезависимо.
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Ответы

Имя	Тип	Описание
200 OK	ManagedDatabase	Операция Azure успешно завершена.
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Azure Active Directory OAuth2 Flow.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

Gets a managed database

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2025-01-01

using Azure;
using Azure.ResourceManager;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/SQL/stable/2025-01-01/examples/ManagedDatabaseGet.json
// this example is just showing the usage of "ManagedDatabases_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ManagedDatabaseResource created on azure
// for more information of creating ManagedDatabaseResource, please refer to the document of ManagedDatabaseResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "Test1";
string managedInstanceName = "managedInstance";
string databaseName = "managedDatabase";
ResourceIdentifier managedDatabaseResourceId = ManagedDatabaseResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, managedInstanceName, databaseName);
ManagedDatabaseResource managedDatabase = client.GetManagedDatabaseResource(managedDatabaseResourceId);

// invoke the operation
ManagedDatabaseResource result = await managedDatabase.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ManagedDatabaseData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Пример ответа

Код состояния:: 200

{
  "name": "testdb1",
  "type": "Microsoft.Sql/managedInstances/databases",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/databases/testdb1",
  "location": "southeastasia",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "creationDate": "2017-08-04T15:00:17.73Z",
    "defaultSecondaryLocation": "North Europe",
    "isLedgerOn": false,
    "status": "Online"
  }
}

Определения

Имя	Описание
CatalogCollationType	Параметры сортировки каталога метаданных.
createdByType	Тип удостоверения, создавшего ресурс.
ErrorAdditionalInfo	Ошибка управления ресурсами дополнительная информация.
ErrorDetail	Детали ошибки.
ErrorResponse	Ответ на ошибку
InaccessibilityReason	Вид первопричины. Допустимые значения: "TransparentDataEncryption", "DatabaseReplication" и "Unknown".
ManagedDatabase	Ресурс управляемой базы данных.
ManagedDatabaseCreateMode	Режим создания управляемой базы данных. PointInTimeRestore: создайте базу данных, восстанавливая резервную копию существующей базы данных на определенный момент времени. Необходимо указать SourceDatabaseName, SourceManagedInstanceName и PointInTime. RestoreExternalBackup: создайте базу данных путем восстановления из внешних файлов резервного копирования. Необходимо указать параметры сортировки, StorageContainerUri и StorageContainerSasToken. Восстановление. Создание базы данных путем восстановления геореплицированной резервной копии. Для восстановления необходимо указать значение restoreableDatabaseId в качестве идентификатора ресурса базы данных для восстановления. RestoreLongTermRetentionBackup: создайте базу данных путем восстановления из долгосрочного резервного копирования хранения (требуется longTermRetentionBackupResourceId).
ManagedDatabaseExtendedAccessibilityInfo	Расширенная информация о доступности управляемой базы данных
ManagedDatabaseStatus	Состояние базы данных.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.

CatalogCollationType

Перечисление

Параметры сортировки каталога метаданных.

Значение	Описание
DATABASE_DEFAULT	DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS	SQL_Latin1_General_CP1_CI_AS

createdByType

Перечисление

Тип удостоверения, создавшего ресурс.

Значение	Описание
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Объект

Ошибка управления ресурсами дополнительная информация.

Имя	Тип	Описание
info	object	Дополнительная информация.
type	string	Тип дополнительной информации.

ErrorDetail

Объект

Детали ошибки.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Ошибка дополнительная информация.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Объект

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

InaccessibilityReason

Перечисление

Вид первопричины. Допустимые значения: "TransparentDataEncryption", "DatabaseReplication" и "Unknown".

Значение	Описание
Unknown	Неизвестно
TransparentDataEncryption	Прозрачное шифрование данных
DatabaseReplication	DatabaseReplication

ManagedDatabase

Объект

Ресурс управляемой базы данных.

Имя	Тип	Описание
id	string (arm-id)	Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Географическое расположение, в котором находится ресурс
name	string	Имя ресурса
properties.autoCompleteRestore	boolean	Выполняется ли автоматическое восстановление этой управляемой базы данных.
properties.catalogCollation	CatalogCollationType	Параметры сортировки каталога метаданных.
properties.collation	string	Параметры сортировки управляемой базы данных.
properties.createMode	ManagedDatabaseCreateMode	Режим создания управляемой базы данных. PointInTimeRestore: создайте базу данных, восстанавливая резервную копию существующей базы данных на определенный момент времени. Необходимо указать SourceDatabaseName, SourceManagedInstanceName и PointInTime. RestoreExternalBackup: создайте базу данных путем восстановления из внешних файлов резервного копирования. Необходимо указать параметры сортировки, StorageContainerUri и StorageContainerSasToken. Восстановление. Создание базы данных путем восстановления геореплицированной резервной копии. Для восстановления необходимо указать значение restoreableDatabaseId в качестве идентификатора ресурса базы данных для восстановления. RestoreLongTermRetentionBackup: создайте базу данных путем восстановления из долгосрочного резервного копирования хранения (требуется longTermRetentionBackupResourceId).
properties.creationDate	string (date-time)	Дата создания базы данных.
properties.crossSubscriptionRestorableDroppedDatabaseId	string	Восстанавливаемый идентификатор ресурса базы данных, который можно восстановить при создании этой базы данных.
properties.crossSubscriptionSourceDatabaseId	string	Идентификатор ресурса базы данных-источника между подписками, связанной с операцией создания этой базы данных.
properties.crossSubscriptionTargetManagedInstanceId	string	Идентификатор целевого управляемого экземпляра, используемый в восстановлении между подписками.
properties.defaultSecondaryLocation	string	Геопарный регион.
properties.earliestRestorePoint	string (date-time)	Самая ранняя точка восстановления во времени для восстановления на определенный момент времени.
properties.extendedAccessibilityInfo	ManagedDatabaseExtendedAccessibilityInfo	Дополнительная информация о наблюдении и устранении неполадок для баз данных в состоянии «Недоступно».
properties.failoverGroupId	string	Идентификатор ресурса группы отработки отказа экземпляра, к которому принадлежит эта управляемая база данных.
properties.isLedgerOn	boolean	Независимо от того, является ли эта база данных базой данных реестра, то есть все таблицы в базе данных являются таблицами реестра. Примечание. Значение этого свойства невозможно изменить после создания базы данных.
properties.lastBackupName	string	Последнее имя файла резервной копии для восстановления этой управляемой базы данных.
properties.longTermRetentionBackupResourceId	string	Имя резервной копии долгосрочного хранения, используемой для восстановления этой управляемой базы данных.
properties.recoverableDatabaseId	string	Идентификатор ресурса восстанавливаемой базы данных, связанной с операцией создания этой базы данных.
properties.restorableDroppedDatabaseId	string	Восстанавливаемый идентификатор ресурса базы данных для восстановления при создании этой базы данных.
properties.restorePointInTime	string (date-time)	Conditional. Если createMode имеет значение PointInTimeRestore, это значение необходимо. Указывает точку во времени (ISO8601 формате) исходной базы данных, которая будет восстановлена для создания новой базы данных.
properties.sourceDatabaseId	string	Идентификатор ресурса исходной базы данных, связанной с операцией создания этой базы данных.
properties.status	ManagedDatabaseStatus	Состояние базы данных.
properties.storageContainerIdentity	string	Conditional. Если createMode — RestoreExternalBackup, это значение используется. Указывает удостоверение, используемое для проверки подлинности контейнера хранилища. Может быть "SharedAccessSignature" или "ManagedIdentity"; Значение , если не указано значение SharedAccessSignature.
properties.storageContainerSasToken	string	Conditional. Если createMode — RestoreExternalBackup и storageContainerIdentity не managedIdentity, это значение необходимо. Указывает маркер sas контейнера хранилища.
properties.storageContainerUri	string	Conditional. Если createMode — RestoreExternalBackup, это значение необходимо. Указывает универсальный код ресурса (URI) контейнера хранилища, в котором хранятся резервные копии для этого восстановления.
systemData	systemData	Azure Resource Manager метаданные, содержащие информацию createdBy и modifiedBy.
tags	object	Теги ресурсов.
type	string	Тип ресурса. Например, «Майкрософт. Compute/virtualMachines» или «Майкрософт. Аккаунты хранения/хранения»

ManagedDatabaseCreateMode

Перечисление

Режим создания управляемой базы данных. PointInTimeRestore: создайте базу данных, восстанавливая резервную копию существующей базы данных на определенный момент времени. Необходимо указать SourceDatabaseName, SourceManagedInstanceName и PointInTime. RestoreExternalBackup: создайте базу данных путем восстановления из внешних файлов резервного копирования. Необходимо указать параметры сортировки, StorageContainerUri и StorageContainerSasToken. Восстановление. Создание базы данных путем восстановления геореплицированной резервной копии. Для восстановления необходимо указать значение restoreableDatabaseId в качестве идентификатора ресурса базы данных для восстановления. RestoreLongTermRetentionBackup: создайте базу данных путем восстановления из долгосрочного резервного копирования хранения (требуется longTermRetentionBackupResourceId).

Значение	Описание
Default	По умолчанию
RestoreExternalBackup	RestoreExternalBackup
PointInTimeRestore	PointInTimeRestore
Recovery	Восстановление
RestoreLongTermRetentionBackup	RestoreLongTermRetentionBackup

ManagedDatabaseExtendedAccessibilityInfo

Объект

Расширенная информация о доступности управляемой базы данных

Имя	Тип	Описание
inaccessibilityReasonDescription	string	Объяснение основной причины и меры по ее устранению.
inaccessibilityReasonErrorCode	string	Код ошибки SQL Server, связанный с коренной причиной недоступности.
inaccessibilityReasonKind	InaccessibilityReason	Вид первопричины. Допустимые значения: "TransparentDataEncryption", "DatabaseReplication" и "Unknown".
inaccessibilityReasonTdeKeyUri	string	Для основной причины типа "TransparentDataEncryption" используется универсальный код ресурса (URI) CMK.

ManagedDatabaseStatus

Перечисление

Состояние базы данных.

Значение	Описание
Online	Онлайн
Offline	Не в сети
Shutdown	Завершение работы
Creating	Создавать
Inaccessible	Недосягаемый
Restoring	Восстановление
Updating	Обновление
Stopping	Остановка
Stopped	Остановился
Starting	Запуск
DbMoving	DbMoving
DbCopying	Копирование базы

systemData

Объект

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string (date-time)	Временная метка последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.