Managed Databases - Create Or Update
Hiermee maakt u een nieuwe database of werkt u een bestaande database bij.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}?api-version=2021-11-01
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
database
|
path | True |
string |
De naam van de database. |
managed
|
path | True |
string |
De naam van het beheerde exemplaar. |
resource
|
path | True |
string |
De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal. |
subscription
|
path | True |
string |
De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd. |
api-version
|
query | True |
string |
De API-versie die moet worden gebruikt voor de aanvraag. |
Aanvraagbody
Name | Vereist | Type | Description |
---|---|---|---|
location | True |
string |
Resourcelocatie. |
properties.autoCompleteRestore |
boolean |
Of de herstelbewerking van deze beheerde database automatisch moet worden voltooid. |
|
properties.catalogCollation |
Sortering van de metagegevenscatalogus. |
||
properties.collation |
string |
Sortering van de beheerde database. |
|
properties.createMode |
Modus voor het maken van beheerde databases. PointInTimeRestore: maak een database door een back-up naar een bepaald tijdstip van een bestaande database te herstellen. SourceDatabaseName, SourceManagedInstanceName en PointInTime moeten worden opgegeven. RestoreExternalBackup: maak een database door te herstellen vanuit externe back-upbestanden. Sortering, StorageContainerUri en StorageContainerSasToken moeten worden opgegeven. Herstel: Hiermee maakt u een database door een geo-gerepliceerde back-up te herstellen. RecoverableDatabaseId moet worden opgegeven als de herstelbare databaseresource-id om te herstellen. RestoreLongTermRetentionBackup: maak een database door een back-up met langetermijnretentie te herstellen (longTermRetentionBackupResourceId vereist). |
||
properties.lastBackupName |
string |
Naam van het laatste back-upbestand voor het herstellen van deze beheerde database. |
|
properties.longTermRetentionBackupResourceId |
string |
De naam van de back-up voor langetermijnretentie die moet worden gebruikt voor het herstellen van deze beheerde database. |
|
properties.recoverableDatabaseId |
string |
De resource-id van de herstelbare database die is gekoppeld aan de maakbewerking van deze database. |
|
properties.restorableDroppedDatabaseId |
string |
De herstelbare databaseresource-id is verwijderd om te herstellen bij het maken van deze database. |
|
properties.restorePointInTime |
string |
Voorwaardelijke. Als createMode PointInTimeRestore is, is deze waarde vereist. Hiermee geeft u het tijdstip (ISO8601 indeling) op van de brondatabase die wordt hersteld om de nieuwe database te maken. |
|
properties.sourceDatabaseId |
string |
De resource-id van de brondatabase die is gekoppeld aan het maken van deze database. |
|
properties.storageContainerSasToken |
string |
Voorwaardelijke. Als createMode RestoreExternalBackup is, is deze waarde vereist. Hiermee geeft u het sas-token voor de opslagcontainer op. |
|
properties.storageContainerUri |
string |
Voorwaardelijke. Als createMode RestoreExternalBackup is, is deze waarde vereist. Hiermee geeft u de URI van de opslagcontainer waar back-ups voor dit herstel worden opgeslagen. |
|
tags |
object |
Resourcetags. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
De database is bijgewerkt. |
|
201 Created |
De database is gemaakt. |
|
202 Accepted |
Geaccepteerd |
|
Other Status Codes |
Foutreacties: ***
|
Voorbeelden
Creates a new managed database by restoring from an external backup
Voorbeeldaanvraag
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"
}
Voorbeeldrespons
{
"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
Voorbeeldaanvraag
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"
}
}
Voorbeeldrespons
{
"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
Voorbeeldaanvraag
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"
}
Voorbeeldrespons
{
"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
Voorbeeldaanvraag
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"
}
}
Voorbeeldrespons
{
"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
Voorbeeldaanvraag
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"
}
Voorbeeldrespons
{
"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
Voorbeeldaanvraag
Voorbeeldrespons
{
"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"
}
Definities
Name | Description |
---|---|
Catalog |
Sortering van de metagegevenscatalogus. |
Managed |
Een beheerde databaseresource. |
Managed |
Modus voor het maken van beheerde databases. PointInTimeRestore: maak een database door een back-up naar een bepaald tijdstip van een bestaande database te herstellen. SourceDatabaseName, SourceManagedInstanceName en PointInTime moeten worden opgegeven. RestoreExternalBackup: maak een database door te herstellen vanuit externe back-upbestanden. Sortering, StorageContainerUri en StorageContainerSasToken moeten worden opgegeven. Herstel: Hiermee maakt u een database door een geo-gerepliceerde back-up te herstellen. RecoverableDatabaseId moet worden opgegeven als de herstelbare databaseresource-id om te herstellen. RestoreLongTermRetentionBackup: maak een database door een back-up met langetermijnretentie te herstellen (longTermRetentionBackupResourceId vereist). |
Managed |
Status van de database. |
CatalogCollationType
Sortering van de metagegevenscatalogus.
Name | Type | Description |
---|---|---|
DATABASE_DEFAULT |
string |
|
SQL_Latin1_General_CP1_CI_AS |
string |
ManagedDatabase
Een beheerde databaseresource.
Name | Type | Description |
---|---|---|
id |
string |
Resource-id. |
location |
string |
Resourcelocatie. |
name |
string |
Resourcenaam. |
properties.autoCompleteRestore |
boolean |
Of de herstelbewerking van deze beheerde database automatisch moet worden voltooid. |
properties.catalogCollation |
Sortering van de metagegevenscatalogus. |
|
properties.collation |
string |
Sortering van de beheerde database. |
properties.createMode |
Modus voor het maken van beheerde databases. PointInTimeRestore: maak een database door een back-up naar een bepaald tijdstip van een bestaande database te herstellen. SourceDatabaseName, SourceManagedInstanceName en PointInTime moeten worden opgegeven. RestoreExternalBackup: maak een database door te herstellen vanuit externe back-upbestanden. Sortering, StorageContainerUri en StorageContainerSasToken moeten worden opgegeven. Herstel: Hiermee maakt u een database door een geo-gerepliceerde back-up te herstellen. RecoverableDatabaseId moet worden opgegeven als de herstelbare databaseresource-id om te herstellen. RestoreLongTermRetentionBackup: maak een database door een back-up met langetermijnretentie te herstellen (longTermRetentionBackupResourceId vereist). |
|
properties.creationDate |
string |
Aanmaakdatum van de database. |
properties.defaultSecondaryLocation |
string |
Geografisch gekoppelde regio. |
properties.earliestRestorePoint |
string |
Vroegst herstelpunt in tijd voor herstel naar een bepaald tijdstip. |
properties.failoverGroupId |
string |
Resource-id van exemplaarfailovergroep waartoe deze beheerde database behoort. |
properties.lastBackupName |
string |
Naam van het laatste back-upbestand voor het herstellen van deze beheerde database. |
properties.longTermRetentionBackupResourceId |
string |
De naam van de back-up voor langetermijnretentie die moet worden gebruikt voor het herstellen van deze beheerde database. |
properties.recoverableDatabaseId |
string |
De resource-id van de herstelbare database die is gekoppeld aan de maakbewerking van deze database. |
properties.restorableDroppedDatabaseId |
string |
De herstelbare databaseresource-id is verwijderd om te herstellen bij het maken van deze database. |
properties.restorePointInTime |
string |
Voorwaardelijke. Als createMode PointInTimeRestore is, is deze waarde vereist. Hiermee geeft u het tijdstip (ISO8601 indeling) op van de brondatabase die wordt hersteld om de nieuwe database te maken. |
properties.sourceDatabaseId |
string |
De resource-id van de brondatabase die is gekoppeld aan het maken van deze database. |
properties.status |
Status van de database. |
|
properties.storageContainerSasToken |
string |
Voorwaardelijke. Als createMode RestoreExternalBackup is, is deze waarde vereist. Hiermee geeft u het sas-token voor de opslagcontainer op. |
properties.storageContainerUri |
string |
Voorwaardelijke. Als createMode RestoreExternalBackup is, is deze waarde vereist. Hiermee geeft u de URI van de opslagcontainer waar back-ups voor dit herstel worden opgeslagen. |
tags |
object |
Resourcetags. |
type |
string |
Resourcetype. |
ManagedDatabaseCreateMode
Modus voor het maken van beheerde databases. PointInTimeRestore: maak een database door een back-up naar een bepaald tijdstip van een bestaande database te herstellen. SourceDatabaseName, SourceManagedInstanceName en PointInTime moeten worden opgegeven. RestoreExternalBackup: maak een database door te herstellen vanuit externe back-upbestanden. Sortering, StorageContainerUri en StorageContainerSasToken moeten worden opgegeven. Herstel: Hiermee maakt u een database door een geo-gerepliceerde back-up te herstellen. RecoverableDatabaseId moet worden opgegeven als de herstelbare databaseresource-id om te herstellen. RestoreLongTermRetentionBackup: maak een database door een back-up met langetermijnretentie te herstellen (longTermRetentionBackupResourceId vereist).
Name | Type | Description |
---|---|---|
Default |
string |
|
PointInTimeRestore |
string |
|
Recovery |
string |
|
RestoreExternalBackup |
string |
|
RestoreLongTermRetentionBackup |
string |
ManagedDatabaseStatus
Status van de database.
Name | Type | Description |
---|---|---|
Creating |
string |
|
Inaccessible |
string |
|
Offline |
string |
|
Online |
string |
|
Restoring |
string |
|
Shutdown |
string |
|
Updating |
string |