Managed Databases - Create Or Update

  • Ссылка
Service:
SQL Database
API Version:
2021-11-01

Создает новую базу данных или обновляет имеющуюся.

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

Параметры URI

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

string

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

string

Имя управляемого экземпляра.
resourceGroupName
 path True

string

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

string

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

string

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

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

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

string

Расположение ресурса.
properties.autoCompleteRestore

boolean

Следует ли автоматически завершить восстановление этой управляемой базы данных.
properties.catalogCollation

CatalogCollationType

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

string

Параметры сортировки управляемой базы данных.
properties.createMode

ManagedDatabaseCreateMode

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

string

Последнее имя файла резервной копии для восстановления этой управляемой базы данных.
properties.longTermRetentionBackupResourceId

string

Имя резервной копии долгосрочного хранения, используемой для восстановления этой управляемой базы данных.
properties.recoverableDatabaseId

string

Идентификатор ресурса восстанавливаемой базы данных, связанной с операцией создания этой базы данных.
properties.restorableDroppedDatabaseId

string

Восстанавливаемый идентификатор ресурса базы данных, который можно восстановить при создании этой базы данных.
properties.restorePointInTime

string

Условного. Если параметр createMode имеет значение PointInTimeRestore, это значение является обязательным. Указывает точку во времени (ISO8601 формате) базы данных-источника, которая будет восстановлена для создания новой базы данных.
properties.sourceDatabaseId

string

Идентификатор ресурса базы данных-источника, связанной с операцией создания этой базы данных.
properties.storageContainerSasToken

string

Условного. Если параметр createMode имеет значение RestoreExternalBackup, это значение является обязательным. Указывает маркер SAS контейнера хранилища.
properties.storageContainerUri

string

Условного. Если параметр createMode имеет значение RestoreExternalBackup, это значение является обязательным. Указывает универсальный код ресурса (URI) контейнера хранилища, в котором хранятся резервные копии для этого восстановления.
tags

object

Теги ресурсов.

Ответы

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

ManagedDatabase

База данных успешно обновлена.
201 Created

ManagedDatabase

База данных успешно создана.
202 Accepted

