Managed Databases - Update
Aktualisiert eine vorhandene Datenbank.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}?api-version=2023-08-01
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
database
|
path | True |
string |
Der Name der Datenbank. |
|
managed
|
path | True |
string |
Der Name der verwalteten Instanz. |
|
resource
|
path | True |
string |
Der Name der Ressourcengruppe, die die Ressource enthält. Sie können diesen Wert aus der Azure Resource Manager-API oder dem Portal abrufen. |
|
subscription
|
path | True |
string |
Die Abonnement-ID, die ein Azure-Abonnement identifiziert. |
|
api-version
|
query | True |
string |
Die API-Version, die für die Anforderung verwendet werden soll. |
Anforderungstext
| Name | Typ | Beschreibung |
|---|---|---|
| properties.autoCompleteRestore |
boolean |
Gibt an, ob die Wiederherstellung dieser verwalteten Datenbank automatisch abgeschlossen werden soll. |
| properties.catalogCollation |
Sortierung des Metadatenkatalogs. |
|
| properties.collation |
string |
Sortierung der verwalteten Datenbank. |
| properties.createMode |
Verwalteter Datenbankerstellungsmodus. PointInTimeRestore: Erstellen Sie eine Datenbank, indem Sie eine Zeitsicherung einer vorhandenen Datenbank wiederherstellen. SourceDatabaseName, SourceManagedInstanceName und PointInTime müssen angegeben werden. RestoreExternalBackup: Erstellen Sie eine Datenbank, indem Sie aus externen Sicherungsdateien wiederherstellen. Sortierung, StorageContainerUri und StorageContainerSasToken müssen angegeben werden. Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. RecoverableDatabaseId muss als wiederherstellbare Datenbankressourcen-ID angegeben werden, um wiederherzustellen. RestoreLongTermRetentionBackup: Erstellen Einer Datenbank durch Wiederherstellen einer langfristigen Aufbewahrungssicherung (longTermRetentionBackupResourceId erforderlich). |
|
| properties.crossSubscriptionRestorableDroppedDatabaseId |
string |
Die wiederherstellbare, abonnementübergreifende Datenbankressourcen-ID, die beim Erstellen dieser Datenbank wiederhergestellt werden soll. |
| properties.crossSubscriptionSourceDatabaseId |
string |
Der Ressourcenbezeichner der abonnementübergreifenden Quelldatenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist. |
| properties.crossSubscriptionTargetManagedInstanceId |
string |
Ziel-ID für verwaltete Instanzen, die bei der Wiederherstellung des Abonnements verwendet werden. |
| properties.isLedgerOn |
boolean |
Ob es sich bei dieser Datenbank um eine Ledgerdatenbank handelt, was bedeutet, dass alle Tabellen in der Datenbank Sachtabellen sind. Hinweis: Der Wert dieser Eigenschaft kann nicht geändert werden, nachdem die Datenbank erstellt wurde. |
| properties.lastBackupName |
string |
Letzter Sicherungsdateiname für die Wiederherstellung dieser verwalteten Datenbank. |
| properties.longTermRetentionBackupResourceId |
string |
Der Name der Langfristigen Aufbewahrungssicherung, die für die Wiederherstellung dieser verwalteten Datenbank verwendet werden soll. |
| properties.recoverableDatabaseId |
string |
Der Ressourcenbezeichner der wiederherstellbaren Datenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist. |
| properties.restorableDroppedDatabaseId |
string |
Die wiederherstellbare verworfene Datenbankressourcen-ID, die beim Erstellen dieser Datenbank wiederhergestellt werden soll. |
| properties.restorePointInTime |
string (date-time) |
Konditional. Wenn createMode PointInTimeRestore ist, ist dieser Wert erforderlich. Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die wiederhergestellt wird, um die neue Datenbank zu erstellen. |
| properties.sourceDatabaseId |
string |
Der Ressourcenbezeichner der Quelldatenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist. |
| properties.storageContainerIdentity |
string |
Konditional. Wenn createMode "RestoreExternalBackup" ist, wird dieser Wert verwendet. Gibt die Identität an, die für die Speichercontainerauthentifizierung verwendet wird. Kann "SharedAccessSignature" oder "ManagedIdentity" sein; wenn "SharedAccessSignature" nicht angegeben wird, wird angenommen. |
| properties.storageContainerSasToken |
string |
Konditional. Wenn createMode "RestoreExternalBackup" ist und "storageContainerIdentity" nicht "ManagedIdentity" ist, ist dieser Wert erforderlich. Gibt das Sas-Token des Speichercontainers an. |
| properties.storageContainerUri |
string |
Konditional. Wenn createMode "RestoreExternalBackup" ist, ist dieser Wert erforderlich. Gibt den URI des Speichercontainers an, in dem Sicherungen für diese Wiederherstellung gespeichert werden. |
| tags |
object |
Ressourcentags. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Die Datenbank wurde erfolgreich aktualisiert. |
|
| 202 Accepted |
Das Aktualisieren der verwalteten Datenbank wird ausgeführt. Header Location: string |
|
| Other Status Codes |
Fehlerantworten: ***
|
Beispiele
| Updates a managed database with maximal properties |
| Updates a managed database with minimal properties |
Updates a managed database with maximal properties
Beispielanforderung
Beispiel für eine Antwort
{
"tags": {
"tagKey1": "TagValue1"
},
"location": "southeastasia",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
"name": "testdb"
}
Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/locations/southeastasia/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2017-03-01
Updates a managed database with minimal properties
Beispielanforderung
Beispiel für eine Antwort
{
"tags": {
"tagKey1": "TagValue1"
},
"location": "southeastasia",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
"name": "testdb"
}
Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/locations/southeastasia/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2017-03-01
Definitionen
| Name | Beschreibung |
|---|---|
|
Catalog |
Sortierung des Metadatenkatalogs. |
|
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
|
Error |
Das Fehlerdetails. |
|
Error |
Fehlerantwort |
|
Managed |
Eine verwaltete Datenbankressource. |
|
Managed |
Verwalteter Datenbankerstellungsmodus. PointInTimeRestore: Erstellen Sie eine Datenbank, indem Sie eine Zeitsicherung einer vorhandenen Datenbank wiederherstellen. SourceDatabaseName, SourceManagedInstanceName und PointInTime müssen angegeben werden. RestoreExternalBackup: Erstellen Sie eine Datenbank, indem Sie aus externen Sicherungsdateien wiederherstellen. Sortierung, StorageContainerUri und StorageContainerSasToken müssen angegeben werden. Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. RecoverableDatabaseId muss als wiederherstellbare Datenbankressourcen-ID angegeben werden, um wiederherzustellen. RestoreLongTermRetentionBackup: Erstellen Einer Datenbank durch Wiederherstellen einer langfristigen Aufbewahrungssicherung (longTermRetentionBackupResourceId erforderlich). |
|
Managed |
Status der Datenbank. |
|
Managed |
Eine verwaltete Datenbankaktualisierung. |
CatalogCollationType
Sortierung des Metadatenkatalogs.
| Wert | Beschreibung |
|---|---|
| DATABASE_DEFAULT | |
| SQL_Latin1_General_CP1_CI_AS |
ErrorAdditionalInfo
Der Ressourcenverwaltungsfehler zusätzliche Informationen.
| Name | Typ | Beschreibung |
|---|---|---|
| info |
object |
Die zusätzlichen Informationen. |
| type |
string |
Der zusätzliche Informationstyp. |
ErrorDetail
Das Fehlerdetails.
| Name | Typ | Beschreibung |
|---|---|---|
| additionalInfo |
Die zusätzlichen Informationen des Fehlers. |
|
| code |
string |
Der Fehlercode. |
| details |
Die Fehlerdetails. |
|
| message |
string |
Die Fehlermeldung. |
| target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
| Name | Typ | Beschreibung |
|---|---|---|
| error |
Das Fehlerobjekt. |
ManagedDatabase
Eine verwaltete Datenbankressource.
| Name | Typ | Beschreibung |
|---|---|---|
| id |
string |
Ressourcen-ID. |
| location |
string |
Ressourcenspeicherort. |
| name |
string |
Ressourcenname. |
| properties.autoCompleteRestore |
boolean |
Gibt an, ob die Wiederherstellung dieser verwalteten Datenbank automatisch abgeschlossen werden soll. |
| properties.catalogCollation |
Sortierung des Metadatenkatalogs. |
|
| properties.collation |
string |
Sortierung der verwalteten Datenbank. |
| properties.createMode |
Verwalteter Datenbankerstellungsmodus. PointInTimeRestore: Erstellen Sie eine Datenbank, indem Sie eine Zeitsicherung einer vorhandenen Datenbank wiederherstellen. SourceDatabaseName, SourceManagedInstanceName und PointInTime müssen angegeben werden. RestoreExternalBackup: Erstellen Sie eine Datenbank, indem Sie aus externen Sicherungsdateien wiederherstellen. Sortierung, StorageContainerUri und StorageContainerSasToken müssen angegeben werden. Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. RecoverableDatabaseId muss als wiederherstellbare Datenbankressourcen-ID angegeben werden, um wiederherzustellen. RestoreLongTermRetentionBackup: Erstellen Einer Datenbank durch Wiederherstellen einer langfristigen Aufbewahrungssicherung (longTermRetentionBackupResourceId erforderlich). |
|
| properties.creationDate |
string (date-time) |
Erstellungsdatum der Datenbank. |
| properties.crossSubscriptionRestorableDroppedDatabaseId |
string |
Die wiederherstellbare, abonnementübergreifende Datenbankressourcen-ID, die beim Erstellen dieser Datenbank wiederhergestellt werden soll. |
| properties.crossSubscriptionSourceDatabaseId |
string |
Der Ressourcenbezeichner der abonnementübergreifenden Quelldatenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist. |
| properties.crossSubscriptionTargetManagedInstanceId |
string |
Ziel-ID für verwaltete Instanzen, die bei der Wiederherstellung des Abonnements verwendet werden. |
| properties.defaultSecondaryLocation |
string |
Geo-gekoppelte Region. |
| properties.earliestRestorePoint |
string (date-time) |
Frühester Wiederherstellungspunkt für punkt in der Zeitwiederherstellung. |
| properties.failoverGroupId |
string |
Ressourcenbezeichner der Instanzfailovergruppe, zu der diese verwaltete Datenbank gehört. |
| properties.isLedgerOn |
boolean |
Ob es sich bei dieser Datenbank um eine Ledgerdatenbank handelt, was bedeutet, dass alle Tabellen in der Datenbank Sachtabellen sind. Hinweis: Der Wert dieser Eigenschaft kann nicht geändert werden, nachdem die Datenbank erstellt wurde. |
| properties.lastBackupName |
string |
Letzter Sicherungsdateiname für die Wiederherstellung dieser verwalteten Datenbank. |
| properties.longTermRetentionBackupResourceId |
string |
Der Name der Langfristigen Aufbewahrungssicherung, die für die Wiederherstellung dieser verwalteten Datenbank verwendet werden soll. |
| properties.recoverableDatabaseId |
string |
Der Ressourcenbezeichner der wiederherstellbaren Datenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist. |
| properties.restorableDroppedDatabaseId |
string |
Die wiederherstellbare verworfene Datenbankressourcen-ID, die beim Erstellen dieser Datenbank wiederhergestellt werden soll. |
| properties.restorePointInTime |
string (date-time) |
Konditional. Wenn createMode PointInTimeRestore ist, ist dieser Wert erforderlich. Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die wiederhergestellt wird, um die neue Datenbank zu erstellen. |
| properties.sourceDatabaseId |
string |
Der Ressourcenbezeichner der Quelldatenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist. |
| properties.status |
Status der Datenbank. |
|
| properties.storageContainerIdentity |
string |
Konditional. Wenn createMode "RestoreExternalBackup" ist, wird dieser Wert verwendet. Gibt die Identität an, die für die Speichercontainerauthentifizierung verwendet wird. Kann "SharedAccessSignature" oder "ManagedIdentity" sein; wenn "SharedAccessSignature" nicht angegeben wird, wird angenommen. |
| properties.storageContainerSasToken |
string |
Konditional. Wenn createMode "RestoreExternalBackup" ist und "storageContainerIdentity" nicht "ManagedIdentity" ist, ist dieser Wert erforderlich. Gibt das Sas-Token des Speichercontainers an. |
| properties.storageContainerUri |
string |
Konditional. Wenn createMode "RestoreExternalBackup" ist, ist dieser Wert erforderlich. Gibt den URI des Speichercontainers an, in dem Sicherungen für diese Wiederherstellung gespeichert werden. |
| tags |
object |
Ressourcentags. |
| type |
string |
Ressourcentyp. |
ManagedDatabaseCreateMode
Verwalteter Datenbankerstellungsmodus. PointInTimeRestore: Erstellen Sie eine Datenbank, indem Sie eine Zeitsicherung einer vorhandenen Datenbank wiederherstellen. SourceDatabaseName, SourceManagedInstanceName und PointInTime müssen angegeben werden. RestoreExternalBackup: Erstellen Sie eine Datenbank, indem Sie aus externen Sicherungsdateien wiederherstellen. Sortierung, StorageContainerUri und StorageContainerSasToken müssen angegeben werden. Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. RecoverableDatabaseId muss als wiederherstellbare Datenbankressourcen-ID angegeben werden, um wiederherzustellen. RestoreLongTermRetentionBackup: Erstellen Einer Datenbank durch Wiederherstellen einer langfristigen Aufbewahrungssicherung (longTermRetentionBackupResourceId erforderlich).
| Wert | Beschreibung |
|---|---|
| Default | |
| RestoreExternalBackup | |
| PointInTimeRestore | |
| Recovery | |
| RestoreLongTermRetentionBackup |
ManagedDatabaseStatus
Status der Datenbank.
| Wert | Beschreibung |
|---|---|
| Online | |
| Offline | |
| Shutdown | |
| Creating | |
| Inaccessible | |
| Restoring | |
| Updating | |
| Stopping | |
| Stopped | |
| Starting | |
| DbMoving | |
| DbCopying |
ManagedDatabaseUpdate
Eine verwaltete Datenbankaktualisierung.
| Name | Typ | Beschreibung |
|---|---|---|
| properties.autoCompleteRestore |
boolean |
Gibt an, ob die Wiederherstellung dieser verwalteten Datenbank automatisch abgeschlossen werden soll. |
| properties.catalogCollation |
Sortierung des Metadatenkatalogs. |
|
| properties.collation |
string |
Sortierung der verwalteten Datenbank. |
| properties.createMode |
Verwalteter Datenbankerstellungsmodus. PointInTimeRestore: Erstellen Sie eine Datenbank, indem Sie eine Zeitsicherung einer vorhandenen Datenbank wiederherstellen. SourceDatabaseName, SourceManagedInstanceName und PointInTime müssen angegeben werden. RestoreExternalBackup: Erstellen Sie eine Datenbank, indem Sie aus externen Sicherungsdateien wiederherstellen. Sortierung, StorageContainerUri und StorageContainerSasToken müssen angegeben werden. Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. RecoverableDatabaseId muss als wiederherstellbare Datenbankressourcen-ID angegeben werden, um wiederherzustellen. RestoreLongTermRetentionBackup: Erstellen Einer Datenbank durch Wiederherstellen einer langfristigen Aufbewahrungssicherung (longTermRetentionBackupResourceId erforderlich). |
|
| properties.creationDate |
string (date-time) |
Erstellungsdatum der Datenbank. |
| properties.crossSubscriptionRestorableDroppedDatabaseId |
string |
Die wiederherstellbare, abonnementübergreifende Datenbankressourcen-ID, die beim Erstellen dieser Datenbank wiederhergestellt werden soll. |
| properties.crossSubscriptionSourceDatabaseId |
string |
Der Ressourcenbezeichner der abonnementübergreifenden Quelldatenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist. |
| properties.crossSubscriptionTargetManagedInstanceId |
string |
Ziel-ID für verwaltete Instanzen, die bei der Wiederherstellung des Abonnements verwendet werden. |
| properties.defaultSecondaryLocation |
string |
Geo-gekoppelte Region. |
| properties.earliestRestorePoint |
string (date-time) |
Frühester Wiederherstellungspunkt für punkt in der Zeitwiederherstellung. |
| properties.failoverGroupId |
string |
Ressourcenbezeichner der Instanzfailovergruppe, zu der diese verwaltete Datenbank gehört. |
| properties.isLedgerOn |
boolean |
Ob es sich bei dieser Datenbank um eine Ledgerdatenbank handelt, was bedeutet, dass alle Tabellen in der Datenbank Sachtabellen sind. Hinweis: Der Wert dieser Eigenschaft kann nicht geändert werden, nachdem die Datenbank erstellt wurde. |
| properties.lastBackupName |
string |
Letzter Sicherungsdateiname für die Wiederherstellung dieser verwalteten Datenbank. |
| properties.longTermRetentionBackupResourceId |
string |
Der Name der Langfristigen Aufbewahrungssicherung, die für die Wiederherstellung dieser verwalteten Datenbank verwendet werden soll. |
| properties.recoverableDatabaseId |
string |
Der Ressourcenbezeichner der wiederherstellbaren Datenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist. |
| properties.restorableDroppedDatabaseId |
string |
Die wiederherstellbare verworfene Datenbankressourcen-ID, die beim Erstellen dieser Datenbank wiederhergestellt werden soll. |
| properties.restorePointInTime |
string (date-time) |
Konditional. Wenn createMode PointInTimeRestore ist, ist dieser Wert erforderlich. Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die wiederhergestellt wird, um die neue Datenbank zu erstellen. |
| properties.sourceDatabaseId |
string |
Der Ressourcenbezeichner der Quelldatenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist. |
| properties.status |
Status der Datenbank. |
|
| properties.storageContainerIdentity |
string |
Konditional. Wenn createMode "RestoreExternalBackup" ist, wird dieser Wert verwendet. Gibt die Identität an, die für die Speichercontainerauthentifizierung verwendet wird. Kann "SharedAccessSignature" oder "ManagedIdentity" sein; wenn "SharedAccessSignature" nicht angegeben wird, wird angenommen. |
| properties.storageContainerSasToken |
string |
Konditional. Wenn createMode "RestoreExternalBackup" ist und "storageContainerIdentity" nicht "ManagedIdentity" ist, ist dieser Wert erforderlich. Gibt das Sas-Token des Speichercontainers an. |
| properties.storageContainerUri |
string |
Konditional. Wenn createMode "RestoreExternalBackup" ist, ist dieser Wert erforderlich. Gibt den URI des Speichercontainers an, in dem Sicherungen für diese Wiederherstellung gespeichert werden. |
| tags |
object |
Ressourcentags. |