Поделиться через

Databases - Export

  • Ссылка
Служба:
SQL Database
Версия API:
2021-11-01

Экспортирует базу данных.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/export?api-version=2021-11-01

Параметры URI

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

string

Имя базы данных.
resourceGroupName
 path True

string

Имя группы ресурсов, к которой относится ресурс. Это значение можно получить от API-интерфейса диспетчера ресурсов Azure или портала.
serverName
 path True

string

Имя сервера.
subscriptionId
 path True

string

Идентификатор подписки Azure.
api-version
 query True

string

Версия API для использования в запросе.

Текст запроса

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

string

Имя входа администратора.
administratorLoginPassword True

string

Пароль для входа администратора.
storageKey True

string

Ключ хранилища.
storageKeyType True

StorageKeyType

Тип ключа хранилища.
storageUri True

string

URI хранилища.
authenticationType

string

Тип проверки подлинности.
networkIsolation

NetworkIsolationSettings

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

Ответы

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

ImportExportOperationResult

База данных успешно экспортирована.
202 Accepted

Выполняется экспорт базы данных.
Other Status Codes

Ответы об ошибках: ***

  • 400 MissingImportExportInputParameters — отсутствуют входные параметры ImportExport.

  • 400 InvalidImportExportInputParameter — сбой запроса на импорт и экспорт из-за недопустимого входного параметра.

  • 400 PolybaseImportAuthenticationTypeNotSupported — параметр типа проверки подлинности не поддерживает операцию PolybaseImport.

  • 400 DatabaseExtensionsInvalidOperationMode — недопустимый параметр operationMode для расширения базы данных.

  • 400 DatabaseExtensionsInvalidStorageKeyType — тип ключа хранилища должен иметь значение StorageAccessKey.

  • 400 DatabaseExtensionsMissingStorageUri — URI хранилища не может быть пустым.

  • 400 InvalidSku — пользователь указал недопустимый номер SKU.

  • 400 InvalidTierSkuCombination — указанный уровень не поддерживает указанный номер SKU.

  • 400 DatabaseInvalidSkuPropertyCombination — свойства запрошенного номера SKU несогласованы. Пожалуйста, проверка, что указано допустимое сочетание. Дополнительные сведения см. в статье https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability.

  • 400 InvalidMaxSizeTierCombination — указанный уровень не поддерживает указанный максимальный размер базы данных.

  • 400 FeatureDisabledOnSelectedEdition — пользователь попытался использовать функцию, которая отключена в текущем выпуске базы данных.

  • 400 InvalidImportExportParameter — сбой запроса импорта и экспорта из-за недопустимого входного параметра.

  • 400 InvalidTier — пользователь указал недопустимый уровень.

  • 400 InvalidOperationType — укажите допустимый тип операции.

  • 400 ImportExportJobError — сбой операции ImportExport.

  • 400 BlockedByOutboundFirewall — правила брандмауэра для исходящего трафика заблокировали запрос.

  • 404 ResourceNotFound — недопустимый запрос, указывающий несуществующий ресурс.

  • 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке.

  • 404 ImportExportOperationIdNotFound — не удается найти идентификатор операции для импорта или экспорта.

  • 404 ServerNotInSubscription — указанный сервер не существует в указанной подписке.

  • 404 OperationIdNotFound — операция с идентификатором не существует.

  • 409 ImportExportOperationInProgress — в базе данных выполняется операция импорта или экспорта.

  • 409 OperationCancelled — операция была отменена пользователем.

  • 409 OperationInterrupted — не удалось завершить операцию с ресурсом, так как она была прервана другой операцией с тем же ресурсом.

  • 429 SubscriptionTooManyCreateUpdateRequests — запросы сверх максимального количества запросов, которые могут быть обработаны доступными ресурсами.

  • 429 SubscriptionTooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами.

  • 500 OperationTimedOut — время ожидания операции истекло и автоматически откатывается. Повторите операцию.

  • 503 TooManyRequests — запросы сверх максимального числа запросов, которые могут быть обработаны доступными ресурсами.

Примеры

