Managed Databases - Create Or Update
Создает новую базу данных или обновляет имеющуюся.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}?api-version=2021-11-01
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
database
|
path | True |
string |
Имя базы данных. |
managed
|
path | True |
string |
Имя управляемого экземпляра. |
resource
|
path | True |
string |
Имя группы ресурсов, к которой относится ресурс. Это значение можно получить от API-интерфейса диспетчера ресурсов Azure или портала. |
subscription
|
path | True |
string |
Идентификатор подписки Azure. |
api-version
|
query | True |
string |
Версия API для использования в запросе. |
Текст запроса
Имя | Обязательно | Тип | Описание |
---|---|---|---|
location | True |
string |
Расположение ресурса. |
properties.autoCompleteRestore |
boolean |
Следует ли автоматически завершить восстановление этой управляемой базы данных. |
|
properties.catalogCollation |
Параметры сортировки каталога метаданных. |
||
properties.collation |
string |
Параметры сортировки управляемой базы данных. |
|
properties.createMode |
Режим создания управляемой базы данных. 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 |
База данных успешно обновлена. |
|
201 Created |
База данных успешно создана. |
|
202 Accepted |
Принято |
|
Other Status Codes |
Ответы на ошибки: ***
|
Примеры
Creates a new managed database by restoring from an external backup
Образец запроса
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"
}
Пример ответа
{
"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"
}
{
"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"
}
Creates a new managed database from restoring a geo-replicated backup
Образец запроса
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"
}
}
Пример ответа
{
"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"
}
{
"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"
}
Creates a new managed database from restoring a long term retention backup
Образец запроса
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"
}
Пример ответа
{
"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"
}
{
"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"
}
Creates a new managed database using point in time restore
Образец запроса
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"
}
}
Пример ответа
{
"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"
}
{
"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"
}
Creates a new managed database with maximal properties
Образец запроса
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"
}
Пример ответа
{
"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"
}
{
"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"
}
Creates a new managed database with minimal properties
Образец запроса
Пример ответа
{
"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"
}
{
"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"
}
Определения
Имя | Описание |
---|---|
Catalog |
Параметры сортировки каталога метаданных. |
Managed |
Управляемый ресурс базы данных. |
Managed |
Режим создания управляемой базы данных. PointInTimeRestore. Создайте базу данных, восстановив резервную копию существующей базы данных на определенный момент времени. Необходимо указать SourceDatabaseName, SourceManagedInstanceName и PointInTime. RestoreExternalBackup: создайте базу данных путем восстановления из внешних файлов резервных копий. Необходимо указать параметры сортировки, StorageContainerUri и StorageContainerSasToken. Восстановление. Создает базу данных путем восстановления геореплицированной резервной копии. RecoverableDatabaseId должен быть указан в качестве идентификатора восстанавливаемого ресурса базы данных для восстановления. RestoreLongTermRetentionBackup. Создайте базу данных путем восстановления из резервной копии долгосрочного хранения (требуется longTermRetentionBackupResourceId). |
Managed |
Состояние базы данных. |
CatalogCollationType
Параметры сортировки каталога метаданных.
Имя | Тип | Описание |
---|---|---|
DATABASE_DEFAULT |
string |
|
SQL_Latin1_General_CP1_CI_AS |
string |
ManagedDatabase
Управляемый ресурс базы данных.
Имя | Тип | Описание |
---|---|---|
id |
string |
Идентификатор ресурса. |
location |
string |
Расположение ресурса. |
name |
string |
Имя ресурса. |
properties.autoCompleteRestore |
boolean |
Следует ли автоматически завершить восстановление этой управляемой базы данных. |
properties.catalogCollation |
Параметры сортировки каталога метаданных. |
|
properties.collation |
string |
Параметры сортировки управляемой базы данных. |
properties.createMode |
Режим создания управляемой базы данных. 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 |
Состояние базы данных. |
|
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 |