Managed Databases - Create Or Update
Cria uma nova base de dados ou atualiza uma base de dados existente.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}?api-version=2021-11-01
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
database
|
path | True |
string |
O nome da base de dados. |
managed
|
path | True |
string |
O nome da instância gerida. |
resource
|
path | True |
string |
O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal. |
subscription
|
path | True |
string |
O ID da subscrição que identifica uma subscrição do Azure. |
api-version
|
query | True |
string |
A versão da API a utilizar para o pedido. |
Corpo do Pedido
Name | Necessário | Tipo | Description |
---|---|---|---|
location | True |
string |
Localização do recurso. |
properties.autoCompleteRestore |
boolean |
Se pretende concluir automaticamente o restauro desta base de dados gerida. |
|
properties.catalogCollation |
Agrupamento do catálogo de metadados. |
||
properties.collation |
string |
Agrupamento da base de dados gerida. |
|
properties.createMode |
Modo de criação de base de dados gerida. PointInTimeRestore: crie uma base de dados ao restaurar uma cópia de segurança para um ponto anterior no tempo de uma base de dados existente. SourceDatabaseName, SourceManagedInstanceName e PointInTime têm de ser especificados. RestoreExternalBackup: crie uma base de dados ao restaurar a partir de ficheiros de cópia de segurança externos. O agrupamento, StorageContainerUri e StorageContainerSasToken têm de ser especificados. Recuperação: cria uma base de dados ao restaurar uma cópia de segurança georreplicada. RecoverableDatabaseId tem de ser especificado como o ID de recurso de base de dados recuperável a restaurar. RestoreLongTermRetentionBackup: crie uma base de dados ao restaurar a partir de uma cópia de segurança de retenção de longo prazo (longTermRetentionBackupResourceId necessário). |
||
properties.lastBackupName |
string |
Último nome de ficheiro de cópia de segurança para restaurar esta base de dados gerida. |
|
properties.longTermRetentionBackupResourceId |
string |
O nome da cópia de segurança de Retenção de Longo Prazo a utilizar para restaurar esta base de dados gerida. |
|
properties.recoverableDatabaseId |
string |
O identificador de recursos da base de dados recuperável associada à operação de criação desta base de dados. |
|
properties.restorableDroppedDatabaseId |
string |
O ID de recurso de base de dados removido restauráveis para restaurar ao criar esta base de dados. |
|
properties.restorePointInTime |
string |
Condicional. Se createMode for PointInTimeRestore, este valor é necessário. Especifica o ponto anterior no tempo (ISO8601 formato) da base de dados de origem que será restaurada para criar a nova base de dados. |
|
properties.sourceDatabaseId |
string |
O identificador de recursos da base de dados de origem associada à operação de criação desta base de dados. |
|
properties.storageContainerSasToken |
string |
Condicional. Se createMode for RestoreExternalBackup, este valor é necessário. Especifica o token sas do contentor de armazenamento. |
|
properties.storageContainerUri |
string |
Condicional. Se createMode for RestoreExternalBackup, este valor é necessário. Especifica o URI do contentor de armazenamento onde as cópias de segurança para este restauro são armazenadas. |
|
tags |
object |
Etiquetas de recursos. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
A base de dados foi atualizada com êxito. |
|
201 Created |
A base de dados foi criada com êxito. |
|
202 Accepted |
Aceite |
|
Other Status Codes |
Respostas de Erro: ***
|
Exemplos
Creates a new managed database by restoring from an external backup
Pedido de amostra
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"
}
Resposta da amostra
{
"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
Pedido de amostra
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"
}
}
Resposta da amostra
{
"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
Pedido de amostra
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"
}
Resposta da amostra
{
"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
Pedido de amostra
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"
}
}
Resposta da amostra
{
"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
Pedido de amostra
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"
}
Resposta da amostra
{
"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
Pedido de amostra
Resposta da amostra
{
"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"
}
Definições
Name | Description |
---|---|
Catalog |
Agrupamento do catálogo de metadados. |
Managed |
Um recurso de base de dados gerida. |
Managed |
Modo de criação de base de dados gerida. PointInTimeRestore: crie uma base de dados ao restaurar uma cópia de segurança para um ponto anterior no tempo de uma base de dados existente. SourceDatabaseName, SourceManagedInstanceName e PointInTime têm de ser especificados. RestoreExternalBackup: crie uma base de dados ao restaurar a partir de ficheiros de cópia de segurança externos. O agrupamento, StorageContainerUri e StorageContainerSasToken têm de ser especificados. Recuperação: cria uma base de dados ao restaurar uma cópia de segurança georreplicada. RecoverableDatabaseId tem de ser especificado como o ID de recurso de base de dados recuperável a restaurar. RestoreLongTermRetentionBackup: crie uma base de dados ao restaurar a partir de uma cópia de segurança de retenção de longo prazo (longTermRetentionBackupResourceId necessário). |
Managed |
Estado da base de dados. |
CatalogCollationType
Agrupamento do catálogo de metadados.
Name | Tipo | Description |
---|---|---|
DATABASE_DEFAULT |
string |
|
SQL_Latin1_General_CP1_CI_AS |
string |
ManagedDatabase
Um recurso de base de dados gerida.
Name | Tipo | Description |
---|---|---|
id |
string |
ID do Recurso. |
location |
string |
Localização do recurso. |
name |
string |
Nome do recurso. |
properties.autoCompleteRestore |
boolean |
Se pretende concluir automaticamente o restauro desta base de dados gerida. |
properties.catalogCollation |
Agrupamento do catálogo de metadados. |
|
properties.collation |
string |
Agrupamento da base de dados gerida. |
properties.createMode |
Modo de criação de base de dados gerida. PointInTimeRestore: crie uma base de dados ao restaurar uma cópia de segurança para um ponto anterior no tempo de uma base de dados existente. SourceDatabaseName, SourceManagedInstanceName e PointInTime têm de ser especificados. RestoreExternalBackup: crie uma base de dados ao restaurar a partir de ficheiros de cópia de segurança externos. O agrupamento, StorageContainerUri e StorageContainerSasToken têm de ser especificados. Recuperação: cria uma base de dados ao restaurar uma cópia de segurança georreplicada. RecoverableDatabaseId tem de ser especificado como o ID de recurso de base de dados recuperável a restaurar. RestoreLongTermRetentionBackup: crie uma base de dados ao restaurar a partir de uma cópia de segurança de retenção de longo prazo (longTermRetentionBackupResourceId necessário). |
|
properties.creationDate |
string |
Data de criação da base de dados. |
properties.defaultSecondaryLocation |
string |
Região emparelhada geográfica. |
properties.earliestRestorePoint |
string |
Ponto anterior no tempo de restauro para restauro para um ponto anterior no tempo. |
properties.failoverGroupId |
string |
Identificador de recurso do Grupo de Ativação Pós-falha de Instância a que esta base de dados gerida pertence. |
properties.lastBackupName |
string |
Último nome de ficheiro de cópia de segurança para restaurar esta base de dados gerida. |
properties.longTermRetentionBackupResourceId |
string |
O nome da cópia de segurança de Retenção de Longo Prazo a utilizar para restaurar esta base de dados gerida. |
properties.recoverableDatabaseId |
string |
O identificador de recursos da base de dados recuperável associada à operação de criação desta base de dados. |
properties.restorableDroppedDatabaseId |
string |
O ID de recurso de base de dados removido restauráveis para restaurar ao criar esta base de dados. |
properties.restorePointInTime |
string |
Condicional. Se createMode for PointInTimeRestore, este valor é necessário. Especifica o ponto anterior no tempo (ISO8601 formato) da base de dados de origem que será restaurada para criar a nova base de dados. |
properties.sourceDatabaseId |
string |
O identificador de recursos da base de dados de origem associada à operação de criação desta base de dados. |
properties.status |
Estado da base de dados. |
|
properties.storageContainerSasToken |
string |
Condicional. Se createMode for RestoreExternalBackup, este valor é necessário. Especifica o token sas do contentor de armazenamento. |
properties.storageContainerUri |
string |
Condicional. Se createMode for RestoreExternalBackup, este valor é necessário. Especifica o URI do contentor de armazenamento onde as cópias de segurança para este restauro são armazenadas. |
tags |
object |
Etiquetas de recursos. |
type |
string |
Tipo de recurso. |
ManagedDatabaseCreateMode
Modo de criação de base de dados gerida. PointInTimeRestore: crie uma base de dados ao restaurar uma cópia de segurança para um ponto anterior no tempo de uma base de dados existente. SourceDatabaseName, SourceManagedInstanceName e PointInTime têm de ser especificados. RestoreExternalBackup: crie uma base de dados ao restaurar a partir de ficheiros de cópia de segurança externos. O agrupamento, StorageContainerUri e StorageContainerSasToken têm de ser especificados. Recuperação: cria uma base de dados ao restaurar uma cópia de segurança georreplicada. RecoverableDatabaseId tem de ser especificado como o ID de recurso de base de dados recuperável a restaurar. RestoreLongTermRetentionBackup: crie uma base de dados ao restaurar a partir de uma cópia de segurança de retenção de longo prazo (longTermRetentionBackupResourceId necessário).
Name | Tipo | Description |
---|---|---|
Default |
string |
|
PointInTimeRestore |
string |
|
Recovery |
string |
|
RestoreExternalBackup |
string |
|
RestoreLongTermRetentionBackup |
string |
ManagedDatabaseStatus
Estado da base de dados.
Name | Tipo | Description |
---|---|---|
Creating |
string |
|
Inaccessible |
string |
|
Offline |
string |
|
Online |
string |
|
Restoring |
string |
|
Shutdown |
string |
|
Updating |
string |