Servers - Import Database
Импортирует bacpac в новую базу данных.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/import?api-version=2025-01-01
Параметры URI
| Имя | В | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Имя группы ресурсов. Имя регистронезависимо. |
|
server
|
path | True |
string |
Имени сервера. |
|
subscription
|
path | True |
string (uuid) |
Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID). |
|
api-version
|
query | True |
string minLength: 1 |
Версия API, используемая для данной операции. |
Текст запроса
| Имя | Обязательно | Тип | Описание |
|---|---|---|---|
| administratorLogin | True |
string |
Имя входа администратора. Если AuthenticationType является ManagedIdentity, это поле должно указать идентификатор ресурса управляемого удостоверения. |
| storageKey | True |
string |
Ключ хранилища для учетной записи хранения. Если StorageKeyType является ManagedIdentity, это поле должно указать идентификатор ресурса управляемого удостоверения. |
| storageKeyType | True |
Тип ключа хранилища: StorageAccessKey, SharedAccessKey или ManagedIdentity. |
|
| storageUri | True |
string |
Uri хранилища. |
| administratorLoginPassword |
string (password) |
Пароль для входа администратора. Если AuthenticationType является ManagedIdentity, это поле не должно быть указано. |
|
| authenticationType |
string |
Тип учетных данных, предоставляемых для доступа к целевому СЕРВЕРУ SQL: SQL, ADPassword или ManagedIdentity. |
|
| databaseName |
string |
Имя базы данных импорта. |
|
| edition |
string |
Выпуск базы данных импорта. |
|
| maxSizeBytes |
string |
Максимальный размер в байтах для базы данных импорта. |
|
| networkIsolation |
Необязательные сведения о ресурсах для включения сетевой изоляции для запроса. |
||
| serviceObjectiveName |
string |
Имя целевой цели уровня обслуживания базы данных импорта. |
Ответы
| Имя | Тип | Описание |
|---|---|---|
| 200 OK |
Операция Azure успешно завершена. |
|
| 202 Accepted |
Операция ресурса принята. Заголовки
|
|
| Other Status Codes |
Непредвиденное сообщение об ошибке. |
Безопасность
azure_auth
Azure Active Directory OAuth2 Flow.
Тип:
oauth2
Flow:
implicit
URL-адрес авторизации:
https://login.microsoftonline.com/common/oauth2/authorize
Области
| Имя | Описание |
|---|---|
| user_impersonation | олицетворения учетной записи пользователя |
Примеры
Imports to a new database, using Managed Identity for the SQL server and storage account.
Образец запроса
POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/import?api-version=2025-01-01
{
"administratorLogin": "/subscriptions/00000000-1111-2222-3333-444444444444/resourcegroups/rgName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identityName",
"authenticationType": "ManagedIdentity",
"databaseName": "testdb",
"storageKey": "/subscriptions/00000000-1111-2222-3333-444444444444/resourcegroups/rgName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identityName",
"storageKeyType": "ManagedIdentity",
"storageUri": "https://test.blob.core.windows.net/test.bacpac"
}
Пример ответа
{
"name": "9d9a794a-5cec-4f23-af70-d29511b522a4",
"type": "Microsoft.Sql/servers/databases/importExportOperationResults",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/importExportOperationResults/9d9a794a-5cec-4f23-af70-d29511b522a4",
"properties": {
"blobUri": "https://test.blob.core.windows.net/test.bacpac",
"databaseName": "testdb",
"lastModifiedTime": "2/2/2020 8:34:47 PM",
"queuedTime": "2/2/2020 8:33:27 PM",
"requestId": "9d9a794a-5cec-4f23-af70-d29511b522a4",
"requestType": "Import",
"serverName": "testsvr.database.windows.net",
"status": "Completed"
}
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/importExportOperationResults/00000000-0000-0000-0000-000000000000?api-version=2022-08-01
Imports to a new database, using private link for the SQL server and storage account.
Образец запроса
POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/import?api-version=2025-01-01
{
"administratorLogin": "login",
"administratorLoginPassword": "password",
"authenticationType": "Sql",
"databaseName": "testdb",
"networkIsolation": {
"sqlServerResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr",
"storageAccountResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Storage/storageAccounts/test-privatelink"
},
"storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==",
"storageKeyType": "StorageAccessKey",
"storageUri": "https://test.blob.core.windows.net/test.bacpac"
}
Пример ответа
{
"name": "9d9a794a-5cec-4f23-af70-d29511b522a4",
"type": "Microsoft.Sql/servers/databases/importExportOperationResults",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/importExportOperationResults/9d9a794a-5cec-4f23-af70-d29511b522a4",
"properties": {
"blobUri": "https://test.blob.core.windows.net/test.bacpac",
"databaseName": "testdb",
"lastModifiedTime": "2/2/2020 8:34:47 PM",
"queuedTime": "2/2/2020 8:33:27 PM",
"requestId": "9d9a794a-5cec-4f23-af70-d29511b522a4",
"requestType": "Import",
"serverName": "testsvr.database.windows.net",
"status": "Completed"
}
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/importExportOperationResults/00000000-0000-0000-0000-000000000000?api-version=2022-08-01
Imports to a new database.
Образец запроса
POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/import?api-version=2025-01-01
{
"administratorLogin": "login",
"administratorLoginPassword": "password",
"authenticationType": "Sql",
"databaseName": "testdb",
"storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==",
"storageKeyType": "StorageAccessKey",
"storageUri": "https://test.blob.core.windows.net/test.bacpac"
}
Пример ответа
{
"name": "9d9a794a-5cec-4f23-af70-d29511b522a4",
"type": "Microsoft.Sql/servers/databases/importExportOperationResults",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/importExportOperationResults/9d9a794a-5cec-4f23-af70-d29511b522a4",
"properties": {
"blobUri": "https://test.blob.core.windows.net/test.bacpac",
"databaseName": "testdb",
"lastModifiedTime": "2/2/2020 8:34:47 PM",
"queuedTime": "2/2/2020 8:33:27 PM",
"requestId": "9d9a794a-5cec-4f23-af70-d29511b522a4",
"requestType": "Import",
"serverName": "testsvr.database.windows.net",
"status": "Completed"
}
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/importExportOperationResults/00000000-0000-0000-0000-000000000000?api-version=2022-08-01
Определения
| Имя | Описание |
|---|---|
|
created |
Тип удостоверения, создавшего ресурс. |
|
Error |
Ошибка управления ресурсами дополнительная информация. |
|
Error |
Детали ошибки. |
|
Error |
Ответ на ошибку |
|
Import |
Ресурс результата операции ImportExport. |
|
Import |
Содержит сведения, необходимые для выполнения операции импорта для новой базы данных. |
|
Network |
Содержит ресурсы ARM, для которых необходимо создать подключение к частной конечной точке. |
|
Private |
Содержит состояние запросов подключения к частной конечной точке. |
|
Storage |
Тип ключа хранилища: StorageAccessKey, SharedAccessKey или ManagedIdentity. |
|
system |
Метаданные, относящиеся к созданию и последнему изменении ресурса. |
createdByType
Тип удостоверения, создавшего ресурс.
| Значение | Описание |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Ошибка управления ресурсами дополнительная информация.
| Имя | Тип | Описание |
|---|---|---|
| info |
object |
Дополнительная информация. |
| type |
string |
Тип дополнительной информации. |
ErrorDetail
Детали ошибки.
| Имя | Тип | Описание |
|---|---|---|
| additionalInfo |
Ошибка дополнительная информация. |
|
| code |
string |
Код ошибки. |
| details |
Сведения об ошибке. |
|
| message |
string |
Сообщение об ошибке. |
| target |
string |
Целевой объект ошибки. |
ErrorResponse
Ответ на ошибку
| Имя | Тип | Описание |
|---|---|---|
| error |
Объект ошибки. |
ImportExportOperationResult
Ресурс результата операции ImportExport.
| Имя | Тип | Описание |
|---|---|---|
| id |
string (arm-id) |
Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Имя ресурса |
| properties.blobUri |
string |
Универсальный код ресурса (URI) BLOB-объектов. |
| properties.databaseName |
string |
Имя базы данных. |
| properties.errorMessage |
string |
Сообщение об ошибке. |
| properties.lastModifiedTime |
string |
Время последнего изменения. |
| properties.privateEndpointConnections |
Возвращает состояние частных конечных точек, связанных с этим запросом. |
|
| properties.queuedTime |
string |
Время в очереди. |
| properties.requestId |
string (uuid) |
Идентификатор запроса. |
| properties.requestType |
string |
Тип запроса. |
| properties.serverName |
string |
Имя сервера. |
| properties.status |
string |
Состояние операции. |
| systemData |
Azure Resource Manager метаданные, содержащие информацию createdBy и modifiedBy. |
|
| type |
string |
Тип ресурса. Например, «Майкрософт. Compute/virtualMachines» или «Майкрософт. Аккаунты хранения/хранения» |
ImportNewDatabaseDefinition
Содержит сведения, необходимые для выполнения операции импорта для новой базы данных.
| Имя | Тип | Описание |
|---|---|---|
| administratorLogin |
string |
Имя входа администратора. Если AuthenticationType является ManagedIdentity, это поле должно указать идентификатор ресурса управляемого удостоверения. |
| administratorLoginPassword |
string (password) |
Пароль для входа администратора. Если AuthenticationType является ManagedIdentity, это поле не должно быть указано. |
| authenticationType |
string |
Тип учетных данных, предоставляемых для доступа к целевому СЕРВЕРУ SQL: SQL, ADPassword или ManagedIdentity. |
| databaseName |
string |
Имя базы данных импорта. |
| edition |
string |
Выпуск базы данных импорта. |
| maxSizeBytes |
string |
Максимальный размер в байтах для базы данных импорта. |
| networkIsolation |
Необязательные сведения о ресурсах для включения сетевой изоляции для запроса. |
|
| serviceObjectiveName |
string |
Имя целевой цели уровня обслуживания базы данных импорта. |
| storageKey |
string |
Ключ хранилища для учетной записи хранения. Если StorageKeyType является ManagedIdentity, это поле должно указать идентификатор ресурса управляемого удостоверения. |
| storageKeyType |
Тип ключа хранилища: StorageAccessKey, SharedAccessKey или ManagedIdentity. |
|
| storageUri |
string |
Uri хранилища. |
NetworkIsolationSettings
Содержит ресурсы ARM, для которых необходимо создать подключение к частной конечной точке.
| Имя | Тип | Описание |
|---|---|---|
| sqlServerResourceId |
string (arm-id) |
Идентификатор ресурса для SQL Server, который является целевым объектом этого запроса. Если задано, для SQL Server будет создано подключение к частной конечной точке. Должен соответствовать серверу, который является целевым объектом операции. |
| storageAccountResourceId |
string (arm-id) |
Идентификатор ресурса для учетной записи хранения, используемой для хранения BACPAC-файла. Если задано, для учетной записи хранения будет создано подключение частной конечной точки. Должен соответствовать учетной записи хранения, используемой для параметра StorageUri. |
PrivateEndpointConnectionRequestStatus
Содержит состояние запросов подключения к частной конечной точке.
| Имя | Тип | Описание |
|---|---|---|
| privateEndpointConnectionName |
string |
Имя подключения для частной конечной точки. |
| privateLinkServiceId |
string |
Идентификатор ресурса, для которого создается частная конечная точка. |
| status |
string |
Состояние подключения к частной конечной точке. |
StorageKeyType
Тип ключа хранилища: StorageAccessKey, SharedAccessKey или ManagedIdentity.
| Значение | Описание |
|---|---|
| SharedAccessKey |
Ключ совместного доступа |
| StorageAccessKey |
StorageAccessKey |
| ManagedIdentity |
ManagedIdentity |
systemData
Метаданные, относящиеся к созданию и последнему изменении ресурса.
| Имя | Тип | Описание |
|---|---|---|
| createdAt |
string (date-time) |
Метка времени создания ресурса (UTC). |
| createdBy |
string |
Удостоверение, создающее ресурс. |
| createdByType |
Тип удостоверения, создавшего ресурс. |
|
| lastModifiedAt |
string (date-time) |
Временная метка последнего изменения ресурса (UTC) |
| lastModifiedBy |
string |
Идентификатор, который последний раз изменил ресурс. |
| lastModifiedByType |
Тип удостоверения, который последний раз изменил ресурс. |