Managed Databases - Create Or Update
Vytvoří novou databázi nebo aktualizuje existující databázi.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}?api-version=2021-11-01
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
database
|
path | True |
string |
Název databáze. |
managed
|
path | True |
string |
Název spravované instance. |
resource
|
path | True |
string |
Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API azure Resource Manager nebo z portálu. |
subscription
|
path | True |
string |
ID předplatného, které identifikuje předplatné Azure. |
api-version
|
query | True |
string |
Verze rozhraní API, která se má použít pro požadavek. |
Text požadavku
Name | Vyžadováno | Typ | Description |
---|---|---|---|
location | True |
string |
Umístění prostředku. |
properties.autoCompleteRestore |
boolean |
Jestli se má automaticky dokončit obnovení této spravované databáze. |
|
properties.catalogCollation |
Kolace katalogu metadat. |
||
properties.collation |
string |
Kolace spravované databáze |
|
properties.createMode |
Režim vytváření spravované databáze. PointInTimeRestore: Vytvořte databázi obnovením zálohy existující databáze k určitému bodu v čase. Musí být zadány názvy SourceDatabaseName, SourceManagedInstanceName a PointInTime. RestoreExternalBackup: Vytvořte databázi obnovením z externích záložních souborů. Musí být zadány kolace, StorageContainerUri a StorageContainerSasToken. Obnovení: Vytvoří databázi obnovením geograficky replikované zálohy. Jako ID obnovitelného prostředku databáze k obnovení je nutné zadat RecoverableDatabaseId. RestoreLongTermRetentionBackup: Vytvořte databázi obnovením z dlouhodobě uchovávané zálohy (vyžaduje se longTermRetentionBackupResourceId). |
||
properties.lastBackupName |
string |
Název posledního záložního souboru pro obnovení této spravované databáze. |
|
properties.longTermRetentionBackupResourceId |
string |
Název zálohy dlouhodobého uchovávání, která se má použít k obnovení této spravované databáze. |
|
properties.recoverableDatabaseId |
string |
Identifikátor prostředku obnovitelné databáze přidružené k operaci vytvoření této databáze. |
|
properties.restorableDroppedDatabaseId |
string |
ID obnovitelného vyřazeného prostředku databáze, které se má obnovit při vytváření této databáze. |
|
properties.restorePointInTime |
string |
Podmíněné. Pokud je createMode PointInTimeRestore, je tato hodnota povinná. Určuje bod v čase (ISO8601 formát) zdrojové databáze, která se obnoví za účelem vytvoření nové databáze. |
|
properties.sourceDatabaseId |
string |
Identifikátor prostředku zdrojové databáze přidružené k operaci vytvoření této databáze. |
|
properties.storageContainerSasToken |
string |
Podmíněné. Pokud je createMode RestoreExternalBackup, je tato hodnota povinná. Určuje token SAS kontejneru úložiště. |
|
properties.storageContainerUri |
string |
Podmíněné. Pokud je createMode RestoreExternalBackup, je tato hodnota povinná. Určuje identifikátor URI kontejneru úložiště, ve kterém se ukládají zálohy pro toto obnovení. |
|
tags |
object |
Značky prostředků. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Databáze se úspěšně aktualizovala. |
|
201 Created |
Databáze se úspěšně vytvořila. |
|
202 Accepted |
Přijato |
|
Other Status Codes |
Chybové odpovědi: ***
|
Příklady
Creates a new managed database by restoring from an external backup
Ukázkový požadavek
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"
}
Ukázková odpověď
{
"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
Ukázkový požadavek
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"
}
}
Ukázková odpověď
{
"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
Ukázkový požadavek
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"
}
Ukázková odpověď
{
"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
Ukázkový požadavek
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"
}
}
Ukázková odpověď
{
"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
Ukázkový požadavek
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"
}
Ukázková odpověď
{
"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
Ukázkový požadavek
Ukázková odpověď
{
"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"
}
Definice
Name | Description |
---|---|
Catalog |
Kolace katalogu metadat. |
Managed |
Prostředek spravované databáze. |
Managed |
Režim vytváření spravované databáze. PointInTimeRestore: Vytvořte databázi obnovením zálohy existující databáze k určitému bodu v čase. Musí být zadány názvy SourceDatabaseName, SourceManagedInstanceName a PointInTime. RestoreExternalBackup: Vytvořte databázi obnovením z externích záložních souborů. Musí být zadány kolace, StorageContainerUri a StorageContainerSasToken. Obnovení: Vytvoří databázi obnovením geograficky replikované zálohy. Jako ID obnovitelného prostředku databáze k obnovení je nutné zadat RecoverableDatabaseId. RestoreLongTermRetentionBackup: Vytvořte databázi obnovením z dlouhodobě uchovávané zálohy (vyžaduje se longTermRetentionBackupResourceId). |
Managed |
Stav databáze. |
CatalogCollationType
Kolace katalogu metadat.
Name | Typ | Description |
---|---|---|
DATABASE_DEFAULT |
string |
|
SQL_Latin1_General_CP1_CI_AS |
string |
ManagedDatabase
Prostředek spravované databáze.
Name | Typ | Description |
---|---|---|
id |
string |
ID prostředku. |
location |
string |
Umístění prostředku. |
name |
string |
Název prostředku. |
properties.autoCompleteRestore |
boolean |
Jestli se má automaticky dokončit obnovení této spravované databáze. |
properties.catalogCollation |
Kolace katalogu metadat. |
|
properties.collation |
string |
Kolace spravované databáze |
properties.createMode |
Režim vytváření spravované databáze. PointInTimeRestore: Vytvořte databázi obnovením zálohy existující databáze k určitému bodu v čase. Musí být zadány názvy SourceDatabaseName, SourceManagedInstanceName a PointInTime. RestoreExternalBackup: Vytvořte databázi obnovením z externích záložních souborů. Musí být zadány kolace, StorageContainerUri a StorageContainerSasToken. Obnovení: Vytvoří databázi obnovením geograficky replikované zálohy. Jako ID obnovitelného prostředku databáze k obnovení je nutné zadat RecoverableDatabaseId. RestoreLongTermRetentionBackup: Vytvořte databázi obnovením z dlouhodobě uchovávané zálohy (vyžaduje se longTermRetentionBackupResourceId). |
|
properties.creationDate |
string |
Datum vytvoření databáze. |
properties.defaultSecondaryLocation |
string |
Geograficky spárovaná oblast |
properties.earliestRestorePoint |
string |
Nejstarší bod obnovení v čase pro obnovení k určitému bodu v čase |
properties.failoverGroupId |
string |
Identifikátor prostředku skupiny převzetí služeb při selhání instance, do kterého tato spravovaná databáze patří. |
properties.lastBackupName |
string |
Název posledního záložního souboru pro obnovení této spravované databáze. |
properties.longTermRetentionBackupResourceId |
string |
Název zálohy dlouhodobého uchovávání, která se má použít k obnovení této spravované databáze. |
properties.recoverableDatabaseId |
string |
Identifikátor prostředku obnovitelné databáze přidružené k operaci vytvoření této databáze. |
properties.restorableDroppedDatabaseId |
string |
ID obnovitelného vyřazeného prostředku databáze, které se má obnovit při vytváření této databáze. |
properties.restorePointInTime |
string |
Podmíněné. Pokud je createMode PointInTimeRestore, je tato hodnota povinná. Určuje bod v čase (ISO8601 formát) zdrojové databáze, která se obnoví za účelem vytvoření nové databáze. |
properties.sourceDatabaseId |
string |
Identifikátor prostředku zdrojové databáze přidružené k operaci vytvoření této databáze. |
properties.status |
Stav databáze. |
|
properties.storageContainerSasToken |
string |
Podmíněné. Pokud je createMode RestoreExternalBackup, je tato hodnota povinná. Určuje token SAS kontejneru úložiště. |
properties.storageContainerUri |
string |
Podmíněné. Pokud je createMode RestoreExternalBackup, je tato hodnota povinná. Určuje identifikátor URI kontejneru úložiště, ve kterém se ukládají zálohy pro toto obnovení. |
tags |
object |
Značky prostředků. |
type |
string |
Typ prostředku. |
ManagedDatabaseCreateMode
Režim vytváření spravované databáze. PointInTimeRestore: Vytvořte databázi obnovením zálohy existující databáze k určitému bodu v čase. Musí být zadány názvy SourceDatabaseName, SourceManagedInstanceName a PointInTime. RestoreExternalBackup: Vytvořte databázi obnovením z externích záložních souborů. Musí být zadány kolace, StorageContainerUri a StorageContainerSasToken. Obnovení: Vytvoří databázi obnovením geograficky replikované zálohy. Jako ID obnovitelného prostředku databáze k obnovení je nutné zadat RecoverableDatabaseId. RestoreLongTermRetentionBackup: Vytvořte databázi obnovením z dlouhodobě uchovávané zálohy (vyžaduje se longTermRetentionBackupResourceId).
Name | Typ | Description |
---|---|---|
Default |
string |
|
PointInTimeRestore |
string |
|
Recovery |
string |
|
RestoreExternalBackup |
string |
|
RestoreLongTermRetentionBackup |
string |
ManagedDatabaseStatus
Stav databáze.
Name | Typ | Description |
---|---|---|
Creating |
string |
|
Inaccessible |
string |
|
Offline |
string |
|
Online |
string |
|
Restoring |
string |
|
Shutdown |
string |
|
Updating |
string |