Managed Databases - Create Or Update
Tworzy nową bazę danych lub aktualizuje istniejącą bazę danych.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}?api-version=2021-11-01
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
database
|
path | True |
string |
Nazwa bazy danych. |
managed
|
path | True |
string |
Nazwa wystąpienia zarządzanego. |
resource
|
path | True |
string |
Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API Resource Manager platformy Azure lub portalu. |
subscription
|
path | True |
string |
Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure. |
api-version
|
query | True |
string |
Wersja interfejsu API do użycia dla żądania. |
Treść żądania
Nazwa | Wymagane | Typ | Opis |
---|---|---|---|
location | True |
string |
Lokalizacja zasobu. |
properties.autoCompleteRestore |
boolean |
Czy automatyczne przywracanie tej zarządzanej bazy danych ma być ukończone automatycznie. |
|
properties.catalogCollation |
Sortowanie wykazu metadanych. |
||
properties.collation |
string |
Sortowanie zarządzanej bazy danych. |
|
properties.createMode |
Tryb tworzenia zarządzanej bazy danych. PointInTimeRestore: utwórz bazę danych, przywracając kopię zapasową istniejącej bazy danych do punktu w czasie. Należy określić wartości SourceDatabaseName, SourceManagedInstanceName i PointInTime. RestoreExternalBackup: utwórz bazę danych, przywracając z zewnętrznych plików kopii zapasowej. Należy określić sortowanie, wartości StorageContainerUri i StorageContainerSasToken. Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. W celu przywrócenia identyfikator zasobu bazy danych możliwy do odzyskania należy określić parametr RecoverableDatabaseId. RestoreLongTermRetentionBackup: utwórz bazę danych przez przywrócenie z kopii zapasowej długoterminowego przechowywania (wymagana wartość longTermRetentionBackupResourceId). |
||
properties.lastBackupName |
string |
Ostatnia nazwa pliku kopii zapasowej na potrzeby przywracania tej zarządzanej bazy danych. |
|
properties.longTermRetentionBackupResourceId |
string |
Nazwa kopii zapasowej przechowywania długoterminowego, która ma być używana do przywracania tej zarządzanej bazy danych. |
|
properties.recoverableDatabaseId |
string |
Identyfikator zasobu możliwej do odzyskania bazy danych skojarzony z operacją tworzenia tej bazy danych. |
|
properties.restorableDroppedDatabaseId |
string |
Przywracalny identyfikator usuniętego zasobu bazy danych do przywrócenia podczas tworzenia tej bazy danych. |
|
properties.restorePointInTime |
string |
Warunkowe. Jeśli parametr createMode to PointInTimeRestore, ta wartość jest wymagana. Określa punkt w czasie (format ISO8601) źródłowej bazy danych, która zostanie przywrócona w celu utworzenia nowej bazy danych. |
|
properties.sourceDatabaseId |
string |
Identyfikator zasobu źródłowej bazy danych skojarzonej z operacją tworzenia tej bazy danych. |
|
properties.storageContainerSasToken |
string |
Warunkowe. Jeśli parametr createMode to RestoreExternalBackup, ta wartość jest wymagana. Określa token sas kontenera magazynu. |
|
properties.storageContainerUri |
string |
Warunkowe. Jeśli parametr createMode to RestoreExternalBackup, ta wartość jest wymagana. Określa identyfikator URI kontenera magazynu, w którym są przechowywane kopie zapasowe dla tego przywracania. |
|
tags |
object |
Tagi zasobów. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Pomyślnie zaktualizowano bazę danych. |
|
201 Created |
Pomyślnie utworzono bazę danych. |
|
202 Accepted |
Zaakceptowano |
|
Other Status Codes |
Odpowiedzi na błędy: ***
|
Przykłady
Creates a new managed database by restoring from an external backup
Przykładowe żądanie
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"
}
Przykładowa odpowiedź
{
"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
Przykładowe żądanie
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"
}
}
Przykładowa odpowiedź
{
"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
Przykładowe żądanie
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"
}
Przykładowa odpowiedź
{
"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
Przykładowe żądanie
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"
}
}
Przykładowa odpowiedź
{
"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
Przykładowe żądanie
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"
}
Przykładowa odpowiedź
{
"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
Przykładowe żądanie
Przykładowa odpowiedź
{
"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"
}
Definicje
Nazwa | Opis |
---|---|
Catalog |
Sortowanie wykazu metadanych. |
Managed |
Zasób zarządzanej bazy danych. |
Managed |
Tryb tworzenia zarządzanej bazy danych. PointInTimeRestore: utwórz bazę danych, przywracając kopię zapasową istniejącej bazy danych do punktu w czasie. Należy określić wartości SourceDatabaseName, SourceManagedInstanceName i PointInTime. RestoreExternalBackup: utwórz bazę danych, przywracając z zewnętrznych plików kopii zapasowej. Należy określić sortowanie, wartości StorageContainerUri i StorageContainerSasToken. Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. W celu przywrócenia identyfikator zasobu bazy danych możliwy do odzyskania należy określić parametr RecoverableDatabaseId. RestoreLongTermRetentionBackup: utwórz bazę danych przez przywrócenie z kopii zapasowej długoterminowego przechowywania (wymagana wartość longTermRetentionBackupResourceId). |
Managed |
Stan bazy danych. |
CatalogCollationType
Sortowanie wykazu metadanych.
Wartość | Opis |
---|---|
DATABASE_DEFAULT | |
SQL_Latin1_General_CP1_CI_AS |
ManagedDatabase
Zasób zarządzanej bazy danych.
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Identyfikator zasobu. |
location |
string |
Lokalizacja zasobu. |
name |
string |
Nazwa zasobu. |
properties.autoCompleteRestore |
boolean |
Czy automatyczne przywracanie tej zarządzanej bazy danych ma być ukończone automatycznie. |
properties.catalogCollation |
Sortowanie wykazu metadanych. |
|
properties.collation |
string |
Sortowanie zarządzanej bazy danych. |
properties.createMode |
Tryb tworzenia zarządzanej bazy danych. PointInTimeRestore: utwórz bazę danych, przywracając kopię zapasową istniejącej bazy danych do punktu w czasie. Należy określić wartości SourceDatabaseName, SourceManagedInstanceName i PointInTime. RestoreExternalBackup: utwórz bazę danych, przywracając z zewnętrznych plików kopii zapasowej. Należy określić sortowanie, wartości StorageContainerUri i StorageContainerSasToken. Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. W celu przywrócenia identyfikator zasobu bazy danych możliwy do odzyskania należy określić parametr RecoverableDatabaseId. RestoreLongTermRetentionBackup: utwórz bazę danych przez przywrócenie z kopii zapasowej długoterminowego przechowywania (wymagana wartość longTermRetentionBackupResourceId). |
|
properties.creationDate |
string |
Data utworzenia bazy danych. |
properties.defaultSecondaryLocation |
string |
Region sparowany geograficznie. |
properties.earliestRestorePoint |
string |
Najwcześniejszy punkt przywracania w czasie dla przywracania do punktu w czasie. |
properties.failoverGroupId |
string |
Identyfikator zasobu grupy trybu failover wystąpienia, do którego należy ta zarządzana baza danych. |
properties.lastBackupName |
string |
Ostatnia nazwa pliku kopii zapasowej na potrzeby przywracania tej zarządzanej bazy danych. |
properties.longTermRetentionBackupResourceId |
string |
Nazwa kopii zapasowej przechowywania długoterminowego, która ma być używana do przywracania tej zarządzanej bazy danych. |
properties.recoverableDatabaseId |
string |
Identyfikator zasobu możliwej do odzyskania bazy danych skojarzony z operacją tworzenia tej bazy danych. |
properties.restorableDroppedDatabaseId |
string |
Przywracalny identyfikator usuniętego zasobu bazy danych do przywrócenia podczas tworzenia tej bazy danych. |
properties.restorePointInTime |
string |
Warunkowe. Jeśli parametr createMode to PointInTimeRestore, ta wartość jest wymagana. Określa punkt w czasie (format ISO8601) źródłowej bazy danych, która zostanie przywrócona w celu utworzenia nowej bazy danych. |
properties.sourceDatabaseId |
string |
Identyfikator zasobu źródłowej bazy danych skojarzonej z operacją tworzenia tej bazy danych. |
properties.status |
Stan bazy danych. |
|
properties.storageContainerSasToken |
string |
Warunkowe. Jeśli parametr createMode to RestoreExternalBackup, ta wartość jest wymagana. Określa token sas kontenera magazynu. |
properties.storageContainerUri |
string |
Warunkowe. Jeśli parametr createMode to RestoreExternalBackup, ta wartość jest wymagana. Określa identyfikator URI kontenera magazynu, w którym są przechowywane kopie zapasowe dla tego przywracania. |
tags |
object |
Tagi zasobów. |
type |
string |
Typ zasobu. |
ManagedDatabaseCreateMode
Tryb tworzenia zarządzanej bazy danych. PointInTimeRestore: utwórz bazę danych, przywracając kopię zapasową istniejącej bazy danych do punktu w czasie. Należy określić wartości SourceDatabaseName, SourceManagedInstanceName i PointInTime. RestoreExternalBackup: utwórz bazę danych, przywracając z zewnętrznych plików kopii zapasowej. Należy określić sortowanie, wartości StorageContainerUri i StorageContainerSasToken. Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. W celu przywrócenia identyfikator zasobu bazy danych możliwy do odzyskania należy określić parametr RecoverableDatabaseId. RestoreLongTermRetentionBackup: utwórz bazę danych przez przywrócenie z kopii zapasowej długoterminowego przechowywania (wymagana wartość longTermRetentionBackupResourceId).
Wartość | Opis |
---|---|
Default | |
PointInTimeRestore | |
Recovery | |
RestoreExternalBackup | |
RestoreLongTermRetentionBackup |
ManagedDatabaseStatus
Stan bazy danych.
Wartość | Opis |
---|---|
Creating | |
Inaccessible | |
Offline | |
Online | |
Restoring | |
Shutdown | |
Updating |