Managed Databases - Create Or Update
Crea un nuovo database o aggiorna un database esistente.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}?api-version=2021-11-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
database
|
path | True |
string |
Nome del database. |
managed
|
path | True |
string |
Nome dell'istanza gestita. |
resource
|
path | True |
string |
Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale. |
subscription
|
path | True |
string |
ID sottoscrizione che identifica una sottoscrizione di Azure. |
api-version
|
query | True |
string |
Versione dell'API da usare per la richiesta. |
Corpo della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
location | True |
string |
Percorso della risorsa. |
properties.autoCompleteRestore |
boolean |
Indica se completare automaticamente il ripristino di questo database gestito. |
|
properties.catalogCollation |
Regole di confronto del catalogo di metadati. |
||
properties.collation |
string |
Regole di confronto del database gestito. |
|
properties.createMode |
Modalità di creazione del database gestito. PointInTimeRestore: creare un database ripristinando un backup temporizzato di un database esistente. È necessario specificare SourceDatabaseName, SourceManagedInstanceName e PointInTime. RestoreExternalBackup: creare un database ripristinando da file di backup esterni. È necessario specificare regole di confronto, StorageContainerUri e StorageContainerSasToken. Ripristino: crea un database ripristinando un backup con replica geografica. RecoverableDatabaseId deve essere specificato come ID risorsa di database ripristinabile da ripristinare. RestoreLongTermRetentionBackup: creare un database ripristinando da un backup di conservazione a lungo termine (longTermRetentionBackupResourceId obbligatorio). |
||
properties.lastBackupName |
string |
Cognome del file di backup per il ripristino di questo database gestito. |
|
properties.longTermRetentionBackupResourceId |
string (arm-id) |
Nome del backup di conservazione a lungo termine da usare per il ripristino di questo database gestito. |
|
properties.recoverableDatabaseId |
string (arm-id) |
Identificatore della risorsa del database ripristinabile associato all'operazione di creazione del database. |
|
properties.restorableDroppedDatabaseId |
string (arm-id) |
ID risorsa del database eliminato ripristinabile da ripristinare durante la creazione del database. |
|
properties.restorePointInTime |
string (date-time) |
Condizionale. Se createMode è PointInTimeRestore, questo valore è obbligatorio. Specifica il punto nel tempo (formato ISO8601) del database di origine che verrà ripristinato per creare il nuovo database. |
|
properties.sourceDatabaseId |
string (arm-id) |
Identificatore della risorsa del database di origine associato all'operazione di creazione del database. |
|
properties.storageContainerSasToken |
string |
Condizionale. Se createMode è RestoreExternalBackup, questo valore è obbligatorio. Specifica il token di firma di accesso condiviso del contenitore di archiviazione. |
|
properties.storageContainerUri |
string |
Condizionale. Se createMode è RestoreExternalBackup, questo valore è obbligatorio. Specifica l'URI del contenitore di archiviazione in cui vengono archiviati i backup per questo ripristino. |
|
tags |
object |
Tag di risorsa. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Aggiornamento corretto del database. |
|
201 Created |
Creazione del database completata. |
|
202 Accepted |
Accettato |
|
Other Status Codes |
Risposte di errore:
|
Esempio
Creates a new managed database by restoring from an external backup
Esempio di richiesta
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"
}
Risposta di esempio
{
"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
Esempio di richiesta
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"
}
}
Risposta di esempio
{
"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
Esempio di richiesta
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"
}
Risposta di esempio
{
"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
Esempio di richiesta
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"
}
}
Risposta di esempio
{
"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
Esempio di richiesta
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"
}
Risposta di esempio
{
"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
Esempio di richiesta
Risposta di esempio
{
"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"
}
Definizioni
Nome | Descrizione |
---|---|
Catalog |
Regole di confronto del catalogo di metadati. |
Managed |
Una risorsa di database gestita. |
Managed |
Modalità di creazione del database gestito. PointInTimeRestore: creare un database ripristinando un backup temporizzato di un database esistente. È necessario specificare SourceDatabaseName, SourceManagedInstanceName e PointInTime. RestoreExternalBackup: creare un database ripristinando da file di backup esterni. È necessario specificare regole di confronto, StorageContainerUri e StorageContainerSasToken. Ripristino: crea un database ripristinando un backup con replica geografica. RecoverableDatabaseId deve essere specificato come ID risorsa di database ripristinabile da ripristinare. RestoreLongTermRetentionBackup: creare un database ripristinando da un backup di conservazione a lungo termine (longTermRetentionBackupResourceId obbligatorio). |
Managed |
Stato del database. |
CatalogCollationType
Regole di confronto del catalogo di metadati.
Valore | Descrizione |
---|---|
DATABASE_DEFAULT | |
SQL_Latin1_General_CP1_CI_AS |
ManagedDatabase
Una risorsa di database gestita.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID risorsa. |
location |
string |
Percorso della risorsa. |
name |
string |
Nome risorsa. |
properties.autoCompleteRestore |
boolean |
Indica se completare automaticamente il ripristino di questo database gestito. |
properties.catalogCollation |
Regole di confronto del catalogo di metadati. |
|
properties.collation |
string |
Regole di confronto del database gestito. |
properties.createMode |
Modalità di creazione del database gestito. PointInTimeRestore: creare un database ripristinando un backup temporizzato di un database esistente. È necessario specificare SourceDatabaseName, SourceManagedInstanceName e PointInTime. RestoreExternalBackup: creare un database ripristinando da file di backup esterni. È necessario specificare regole di confronto, StorageContainerUri e StorageContainerSasToken. Ripristino: crea un database ripristinando un backup con replica geografica. RecoverableDatabaseId deve essere specificato come ID risorsa di database ripristinabile da ripristinare. RestoreLongTermRetentionBackup: creare un database ripristinando da un backup di conservazione a lungo termine (longTermRetentionBackupResourceId obbligatorio). |
|
properties.creationDate |
string (date-time) |
Data di creazione del database. |
properties.defaultSecondaryLocation |
string |
Area geografica associata. |
properties.earliestRestorePoint |
string (date-time) |
Punto di ripristino meno recente nel tempo per il ripristino temporizzato. |
properties.failoverGroupId |
string |
Identificatore di risorsa gruppo di failover dell'istanza a cui appartiene il database gestito. |
properties.lastBackupName |
string |
Cognome del file di backup per il ripristino di questo database gestito. |
properties.longTermRetentionBackupResourceId |
string (arm-id) |
Nome del backup di conservazione a lungo termine da usare per il ripristino di questo database gestito. |
properties.recoverableDatabaseId |
string (arm-id) |
Identificatore della risorsa del database ripristinabile associato all'operazione di creazione del database. |
properties.restorableDroppedDatabaseId |
string (arm-id) |
ID risorsa del database eliminato ripristinabile da ripristinare durante la creazione del database. |
properties.restorePointInTime |
string (date-time) |
Condizionale. Se createMode è PointInTimeRestore, questo valore è obbligatorio. Specifica il punto nel tempo (formato ISO8601) del database di origine che verrà ripristinato per creare il nuovo database. |
properties.sourceDatabaseId |
string (arm-id) |
Identificatore della risorsa del database di origine associato all'operazione di creazione del database. |
properties.status |
Stato del database. |
|
properties.storageContainerSasToken |
string |
Condizionale. Se createMode è RestoreExternalBackup, questo valore è obbligatorio. Specifica il token di firma di accesso condiviso del contenitore di archiviazione. |
properties.storageContainerUri |
string |
Condizionale. Se createMode è RestoreExternalBackup, questo valore è obbligatorio. Specifica l'URI del contenitore di archiviazione in cui vengono archiviati i backup per questo ripristino. |
tags |
object |
Tag di risorsa. |
type |
string |
Tipo di risorsa. |
ManagedDatabaseCreateMode
Modalità di creazione del database gestito. PointInTimeRestore: creare un database ripristinando un backup temporizzato di un database esistente. È necessario specificare SourceDatabaseName, SourceManagedInstanceName e PointInTime. RestoreExternalBackup: creare un database ripristinando da file di backup esterni. È necessario specificare regole di confronto, StorageContainerUri e StorageContainerSasToken. Ripristino: crea un database ripristinando un backup con replica geografica. RecoverableDatabaseId deve essere specificato come ID risorsa di database ripristinabile da ripristinare. RestoreLongTermRetentionBackup: creare un database ripristinando da un backup di conservazione a lungo termine (longTermRetentionBackupResourceId obbligatorio).
Valore | Descrizione |
---|---|
Default | |
PointInTimeRestore | |
Recovery | |
RestoreExternalBackup | |
RestoreLongTermRetentionBackup |
ManagedDatabaseStatus
Stato del database.
Valore | Descrizione |
---|---|
Creating | |
Inaccessible | |
Offline | |
Online | |
Restoring | |
Shutdown | |
Updating |