Managed Databases - Create Or Update
Crea una nueva base de datos o actualiza una ya existente.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}?api-version=2021-11-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
database
|
path | True |
string |
El nombre de la base de datos. |
managed
|
path | True |
string |
El nombre de la instancia administrada. |
resource
|
path | True |
string |
Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure. |
subscription
|
path | True |
string |
El id. de suscripción que identifica una suscripción de Azure. |
api-version
|
query | True |
string |
La versión de API que se usará para la solicitud. |
Cuerpo de la solicitud
Nombre | Requerido | Tipo | Description |
---|---|---|---|
location | True |
string |
Ubicación del recurso |
properties.autoCompleteRestore |
boolean |
Si se va a completar automáticamente la restauración de esta base de datos administrada. |
|
properties.catalogCollation |
Intercalación del catálogo de metadatos. |
||
properties.collation |
string |
Intercalación de la base de datos administrada. |
|
properties.createMode |
Modo de creación de base de datos administrada. PointInTimeRestore: cree una base de datos restaurando una copia de seguridad a un momento dado de una base de datos existente. SourceDatabaseName, SourceManagedInstanceName y PointInTime deben especificarse. RestoreExternalBackup: cree una base de datos mediante la restauración a partir de archivos de copia de seguridad externos. Se deben especificar intercalación, StorageContainerUri y StorageContainerSasToken. Recuperación: crea una base de datos restaurando una copia de seguridad con replicación geográfica. RecoverableDatabaseId debe especificarse como identificador de recurso de base de datos recuperable para restaurar. RestoreLongTermRetentionBackup: cree una base de datos mediante la restauración a partir de una copia de seguridad de retención a largo plazo (se requiere longTermRetentionBackupResourceId). |
||
properties.lastBackupName |
string |
Último nombre de archivo de copia de seguridad para la restauración de esta base de datos administrada. |
|
properties.longTermRetentionBackupResourceId |
string |
Nombre de la copia de seguridad de retención a largo plazo que se usará para la restauración de esta base de datos administrada. |
|
properties.recoverableDatabaseId |
string |
Identificador de recurso de la base de datos recuperable asociada a la operación de creación de esta base de datos. |
|
properties.restorableDroppedDatabaseId |
string |
Identificador de recurso de base de datos eliminado que se puede restaurar al crear esta base de datos. |
|
properties.restorePointInTime |
string |
Condicional. Si createMode es PointInTimeRestore, se requiere este valor. Especifica el momento dado (ISO8601 formato) de la base de datos de origen que se restaurará para crear la nueva base de datos. |
|
properties.sourceDatabaseId |
string |
Identificador de recurso de la base de datos de origen asociada a la operación de creación de esta base de datos. |
|
properties.storageContainerSasToken |
string |
Condicional. Si createMode es RestoreExternalBackup, se requiere este valor. Especifica el token sas del contenedor de almacenamiento. |
|
properties.storageContainerUri |
string |
Condicional. Si createMode es RestoreExternalBackup, se requiere este valor. Especifica el URI del contenedor de almacenamiento donde se almacenan las copias de seguridad de esta restauración. |
|
tags |
object |
Etiquetas del recurso. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Se actualizó correctamente la base de datos. |
|
201 Created |
Se creó correctamente la base de datos. |
|
202 Accepted |
Aceptado |
|
Other Status Codes |
Respuestas de error: ***
|
Ejemplos
Creates a new managed database by restoring from an external backup
Solicitud de ejemplo
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"
}
Respuesta de muestra
{
"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
Solicitud de ejemplo
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"
}
}
Respuesta de muestra
{
"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
Solicitud de ejemplo
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"
}
Respuesta de muestra
{
"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
Solicitud de ejemplo
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"
}
}
Respuesta de muestra
{
"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
Solicitud de ejemplo
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"
}
Respuesta de muestra
{
"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
Solicitud de ejemplo
Respuesta de muestra
{
"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"
}
Definiciones
Nombre | Description |
---|---|
Catalog |
Intercalación del catálogo de metadatos. |
Managed |
Un recurso de base de datos administrada. |
Managed |
Modo de creación de base de datos administrada. PointInTimeRestore: cree una base de datos restaurando una copia de seguridad a un momento dado de una base de datos existente. SourceDatabaseName, SourceManagedInstanceName y PointInTime deben especificarse. RestoreExternalBackup: cree una base de datos mediante la restauración a partir de archivos de copia de seguridad externos. Se deben especificar intercalación, StorageContainerUri y StorageContainerSasToken. Recuperación: crea una base de datos restaurando una copia de seguridad con replicación geográfica. RecoverableDatabaseId debe especificarse como identificador de recurso de base de datos recuperable para restaurar. RestoreLongTermRetentionBackup: cree una base de datos mediante la restauración a partir de una copia de seguridad de retención a largo plazo (se requiere longTermRetentionBackupResourceId). |
Managed |
Estado de la base de datos. |
CatalogCollationType
Intercalación del catálogo de metadatos.
Nombre | Tipo | Description |
---|---|---|
DATABASE_DEFAULT |
string |
|
SQL_Latin1_General_CP1_CI_AS |
string |
ManagedDatabase
Un recurso de base de datos administrada.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador del recurso. |
location |
string |
Ubicación del recurso |
name |
string |
Nombre del recurso. |
properties.autoCompleteRestore |
boolean |
Si se va a completar automáticamente la restauración de esta base de datos administrada. |
properties.catalogCollation |
Intercalación del catálogo de metadatos. |
|
properties.collation |
string |
Intercalación de la base de datos administrada. |
properties.createMode |
Modo de creación de base de datos administrada. PointInTimeRestore: cree una base de datos restaurando una copia de seguridad a un momento dado de una base de datos existente. SourceDatabaseName, SourceManagedInstanceName y PointInTime deben especificarse. RestoreExternalBackup: cree una base de datos mediante la restauración a partir de archivos de copia de seguridad externos. Se deben especificar intercalación, StorageContainerUri y StorageContainerSasToken. Recuperación: crea una base de datos restaurando una copia de seguridad con replicación geográfica. RecoverableDatabaseId debe especificarse como identificador de recurso de base de datos recuperable para restaurar. RestoreLongTermRetentionBackup: cree una base de datos mediante la restauración a partir de una copia de seguridad de retención a largo plazo (se requiere longTermRetentionBackupResourceId). |
|
properties.creationDate |
string |
Fecha de creación de la base de datos. |
properties.defaultSecondaryLocation |
string |
Región emparejada geográfica. |
properties.earliestRestorePoint |
string |
Un momento dado de restauración más antiguo para la restauración a un momento dado. |
properties.failoverGroupId |
string |
Identificador de recursos del grupo de conmutación por error de instancia al que pertenece esta base de datos administrada. |
properties.lastBackupName |
string |
Último nombre de archivo de copia de seguridad para la restauración de esta base de datos administrada. |
properties.longTermRetentionBackupResourceId |
string |
Nombre de la copia de seguridad de retención a largo plazo que se usará para la restauración de esta base de datos administrada. |
properties.recoverableDatabaseId |
string |
Identificador de recurso de la base de datos recuperable asociada a la operación de creación de esta base de datos. |
properties.restorableDroppedDatabaseId |
string |
Identificador de recurso de base de datos eliminado que se puede restaurar al crear esta base de datos. |
properties.restorePointInTime |
string |
Condicional. Si createMode es PointInTimeRestore, se requiere este valor. Especifica el momento dado (ISO8601 formato) de la base de datos de origen que se restaurará para crear la nueva base de datos. |
properties.sourceDatabaseId |
string |
Identificador de recurso de la base de datos de origen asociada a la operación de creación de esta base de datos. |
properties.status |
Estado de la base de datos. |
|
properties.storageContainerSasToken |
string |
Condicional. Si createMode es RestoreExternalBackup, se requiere este valor. Especifica el token sas del contenedor de almacenamiento. |
properties.storageContainerUri |
string |
Condicional. Si createMode es RestoreExternalBackup, se requiere este valor. Especifica el URI del contenedor de almacenamiento donde se almacenan las copias de seguridad de esta restauración. |
tags |
object |
Etiquetas del recurso. |
type |
string |
Tipo de recurso. |
ManagedDatabaseCreateMode
Modo de creación de base de datos administrada. PointInTimeRestore: cree una base de datos restaurando una copia de seguridad a un momento dado de una base de datos existente. SourceDatabaseName, SourceManagedInstanceName y PointInTime deben especificarse. RestoreExternalBackup: cree una base de datos mediante la restauración a partir de archivos de copia de seguridad externos. Se deben especificar intercalación, StorageContainerUri y StorageContainerSasToken. Recuperación: crea una base de datos restaurando una copia de seguridad con replicación geográfica. RecoverableDatabaseId debe especificarse como identificador de recurso de base de datos recuperable para restaurar. RestoreLongTermRetentionBackup: cree una base de datos mediante la restauración a partir de una copia de seguridad de retención a largo plazo (se requiere longTermRetentionBackupResourceId).
Nombre | Tipo | Description |
---|---|---|
Default |
string |
|
PointInTimeRestore |
string |
|
Recovery |
string |
|
RestoreExternalBackup |
string |
|
RestoreLongTermRetentionBackup |
string |
ManagedDatabaseStatus
Estado de la base de datos.
Nombre | Tipo | Description |
---|---|---|
Creating |
string |
|
Inaccessible |
string |
|
Offline |
string |
|
Online |
string |
|
Restoring |
string |
|
Shutdown |
string |
|
Updating |
string |