Принято
Other Status Codes

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

  • 400 PitrPointInTimeInvalid — недопустимая точка во времени {0} . Допустимый диапазон времени от {1} ранних дней до настоящего времени, а не до создания исходного сервера.

  • 400 CannotUseTrailingWhitespacesInDatabaseName — сбой проверки имени базы данных.

  • 400 StorageAccountFull — Управляемый экземпляр достигла общей емкости базовой учетной записи хранения Azure. Для учетной записи Azure хранилище класса Premium доступно 35 ТБ выделенного пространства.

  • 400 AkvHostNotResolvingFromNode — узел AKV "{0}" не разрешается из SQL на сервере "{1}".

  • 400 InvalidBackupRetentionPeriod — дни {0} хранения не являются допустимой конфигурацией. Допустимое хранение резервных копий в днях должно находиться между {1} и {2}

  • 400 ManagedDatabaseNameInUse — база данных "{0}" уже существует. Выберите другое имя базы данных.

  • 400 NoMoreSpaceInManagedInstance — управляемый экземпляр достиг предела хранилища. Использование хранилища для управляемого экземпляра не может превышать (%d) МБ.

  • 400 ManagedInstanceUpdateSloInProgress — "Не удалось завершить операцию, так как для управляемого экземпляра выполняется изменение уровня служб ".{0} Дождитесь завершения операции и повторите попытку".

  • 400 SameKeyMaterialNotFoundOnRemoteServer — сервер-получатель не имеет материала ключа предохранителя шифрования основного сервера.

  • 400 SourceDatabaseNotFound — база данных-источник не существует.

  • 400 RegionDoesNotSupportVersion — пользователь пытался создать сервер указанной версии в расположении, где эта версия сервера не поддерживается.

  • 400 PasswordNotComplex — предоставленный пароль недостаточно сложный.

  • 400 CannotUseReservedDatabaseName — не удается использовать зарезервированное имя базы данных в этой операции.

  • 400 InvalidServerName — указано недопустимое имя сервера.

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

  • 400 TokenTooLong — предоставленный маркер слишком длинный.

  • 400 CurrentDatabaseSizeExceedsMaxSize — пользователь попытался уменьшить максимальный размер базы данных до размера, который меньше текущего использования.

  • 400 InvalidCollation — параметры сортировки не распознаны сервером.

  • 400 AkvEndpointNotReachableFromNode — конечная точка AKV "{0}" недоступна из SQL на сервере "{1}".

  • 400 ServerNotFound — запрошенный сервер не найден.

  • 400 UnsupportedServiceName — указанное имя является недопустимым, так как оно содержит один или несколько неподдерживаемых символов Юникода.

  • 400 CurrentDatabaseLogSizeExceedsMaxSize — пользователь попытался изменить базу данных на номер SKU с меньшим максимальным размером журнала, чем текущее использование.

  • 400 DatabaseNumberLimitReached — максимальное количество баз данных для База данных SQL Управляемый экземпляр достигнуто.

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

  • 400 InvalidResourceId — недопустимый идентификатор ресурса.

  • 400 InvalidSourceDatabaseId — недопустимый идентификатор базы данных-источника.

  • 400 InvalidRestorableDroppedDatabaseId — недопустимый восстанавливаемый идентификатор базы данных

  • 400 MismatchingResourceGroupNameWithUrl — предоставленное имя группы ресурсов не совпадает с именем в URL-адресе.

  • 400 MismatchingServerNameWithUrl — предоставленное имя сервера не совпадает с именем в URL-адресе.

  • 400 MismatchingSubscriptionWithUrl — указанная подписка не соответствует подписке в URL-адресе.

  • 400 MissingCollation — требуется сортировка.

  • 400 MissingSourceDatabaseId — отсутствует идентификатор базы данных-источника.

  • 400 MissingRestorePointInTime — отсутствует точка восстановления во времени

  • 400 MissingStorageContainerSasToken — отсутствует маркер SAS контейнера хранилища

  • 400 MissingStorageContainerUri — отсутствует универсальный код ресурса (URI) контейнера хранилища

  • 400 RestoreableDroppedDatabaseIdGivenForRestoreWithSourceDatabaseId — не удается указать restoreableDroppedDatabaseId, если sourceDatabaseId уже предоставлен в режиме создания восстановления

  • 400 CannotUseReservedDatabaseName — не удается использовать зарезервированное имя базы данных в этой операции.

  • 400 InvalidLongTermRetentionManagedInstanceBackupId — недопустимый идентификатор резервной копии долгосрочного хранения для Управляемых экземпляров.

  • 400 MiGeoRestoreWithWrongBackupStorageRedundancy — Geo-Restore не разрешено для управляемых экземпляров с избыточностью хранилища резервных копий LRS/ZRS.

  • 400 UpdatedInstanceAndBackupRedundancy — избыточность зоны экземпляра и избыточность хранилища резервных копий невозможно обновить в одном запросе.

  • 400 ProvisioningDisabled — отображает сообщение об ошибке от авторизации операции ресурсов без изменений.

  • 400 AadOnlyAuthenticationIsEnabled — включена только проверка подлинности Azure Active Directory. Обратитесь к системному администратору.

  • 400 ManagementServiceFeatureDisabled — пользователь попытался использовать отключенную функцию.

  • 400 TargetServerDoesNotExist — целевой сервер {0} не существует или еще не готов. Проверка, что он существует, и повторите запрос на восстановление.

  • 400 TargetServerRestoreNotAllowed — целевой сервер {0} в настоящее время не находится в состоянии, позволяющем начать восстановление.

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

  • 400 FullBackupNotFound — не удается найти полную резервную копию.

  • 400 MissingThumbprint — не удается найти сертификат сервера.

  • 400 RestoreFromStripedBackupsNotEnabled — восстановление из чередующихся резервных копий не поддерживается.

  • 400 BackupSetBroken — набор резервных копий не работает.

  • 400 BrokenRestorePlanNoFullBackup — план восстановления не работает, так как отсутствует полная резервная копия.

  • 400 SqlRestoreError — при восстановлении резервной копии с индексом {0} произошла неизменяемая ошибка. {1}{2}

  • 400 BrokenRestorePlanWrongLogBackupLSN — план восстановления не работает, так как firstLsn текущей резервной копии журнала не <= lastLsn следующей резервной копии журнала.

  • 400 BrokenRestorePlanWrongDiffBackupLSN — план восстановления не работает, так как firstLsn diff резервной копии не >= firstLsn полной резервной копии.

  • 400 BrokenRestorePlanGapInLogBackups — план восстановления неработает, так как firstLsn текущей резервной копии журнала не равно lastLsn предыдущей резервной копии журнала.

  • 400 PartiallyContainedDatabaseUnsupported — "Резервное копирование для частично автономной базы данных не поддерживается".

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

  • 400 XtpInitializedDuringRestore — оптимизированная для памяти файловая группа должна быть пустой, чтобы ее можно было восстановить на общего назначения уровне База данных SQL Управляемый экземпляр.

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

  • 400 FullBackupDamaged — при условии, что полная резервная копия повреждена.

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

  • 400 BrokenRestorePlanWrongDiffBaseGUID — план восстановления не работает, так как DifferentialBaseGuid diff резервной копии не соответствует BackupSetGuid полной резервной копии.

  • 400 IncompatiblePhysicalLayoutTooFewDataFiles — резервная копия базы данных содержит несовместимый физический макет. Файлы данных в резервной копии не найдены.

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

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

  • 400 CorruptedPagesListMaintenance — операция была прервана, так как произошла внутренняя ошибка при обработке резервной копии, снятой без контрольной суммы.

  • 400 IncompatiblePhysicalLayoutWrongNumberOfLogFiles — резервная копия базы данных содержит несовместимый физический макет. Несколько файлов журнала не поддерживаются.

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

  • 400 IncompatiblePhysicalLayoutTooManyNonDataLogFiles — резервная копия базы данных содержит несовместимый физический макет. Слишком много файлов, не относящихся к данным или журналам.

  • 400 ExternalBackupAlreadySignaledToComplete — запрос на восстановление уже был завершен.

  • 400 ExternalBackupRestoreHasNotBeenStarted — запрос на восстановление может быть выполнен только после начала восстановления.

  • 400 ExternalBackupUpgradeInProgress — запрос на восстановление не может быть выполнен, так как выполняется обновление.

  • 400 IncompatiblePhysicalLayoutTooManyXTPFiles — резервная копия базы данных содержит несовместимый физический макет. Несколько файлов в файловой группе, содержащей MEMORY_OPTIMIZED_DATA.

  • 400 BlobStorageFailure — произошел сбой хранилища BLOB-объектов.

  • 400 BackupsFromMultipleDatabasesDetectedInTheContainerFromTheStart — в папке контейнера есть резервные копии из нескольких баз данных. Убедитесь, что в папке контейнера есть резервные копии из одной базы данных.{0}

  • 400 ManagedIdentityIssueDetectedFromTheStart — управляемое удостоверение настроено неправильно. Проверьте и повторите попытку.

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

  • 400 AutoCompleteMissingLastBackupName — запрос на автоматическое завершение восстановления должен иметь параметр lastBackupName.

  • 400 BlobStorageServerFailure — произошел сбой сервера хранилища BLOB-объектов.

  • 400 BackupsFromMultipleDatabasesDetectedInTheContainerTimeRestoreInProgress — в папке контейнера есть резервные копии из нескольких баз данных. Убедитесь, что в папке контейнера есть резервные копии из одной базы данных.{0}

  • 400 ManagedIdentityIssueDetectedTimeRestoreInProgress — управляемое удостоверение настроено неправильно. Проверьте и повторите попытку.

  • 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден

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

  • 404 ResourceNotFound — запрошенный ресурс не найден.

  • 404 CannotFindServerCertificateWithThumbprint — не удается найти сертификат сервера с отпечатком "{0}". Чтобы создать сертификат, используйте командлет PowerShell Add-AzureRmSqlManagedInstanceTransparentDataEncryptionCertificate.

  • 404 CannotFindObject — не удается найти объект, так как он не существует или у вас нет разрешений

  • 404 SubscriptionNotFound — запрошенная подписка не найдена.

  • 404 DatabaseDoesNotExist — пользователь указал имя базы данных, которое не существует на этом экземпляре сервера.

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

  • 404 RestoreSourceDatabaseNotFound — не удалось найти базу данных "{0}" во время "{1}", которую можно восстановить.

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

  • 409 RemoteDatabaseExists — имя целевой базы данных уже существует на целевом сервере.

  • 409 ConflictingDatabaseOperation — в базе данных уже есть некоторые операции, и текущая операция должна дождаться ее завершения.

  • 409 SubscriptionDisabled — подписка отключена.

  • 409 ManagementServiceDatabaseBusy — база данных "{0}" занята другой операцией. Попробуйте выполнить операцию позже.

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

  • 409 ConflictingManagedInstanceOperation — в настоящее время выполняется операция для управляемого экземпляра.

  • 409 BackupRedundancyUpdateAndInstanceRedundancyConflict — экземпляр имеет значение multi-az, но хранилище резервных копий обновляется с избыточности между зонами до неизбыточного между зонами.

  • 409 InstanceRedundancyUpdateTimeBackupRedundancyUpdateInProgress — не удается обновить избыточность экземпляров, так как выполняется обновление избыточности хранилища резервных копий.

  • 409 InstanceRedundancyUpdateAndBackupRedundancyConflict — хранилище резервных копий не является избыточным между зонами, но избыточность экземпляров обновляется до избыточности между зонами.

  • 409 BackupRedundancyUpdateConflict — не удается обновить избыточность хранилища резервных копий, так как обновление избыточности хранилища резервных копий уже выполняется.

  • 409 MiDropFailedOnAuthLocks — пользователь пытался удалить последнее Управляемый экземпляр в подсети, в которую применена блокировка к ресурсам.

  • 409 MiCreateFailedNonDelegatedSubnet — пользователь попытался развернуть Управляемый экземпляр или Управляемый экземпляр пул в подсети, которая не делегирована Microsoft.Sql/managedInstances.

  • 412 InstanceNotReadyForBackupRedundancyUpdate — не удается обновить избыточность хранилища резервных копий, так как экземпляр не готов.

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

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

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

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

  • 429 ConflictingSubscriptionOperation — в настоящее время выполняется операция для подписки.

  • 500 ActivateOrDeactivateWorkflowThrottling — рабочий процесс активации или деактивации завершился сбоем из-за слишком большого количества параллельных рабочих процессов

  • 503 DatabaseUnavailable — операция завершилась сбоем, так как база данных недоступна.

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

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

  • 504 RequestTimeout — превышено допустимое время ожидания запроса на обслуживание.

  • 504 RequestTimeout — превышено допустимое время ожидания запроса на обслуживание.

