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

Имя В Обязательно Тип Описание
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Имя группы ресурсов. Имя регистронезависимо.

serverName
path True

string

Имени сервера.

subscriptionId
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

StorageKeyType

Тип ключа хранилища: 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

NetworkIsolationSettings

Необязательные сведения о ресурсах для включения сетевой изоляции для запроса.

serviceObjectiveName

string

Имя целевой цели уровня обслуживания базы данных импорта.

Ответы

Имя Тип Описание
200 OK

ImportExportOperationResult

Операция Azure успешно завершена.

202 Accepted

Операция ресурса принята.

Заголовки

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Непредвиденное сообщение об ошибке.

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

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.
Imports to a new database, using private link for the SQL server and storage account.
Imports to a new database.

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

Образец запроса

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

Определения

Имя Описание
createdByType

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

ErrorAdditionalInfo

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

ErrorDetail

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

ErrorResponse

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

ImportExportOperationResult

Ресурс результата операции ImportExport.

ImportNewDatabaseDefinition

Содержит сведения, необходимые для выполнения операции импорта для новой базы данных.

NetworkIsolationSettings

Содержит ресурсы ARM, для которых необходимо создать подключение к частной конечной точке.

PrivateEndpointConnectionRequestStatus

Содержит состояние запросов подключения к частной конечной точке.

StorageKeyType

Тип ключа хранилища: StorageAccessKey, SharedAccessKey или ManagedIdentity.

systemData

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

createdByType

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

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

ErrorAdditionalInfo

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

Имя Тип Описание
info

object

Дополнительная информация.

type

string

Тип дополнительной информации.

ErrorDetail

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

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

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

code

string

Код ошибки.

details

ErrorDetail[]

Сведения об ошибке.

message

string

Сообщение об ошибке.

target

string

Целевой объект ошибки.

ErrorResponse

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

Имя Тип Описание
error

ErrorDetail

Объект ошибки.

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

PrivateEndpointConnectionRequestStatus[]

Возвращает состояние частных конечных точек, связанных с этим запросом.

properties.queuedTime

string

Время в очереди.

properties.requestId

string (uuid)

Идентификатор запроса.

properties.requestType

string

Тип запроса.

properties.serverName

string

Имя сервера.

properties.status

string

Состояние операции.

systemData

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

NetworkIsolationSettings

Необязательные сведения о ресурсах для включения сетевой изоляции для запроса.

serviceObjectiveName

string

Имя целевой цели уровня обслуживания базы данных импорта.

storageKey

string

Ключ хранилища для учетной записи хранения. Если StorageKeyType является ManagedIdentity, это поле должно указать идентификатор ресурса управляемого удостоверения.

storageKeyType

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

createdByType

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

lastModifiedAt

string (date-time)

Временная метка последнего изменения ресурса (UTC)

lastModifiedBy

string

Идентификатор, который последний раз изменил ресурс.

lastModifiedByType

createdByType

Тип удостоверения, который последний раз изменил ресурс.