Exports a database, using private link to communicate with SQL server and storage account.
Exports a database.

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

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/export?api-version=2021-11-01

{
  "storageKeyType": "StorageAccessKey",
  "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==",
  "storageUri": "https://test.blob.core.windows.net/test.bacpac",
  "administratorLogin": "login",
  "administratorLoginPassword": "password",
  "authenticationType": "Sql",
  "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"
  }
}

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

Код состояния:
200 
{
  "properties": {
    "requestId": "9d9a794a-5cec-4f23-af70-d29511b522a4",
    "requestType": "Export",
    "queuedTime": "2/2/2020 8:33:27 PM",
    "lastModifiedTime": "2/2/2020 8:34:47 PM",
    "blobUri": "https://test.blob.core.windows.net/test.bacpac",
    "serverName": "testsvr.database.windows.net",
    "databaseName": "testdb",
    "status": "Completed"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/importExportOperationResults/9d9a794a-5cec-4f23-af70-d29511b522a4",
  "name": "9d9a794a-5cec-4f23-af70-d29511b522a4",
  "type": "Microsoft.Sql/servers/databases/importExportOperationResults"
}
Код состояния:
202

Exports a database.

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

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/export?api-version=2021-11-01

{
  "storageKeyType": "StorageAccessKey",
  "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==",
  "storageUri": "https://test.blob.core.windows.net/test.bacpac",
  "administratorLogin": "login",
  "administratorLoginPassword": "password",
  "authenticationType": "Sql"
}

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

Код состояния:
200 
{
  "properties": {
    "requestId": "9d9a794a-5cec-4f23-af70-d29511b522a4",
    "requestType": "Export",
    "queuedTime": "2/2/2020 8:33:27 PM",
    "lastModifiedTime": "2/2/2020 8:34:47 PM",
    "blobUri": "https://test.blob.core.windows.net/test.bacpac",
    "serverName": "testsvr.database.windows.net",
    "databaseName": "testdb",
    "status": "Completed"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/importExportOperationResults/9d9a794a-5cec-4f23-af70-d29511b522a4",
  "name": "9d9a794a-5cec-4f23-af70-d29511b522a4",
  "type": "Microsoft.Sql/servers/databases/importExportOperationResults"
}
Код состояния:
202

Определения

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

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

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

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

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

Тип ключа хранилища.

ExportDatabaseDefinition

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

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

string

Имя входа администратора.
administratorLoginPassword

string

Пароль для входа администратора.
authenticationType

string

Тип проверки подлинности.
networkIsolation

NetworkIsolationSettings

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

string

Ключ хранилища.
storageKeyType

StorageKeyType

Тип ключа хранилища.
storageUri

string

URI хранилища.

ImportExportOperationResult

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

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

string

Идентификатор ресурса.
name

string

Имя ресурса.
properties.blobUri

string

URI большого двоичного объекта.
properties.databaseName

string

имя базы данных.
properties.errorMessage

string

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

string

Время последнего изменения.
properties.privateEndpointConnections

PrivateEndpointConnectionRequestStatus[]

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

string

Время постановки в очередь.
properties.requestId

string

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

string

Тип запроса.
properties.serverName

string

Имя сервера.
properties.status

string

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

string

Тип ресурса.

NetworkIsolationSettings

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

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

string

Идентификатор ресурса для сервера SQL Server, который является целевым объектом этого запроса. Если задано значение , для сервера SQL Server будет создано подключение к частной конечной точке. Должен соответствовать серверу, который является целевым объектом операции.
storageAccountResourceId

string

Идентификатор ресурса для учетной записи хранения, используемой для хранения BACPAC-файла. Если этот параметр задан, для учетной записи хранения будет создано подключение к частной конечной точке. Должен соответствовать учетной записи хранения, используемой для параметра StorageUri.

PrivateEndpointConnectionRequestStatus

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

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

string

Имя подключения для частной конечной точки.
privateLinkServiceId

string

Идентификатор ресурса, для которого создается частная конечная точка.
status

string

Состояние этого подключения к частной конечной точке.

StorageKeyType

Тип ключа хранилища.

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

string

StorageAccessKey

string