Примеры

Creates a new managed database by restoring from an external backup
Creates a new managed database from restoring a geo-replicated backup
Creates a new managed database from restoring a long term retention backup
Creates a new managed database using point in time restore
Creates a new managed database with maximal properties
Creates a new managed database with minimal properties

Creates a new managed database by restoring from an external backup

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2021-11-01

{
  "properties": {
    "createMode": "RestoreExternalBackup",
    "storageContainerUri": "https://myaccountname.blob.core.windows.net/backups",
    "storageContainerSasToken": "sv=2015-12-11&sr=c&sp=rl&sig=1234",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "autoCompleteRestore": true,
    "lastBackupName": "last_backup_name"
  },
  "location": "southeastasia"
}

Sample Response

Status code:
200 
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Status code:
201 
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Status code:
202

Creates a new managed database from restoring a geo-replicated backup

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/server1/databases/testdb_recovered?api-version=2021-11-01

{
  "location": "southeastasia",
  "properties": {
    "createMode": "Recovery",
    "recoverableDatabaseId": "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/Default-SQL-WestEurope/providers/Microsoft.Sql/managedInstances/testsvr/recoverableDatabases/testdb"
  }
}

Sample Response

Status code:
200 
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/server1/recoverableDatabases/testdb_recovered",
  "name": "testdb_recovered",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2018-11-07T04:41:33.937Z"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Status code:
