Managed Databases - Create Or Update
Új adatbázist hoz létre, vagy egy meglévő adatbázist frissít.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}?api-version=2021-11-01
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
database
|
path | True |
string |
Az adatbázis neve. |
managed
|
path | True |
string |
A felügyelt példány neve. |
resource
|
path | True |
string |
Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be. |
subscription
|
path | True |
string |
Az Azure-előfizetést azonosító előfizetés-azonosító. |
api-version
|
query | True |
string |
A kéréshez használandó API-verzió. |
Kérelem törzse
Name | Kötelező | Típus | Description |
---|---|---|---|
location | True |
string |
Erőforrás helye. |
properties.autoCompleteRestore |
boolean |
A felügyelt adatbázis automatikus visszaállításának befejezése. |
|
properties.catalogCollation |
A metaadat-katalógus rendezése. |
||
properties.collation |
string |
A felügyelt adatbázis rendezése. |
|
properties.createMode |
Felügyelt adatbázis létrehozási módja. PointInTimeRestore: Adatbázis létrehozása egy meglévő adatbázis időponthoz kötött biztonsági mentésének visszaállításával. Meg kell adni a SourceDatabaseName, a SourceManagedInstanceName és a PointInTime értéket. RestoreExternalBackup: Adatbázis létrehozása külső biztonsági mentési fájlokból történő visszaállítással. Meg kell adni a Rendezés, a StorageContainerUri és a StorageContainerSasToken értéket. Helyreállítás: Létrehoz egy adatbázist egy georeplikált biztonsági másolat visszaállításával. A visszaállítandó helyreállítható adatbázis erőforrás-azonosítójaként meg kell adni a RecoverableDatabaseId azonosítót. RestoreLongTermRetentionBackup: Adatbázis létrehozása egy hosszú távú adatmegőrzési biztonsági másolatból történő visszaállítással (longTermRetentionBackupResourceId szükséges). |
||
properties.lastBackupName |
string |
A felügyelt adatbázis visszaállításához használt utolsó biztonsági mentési fájl neve. |
|
properties.longTermRetentionBackupResourceId |
string |
A felügyelt adatbázis visszaállításához használandó hosszú távú megőrzési biztonsági másolat neve. |
|
properties.recoverableDatabaseId |
string |
Az adatbázis létrehozási műveletéhez társított helyreállítható adatbázis erőforrás-azonosítója. |
|
properties.restorableDroppedDatabaseId |
string |
A visszaállítható elvetett adatbázis erőforrás-azonosítója az adatbázis létrehozásakor. |
|
properties.restorePointInTime |
string |
Feltételes. Ha a createMode értéke PointInTimeRestore, akkor erre az értékre van szükség. Megadja annak a forrásadatbázisnak az időpontját (ISO8601 formátumát), amely az új adatbázis létrehozásához lesz visszaállítva. |
|
properties.sourceDatabaseId |
string |
Az adatbázis létrehozási műveletéhez társított forrásadatbázis erőforrás-azonosítója. |
|
properties.storageContainerSasToken |
string |
Feltételes. Ha a createMode értéke RestoreExternalBackup, akkor erre az értékre van szükség. Megadja a tároló sas-jogkivonatát. |
|
properties.storageContainerUri |
string |
Feltételes. Ha a createMode értéke RestoreExternalBackup, akkor erre az értékre van szükség. Annak a tárolónak az URI-ját adja meg, ahol a visszaállításhoz szükséges biztonsági másolatok tárolása történik. |
|
tags |
object |
Erőforráscímkék. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
Az adatbázis frissítése sikerült. |
|
201 Created |
Az adatbázis létrehozása sikerült. |
|
202 Accepted |
Elfogadva |
|
Other Status Codes |
Hibaválaszok: ***
|
Példák
Creates a new managed database by restoring from an external backup
Mintakérelem
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"
}
Mintaválasz
{
"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
Mintakérelem
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"
}
}
Mintaválasz
{
"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
Mintakérelem
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"
}
Mintaválasz
{
"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
Mintakérelem
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"
}
}
Mintaválasz
{
"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
Mintakérelem
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"
}
Mintaválasz
{
"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
Mintakérelem
Mintaválasz
{
"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"
}
Definíciók
Name | Description |
---|---|
Catalog |
A metaadat-katalógus rendezése. |
Managed |
Egy felügyelt adatbázis-erőforrás. |
Managed |
Felügyelt adatbázis létrehozási módja. PointInTimeRestore: Adatbázis létrehozása egy meglévő adatbázis időponthoz kötött biztonsági mentésének visszaállításával. Meg kell adni a SourceDatabaseName, a SourceManagedInstanceName és a PointInTime értéket. RestoreExternalBackup: Adatbázis létrehozása külső biztonsági mentési fájlokból történő visszaállítással. Meg kell adni a Rendezés, a StorageContainerUri és a StorageContainerSasToken értéket. Helyreállítás: Létrehoz egy adatbázist egy georeplikált biztonsági másolat visszaállításával. A visszaállítandó helyreállítható adatbázis erőforrás-azonosítójaként meg kell adni a RecoverableDatabaseId azonosítót. RestoreLongTermRetentionBackup: Adatbázis létrehozása egy hosszú távú adatmegőrzési biztonsági másolatból történő visszaállítással (longTermRetentionBackupResourceId szükséges). |
Managed |
Az adatbázis állapota. |
CatalogCollationType
A metaadat-katalógus rendezése.
Name | Típus | Description |
---|---|---|
DATABASE_DEFAULT |
string |
|
SQL_Latin1_General_CP1_CI_AS |
string |
ManagedDatabase
Egy felügyelt adatbázis-erőforrás.
Name | Típus | Description |
---|---|---|
id |
string |
Erőforrás-azonosító. |
location |
string |
Erőforrás helye. |
name |
string |
Erőforrás neve. |
properties.autoCompleteRestore |
boolean |
A felügyelt adatbázis automatikus visszaállításának befejezése. |
properties.catalogCollation |
A metaadat-katalógus rendezése. |
|
properties.collation |
string |
A felügyelt adatbázis rendezése. |
properties.createMode |
Felügyelt adatbázis létrehozási módja. PointInTimeRestore: Adatbázis létrehozása egy meglévő adatbázis időponthoz kötött biztonsági mentésének visszaállításával. Meg kell adni a SourceDatabaseName, a SourceManagedInstanceName és a PointInTime értéket. RestoreExternalBackup: Adatbázis létrehozása külső biztonsági mentési fájlokból történő visszaállítással. Meg kell adni a Rendezés, a StorageContainerUri és a StorageContainerSasToken értéket. Helyreállítás: Létrehoz egy adatbázist egy georeplikált biztonsági másolat visszaállításával. A visszaállítandó helyreállítható adatbázis erőforrás-azonosítójaként meg kell adni a RecoverableDatabaseId azonosítót. RestoreLongTermRetentionBackup: Adatbázis létrehozása egy hosszú távú adatmegőrzési biztonsági másolatból történő visszaállítással (longTermRetentionBackupResourceId szükséges). |
|
properties.creationDate |
string |
Az adatbázis létrehozásának dátuma. |
properties.defaultSecondaryLocation |
string |
Földrajzilag párosított régió. |
properties.earliestRestorePoint |
string |
Az időponthoz kötött visszaállítás legkorábbi visszaállítási pontja. |
properties.failoverGroupId |
string |
Példány feladatátvételi csoportjának erőforrás-azonosítója, amelyhez ez a felügyelt adatbázis tartozik. |
properties.lastBackupName |
string |
A felügyelt adatbázis visszaállításához használt utolsó biztonsági mentési fájl neve. |
properties.longTermRetentionBackupResourceId |
string |
A felügyelt adatbázis visszaállításához használandó hosszú távú megőrzési biztonsági másolat neve. |
properties.recoverableDatabaseId |
string |
Az adatbázis létrehozási műveletéhez társított helyreállítható adatbázis erőforrás-azonosítója. |
properties.restorableDroppedDatabaseId |
string |
A visszaállítható elvetett adatbázis erőforrás-azonosítója az adatbázis létrehozásakor. |
properties.restorePointInTime |
string |
Feltételes. Ha a createMode értéke PointInTimeRestore, akkor erre az értékre van szükség. Megadja annak a forrásadatbázisnak az időpontját (ISO8601 formátumát), amely az új adatbázis létrehozásához lesz visszaállítva. |
properties.sourceDatabaseId |
string |
Az adatbázis létrehozási műveletéhez társított forrásadatbázis erőforrás-azonosítója. |
properties.status |
Az adatbázis állapota. |
|
properties.storageContainerSasToken |
string |
Feltételes. Ha a createMode értéke RestoreExternalBackup, akkor erre az értékre van szükség. Megadja a tároló sas-jogkivonatát. |
properties.storageContainerUri |
string |
Feltételes. Ha a createMode értéke RestoreExternalBackup, akkor erre az értékre van szükség. Annak a tárolónak az URI-ját adja meg, ahol a visszaállításhoz szükséges biztonsági másolatok tárolása történik. |
tags |
object |
Erőforráscímkék. |
type |
string |
Erőforrástípus. |
ManagedDatabaseCreateMode
Felügyelt adatbázis létrehozási módja. PointInTimeRestore: Adatbázis létrehozása egy meglévő adatbázis időponthoz kötött biztonsági mentésének visszaállításával. Meg kell adni a SourceDatabaseName, a SourceManagedInstanceName és a PointInTime értéket. RestoreExternalBackup: Adatbázis létrehozása külső biztonsági mentési fájlokból történő visszaállítással. Meg kell adni a Rendezés, a StorageContainerUri és a StorageContainerSasToken értéket. Helyreállítás: Létrehoz egy adatbázist egy georeplikált biztonsági másolat visszaállításával. A visszaállítandó helyreállítható adatbázis erőforrás-azonosítójaként meg kell adni a RecoverableDatabaseId azonosítót. RestoreLongTermRetentionBackup: Adatbázis létrehozása egy hosszú távú adatmegőrzési biztonsági másolatból történő visszaállítással (longTermRetentionBackupResourceId szükséges).
Name | Típus | Description |
---|---|---|
Default |
string |
|
PointInTimeRestore |
string |
|
Recovery |
string |
|
RestoreExternalBackup |
string |
|
RestoreLongTermRetentionBackup |
string |
ManagedDatabaseStatus
Az adatbázis állapota.
Name | Típus | Description |
---|---|---|
Creating |
string |
|
Inaccessible |
string |
|
Offline |
string |
|
Online |
string |
|
Restoring |
string |
|
Shutdown |
string |
|
Updating |
string |