201 
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/recoverableDatabases/testdb_recovered",
  "name": "testdb_recovered",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2018-11-07T04:41:33.937Z"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Status code:
202

Creates a new managed database from restoring a long term retention backup

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2021-11-01

{
  "properties": {
    "createMode": "RestoreExternalBackup",
    "storageContainerUri": "https://myaccountname.blob.core.windows.net/backups",
    "storageContainerSasToken": "sv=2015-12-11&sr=c&sp=rl&sig=1234",
    "collation": "SQL_Latin1_General_CP1_CI_AS"
  },
  "location": "southeastasia"
}

Sample Response

Status code:
200 
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Status code:
201 
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Status code:
202

Creates a new managed database using point in time restore

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2021-11-01

{
  "location": "southeastasia",
  "properties": {
    "createMode": "PointInTimeRestore",
    "sourceDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb",
    "restorePointInTime": "2017-07-14T05:35:31.503Z"
  }
}

Sample Response

Status code:
200 
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Status code:
201 
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Status code:
202

Creates a new managed database with maximal properties

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2021-11-01

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia"
}

Sample Response

Status code:
200 
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Status code:
201 
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Status code:
202

Creates a new managed database with minimal properties

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2021-11-01

{
  "location": "southeastasia"
}

Sample Response

Status code:
200 
{
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Status code:
201 
{
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Status code:
202

Определения

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

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

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

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

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

CatalogCollationType

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

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

string

SQL_Latin1_General_CP1_CI_AS

string

ManagedDatabase

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

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

string

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

string

Расположение ресурса.
name

string

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

boolean

Следует ли автоматически завершить восстановление этой управляемой базы данных.
properties.catalogCollation

CatalogCollationType

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

string

Параметры сортировки управляемой базы данных.
properties.createMode

ManagedDatabaseCreateMode

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

string

Дата создания базы данных.
properties.defaultSecondaryLocation

string

Географически связанный регион.
properties.earliestRestorePoint

string

Самая ранняя точка восстановления во времени для восстановления на определенный момент времени.
properties.failoverGroupId

string

Идентификатор ресурса группы отработки отказа экземпляра, к которой принадлежит эта управляемая база данных.
properties.lastBackupName

string

Последнее имя файла резервной копии для восстановления этой управляемой базы данных.
properties.longTermRetentionBackupResourceId

string

Имя резервной копии долгосрочного хранения, используемой для восстановления этой управляемой базы данных.
properties.recoverableDatabaseId

string

Идентификатор ресурса восстанавливаемой базы данных, связанной с операцией создания этой базы данных.
properties.restorableDroppedDatabaseId

string

Восстанавливаемый идентификатор ресурса базы данных, который можно восстановить при создании этой базы данных.
properties.restorePointInTime

string

Условного. Если параметр createMode имеет значение PointInTimeRestore, это значение является обязательным. Указывает точку во времени (ISO8601 формате) базы данных-источника, которая будет восстановлена для создания новой базы данных.
properties.sourceDatabaseId

string

Идентификатор ресурса базы данных-источника, связанной с операцией создания этой базы данных.
properties.status

ManagedDatabaseStatus

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

string

Условного. Если параметр createMode имеет значение RestoreExternalBackup, это значение является обязательным. Указывает маркер SAS контейнера хранилища.
properties.storageContainerUri

string

Условного. Если параметр createMode имеет значение RestoreExternalBackup, это значение является обязательным. Указывает универсальный код ресурса (URI) контейнера хранилища, в котором хранятся резервные копии для этого восстановления.
tags

object

Теги ресурсов.
type

string

Тип ресурса.

ManagedDatabaseCreateMode

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

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

string

PointInTimeRestore

string

Recovery

string

RestoreExternalBackup

string

RestoreLongTermRetentionBackup

string

ManagedDatabaseStatus

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

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

string

Inaccessible

string

Offline

string

Online

string

Restoring

string

Shutdown

string

Updating

string