Freigeben über


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=2021-11-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
databaseName
path True

string

Der Name der Datenbank.

managedInstanceName
path True

string

Der Name der verwalteten Instanz.

resourceGroupName
path True

string

Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.

subscriptionId
path True

string

Abonnement-ID für ein Azure-Abonnement.

api-version
query True

string

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

CatalogCollationType

Sortierung des Metadatenkatalogs.

properties.collation

string

Sortierung der verwalteten Datenbank.

properties.createMode

ManagedDatabaseCreateMode

Erstellungsmodus für verwaltete Datenbanken. PointInTimeRestore: Erstellen Sie eine Datenbank, indem Sie eine Zeitpunktsicherung einer vorhandenen Datenbank wiederherstellen. SourceDatabaseName, SourceManagedInstanceName und PointInTime müssen angegeben werden. RestoreExternalBackup: Erstellen Sie eine Datenbank, indem Sie die Wiederherstellung aus externen Sicherungsdateien durchführen. Sortierung, StorageContainerUri und StorageContainerSasToken müssen angegeben werden. Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. RecoverableDatabaseId muss als wiederherzustellende Datenbankressourcen-ID angegeben werden. RestoreLongTermRetentionBackup: Erstellen Sie eine Datenbank, indem Sie eine Wiederherstellung aus einer sicherung mit langfristiger Aufbewahrung durchführen (longTermRetentionBackupResourceId erforderlich).

properties.lastBackupName

string

Name der letzten Sicherungsdatei 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 gelöschte Datenbankressourcen-ID, die beim Erstellen dieser Datenbank wiederhergestellt werden soll.

properties.restorePointInTime

string

Bedingte. Wenn createMode den Wert PointInTimeRestore aufweist, ist dieser Wert erforderlich. Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die zum Erstellen der neuen Datenbank wiederhergestellt wird.

properties.sourceDatabaseId

string

Der Ressourcenbezeichner der Quelldatenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist.

properties.storageContainerSasToken

string

Bedingte. Wenn createMode auf RestoreExternalBackup festgelegt ist, ist dieser Wert erforderlich. Gibt das SAS-Token des Speichercontainers an.

properties.storageContainerUri

string

Bedingte. Wenn createMode auf RestoreExternalBackup festgelegt 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

ManagedDatabase

Die Datenbank wurde erfolgreich aktualisiert.

202 Accepted

Das Aktualisieren der verwalteten Datenbank wird ausgeführt.

Other Status Codes

Fehlerantworten: ***

  • 400 PitrPointInTimeInvalid: Der Zeitpunkt {0} ist ungültig. Gültiger Zeitpunkt reicht von {1} Tagen früher bis heute und nicht vor der Erstellungszeit des Quellservers.

  • 400 CannotUseTrailingWhitespacesInDatabaseName: Fehler bei der Überprüfung des Datenbanknamens.

  • 400 StorageAccountFull: verwaltete Instanz die Gesamtkapazität des zugrunde liegenden Azure-Speicherkontos erreicht hat. Azure Storage Premium-Konto ist auf 35 TB zugewiesenen Speicherplatz begrenzt.

  • 400 AkvHostNotResolvingFromNode : DER AKV-Host "{0}" kann nicht von SQL auf dem Server ""{1} aufgelöst werden.

  • 400 InvalidBackupRetentionPeriod: Die Aufbewahrungstage von {0} ist keine gültige Konfiguration. Gültige Sicherungsaufbewahrung in Tagen muss zwischen {1} und {2}

  • 400 ManagedDatabaseNameInUse : Datenbank "{0}" ist bereits vorhanden. Wählen Sie einen anderen Datenbanknamen aus.

  • 400 NoMoreSpaceInManagedInstance: Die verwaltete instance hat ihr Speicherlimit erreicht. Die Speicherauslastung für die verwalteten instance darf (%d) MBs nicht überschreiten.

  • 400 ManagedInstanceUpdateSloInProgress: "Der Vorgang konnte nicht abgeschlossen werden, weil eine Dienstebenenänderung für verwaltete instance "{0}" ausgeführt wird. Warten Sie, bis der Vorgang abgeschlossen ist, und versuchen Sie es noch mal.“

  • 400 SameKeyMaterialNotFoundOnRemoteServer: Der sekundäre Server verfügt nicht über das Schlüsselmaterial der Verschlüsselungsschutzvorrichtung des primären Servers.

  • 400 SourceDatabaseNotFound: Die Quelldatenbank ist nicht vorhanden.

  • 400 RegionDoesNotSupportVersion: Ein Benutzer hat versucht, einen Server einer angegebenen Version an einem Speicherort zu erstellen, an dem diese Serverversion nicht unterstützt wird.

  • 400 PasswordNotComplex: Das angegebene Kennwort ist nicht komplex genug.

  • 400 CannotUseReservedDatabaseName: Der name der reservierten Datenbank kann in diesem Vorgang nicht verwendet werden.

  • 400 InvalidServerName: Ungültiger Servername angegeben.

  • 400 SourceServerNotFound: Der Serverteil einer Quelldatenbank-ID, der in einem CreateDatabaseAsCopy-API-Aufruf bereitgestellt wird, wird keinem vorhandenen Server zugeordnet.

  • 400 TokenTooLong: Das bereitgestellte Token ist zu lang.

  • 400 CurrentDatabaseSizeExceedsMaxSize: Der Benutzer hat versucht, die maximale Größe für eine Datenbank auf eine Größe zu reduzieren, die kleiner als die aktuelle Nutzung ist.

  • 400 InvalidCollation: Sortierung wird vom Server nicht erkannt.

  • 400 AkvEndpointNotReachableFromNode : DER AKV-Endpunkt "{0}" ist von SQL auf dem Server "{1}" nicht erreichbar.

  • 400 ServerNotFound: Der angeforderte Server wurde nicht gefunden.

  • 400 UnsupportedServiceName: Der angegebene Name ist ein ungültiger Name, da er mindestens ein nicht unterstütztes Unicode-Zeichen enthält.

  • 400 CurrentDatabaseLogSizeExceedsMaxSize: Der Benutzer hat versucht, die Datenbank in eine Sku mit einer niedrigeren maximalen Protokollgröße als die aktuelle Nutzung zu ändern.

  • 400 DatabaseNumberLimitReached: Maximale Anzahl von Datenbanken für SQL-Datenbank verwaltete Instanz erreicht.

  • 400 InvalidDatabaseCreateOrUpdateRequest: Der Anforderungstext für den Vorgang zum Erstellen oder Aktualisieren der Datenbank ist ungültig.

  • 400 InvalidResourceId: Ungültiger Ressourcenbezeichner.

  • 400 InvalidSourceDatabaseId : Ungültiger Quelldatenbankbezeichner.

  • 400 InvalidRestorableDroppedDatabaseId – Ungültiger wiederherstellbarer gelöschter Datenbankbezeichner

  • 400 MismatchingResourceGroupNameWithUrl: Der angegebene Ressourcengruppenname stimmte nicht mit dem Namen in der URL überein.

  • 400 MismatchingServerNameWithUrl: Der angegebene Servername stimmte nicht mit dem Namen in der URL überein.

  • 400 MismatchingSubscriptionWithUrl: Das bereitgestellte Abonnement stimmte nicht mit dem Abonnement in der URL überein.

  • 400 MissingCollation: Sortierung ist erforderlich.

  • 400 MissingSourceDatabaseId: Fehlender Quelldatenbankbezeichner.

  • 400 MissingRestorePointInTime : Fehlender Wiederherstellungszeitpunkt

  • 400 MissingStorageContainerSasToken : Fehlendes SPEICHERCONTAINER-SAS-Token

  • 400 MissingStorageContainerUri – Fehlender Speichercontainer-URI

  • 400 RestorableDroppedDatabaseIdGivenForRestoreWithSourceDatabaseId : RestoreableDroppedDatabaseId kann nicht angegeben werden, wenn sourceDatabaseId bereits im Wiederherstellungsmodus angegeben ist

  • 400 CannotUseReservedDatabaseName: Der name der reservierten Datenbank kann in diesem Vorgang nicht verwendet werden.

  • 404 SubscriptionDoesNotHaveServer: Der angeforderte Server wurde nicht gefunden

  • 404 ServerNotInSubscriptionResourceGroup: Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden.

  • 404 ResourceNotFound: Die angeforderte Ressource wurde nicht gefunden.

  • 404 CannotFindServerCertificateWithThumbprint: Serverzertifikat mit Fingerabdruck "{0}" kann nicht gefunden werden. Verwenden Sie das PowerShell-Cmdlet Add-AzureRmSqlManagedInstanceTransparentDataEncryptionCertificate, um das Zertifikat zu erstellen.

  • 404 CannotFindObject: Das Objekt kann nicht gefunden werden, weil es nicht vorhanden ist oder Sie über keine Berechtigungen verfügen

  • 404 SubscriptionNotFound: Das angeforderte Abonnement wurde nicht gefunden.

  • 404 DatabaseDoesNotExist: Der Benutzer hat einen Datenbanknamen angegeben, der auf diesem Server instance nicht vorhanden ist.

  • 404 ServerNotInSubscription: Der angegebene Server ist im angegebenen Abonnement nicht vorhanden.

  • 404 RestoreSourceDatabaseNotFound: Datenbank "{0}" konnte zum Zeitpunkt "{1}" nicht gefunden werden, die wiederhergestellt werden kann.

  • 404 ServerNotInSubscriptionResourceGroup: Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden.

  • 409 RemoteDatabaseExists: Der Zieldatenbankname ist auf dem Zielserver bereits vorhanden.

  • 409 ConflictingDatabaseOperation: Es gibt bereits einen Vorgang für die Datenbank, und der aktuelle Vorgang sollte warten, bis er abgeschlossen ist.

  • 409 SubscriptionDisabled: Das Abonnement ist deaktiviert.

  • 409 ManagementServiceDatabaseBusy : Datenbank "{0}" ist mit einem anderen Vorgang beschäftigt. Versuchen Sie ihren Vorgang später.

  • 409 ConflictingSystemOperationInProgress: Ein Systemwartungsvorgang für die Datenbank wird ausgeführt, und weitere Vorgänge müssen warten, bis er abgeschlossen ist.

  • 429 SubscriptionTooManyCreateUpdateRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können.

  • 429 SubscriptionTooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können.

  • 500 ActivateOrDeactivateWorkflowThrottling: Fehler beim Aktivierungs- oder Deaktivierungsworkflow, weil zu viele gleichzeitige Workflows vorhanden sind

  • 503 DatabaseUnavailable: Fehler beim Vorgang, weil die Datenbank nicht verfügbar ist.

  • 503 TooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können.

  • 504 RequestTimeout: Die Dienstanforderung hat das zulässige Timeout überschritten.

Beispiele

Updates a managed database with maximal properties
Updates a managed database with minimal properties

Updates a managed database with maximal properties

Beispielanforderung

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/testdb?api-version=2021-11-01

{
  "tags": {
    "tagKey1": "TagValue1"
  }
}

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"
}

Updates a managed database with minimal properties

Beispielanforderung

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/testdb?api-version=2021-11-01

{
  "tags": {
    "tagKey1": "TagValue1"
  }
}

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"
}

Definitionen

Name Beschreibung
CatalogCollationType

Sortierung des Metadatenkatalogs.

ManagedDatabase

Eine verwaltete Datenbankressource.

ManagedDatabaseCreateMode

Erstellungsmodus für verwaltete Datenbanken. PointInTimeRestore: Erstellen Sie eine Datenbank, indem Sie eine Zeitpunktsicherung einer vorhandenen Datenbank wiederherstellen. SourceDatabaseName, SourceManagedInstanceName und PointInTime müssen angegeben werden. RestoreExternalBackup: Erstellen Sie eine Datenbank, indem Sie die Wiederherstellung aus externen Sicherungsdateien durchführen. Sortierung, StorageContainerUri und StorageContainerSasToken müssen angegeben werden. Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. RecoverableDatabaseId muss als wiederherzustellende Datenbankressourcen-ID angegeben werden. RestoreLongTermRetentionBackup: Erstellen Sie eine Datenbank, indem Sie eine Wiederherstellung aus einer sicherung mit langfristiger Aufbewahrung durchführen (longTermRetentionBackupResourceId erforderlich).

ManagedDatabaseStatus

Der Status der Datenbank.

ManagedDatabaseUpdate

Eine verwaltete Datenbankaktualisierung.

CatalogCollationType

Sortierung des Metadatenkatalogs.

Name Typ Beschreibung
DATABASE_DEFAULT

string

SQL_Latin1_General_CP1_CI_AS

string

ManagedDatabase

Eine verwaltete Datenbankressource.

Name Typ Beschreibung
id

string

Ressourcen-ID

location

string

Ressourcenspeicherort

name

string

Name der Ressource.

properties.autoCompleteRestore

boolean

Gibt an, ob die Wiederherstellung dieser verwalteten Datenbank automatisch abgeschlossen werden soll.

properties.catalogCollation

CatalogCollationType

Sortierung des Metadatenkatalogs.

properties.collation

string

Sortierung der verwalteten Datenbank.

properties.createMode

ManagedDatabaseCreateMode

Erstellungsmodus für verwaltete Datenbanken. PointInTimeRestore: Erstellen Sie eine Datenbank, indem Sie eine Zeitpunktsicherung einer vorhandenen Datenbank wiederherstellen. SourceDatabaseName, SourceManagedInstanceName und PointInTime müssen angegeben werden. RestoreExternalBackup: Erstellen Sie eine Datenbank, indem Sie die Wiederherstellung aus externen Sicherungsdateien durchführen. Sortierung, StorageContainerUri und StorageContainerSasToken müssen angegeben werden. Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. RecoverableDatabaseId muss als wiederherzustellende Datenbankressourcen-ID angegeben werden. RestoreLongTermRetentionBackup: Erstellen Sie eine Datenbank, indem Sie eine Wiederherstellung aus einer sicherung mit langfristiger Aufbewahrung durchführen (longTermRetentionBackupResourceId erforderlich).

properties.creationDate

string

Erstellungsdatum der Datenbank.

properties.defaultSecondaryLocation

string

Geografische Region.

properties.earliestRestorePoint

string

Frühester Wiederherstellungspunkt für die Zeitpunktwiederherstellung.

properties.failoverGroupId

string

Ressourcenbezeichner der Instanzfailovergruppe, zu der diese verwaltete Datenbank gehört.

properties.lastBackupName

string

Name der letzten Sicherungsdatei für die Wiederherstellung dieser verwalteten Datenbank.

properties.longTermRetentionBackupResourceId

string

Der Name der Sicherung für die langfristige Aufbewahrung, 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 gelöschte Datenbankressourcen-ID, die beim Erstellen dieser Datenbank wiederhergestellt werden soll.

properties.restorePointInTime

string

Bedingte. Wenn createMode den Wert PointInTimeRestore aufweist, ist dieser Wert erforderlich. Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die zum Erstellen der neuen Datenbank wiederhergestellt wird.

properties.sourceDatabaseId

string

Der Ressourcenbezeichner der Quelldatenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist.

properties.status

ManagedDatabaseStatus

Der Status der Datenbank.

properties.storageContainerSasToken

string

Bedingte. Wenn createMode auf RestoreExternalBackup festgelegt ist, ist dieser Wert erforderlich. Gibt das SAS-Token des Speichercontainers an.

properties.storageContainerUri

string

Bedingte. Wenn createMode auf RestoreExternalBackup festgelegt 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

Der Ressourcentyp.

ManagedDatabaseCreateMode

Erstellungsmodus für verwaltete Datenbanken. PointInTimeRestore: Erstellen Sie eine Datenbank, indem Sie eine Zeitpunktsicherung einer vorhandenen Datenbank wiederherstellen. SourceDatabaseName, SourceManagedInstanceName und PointInTime müssen angegeben werden. RestoreExternalBackup: Erstellen Sie eine Datenbank, indem Sie die Wiederherstellung aus externen Sicherungsdateien durchführen. Sortierung, StorageContainerUri und StorageContainerSasToken müssen angegeben werden. Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. RecoverableDatabaseId muss als wiederherzustellende Datenbankressourcen-ID angegeben werden. RestoreLongTermRetentionBackup: Erstellen Sie eine Datenbank, indem Sie eine Wiederherstellung aus einer sicherung mit langfristiger Aufbewahrung durchführen (longTermRetentionBackupResourceId erforderlich).

Name Typ Beschreibung
Default

string

PointInTimeRestore

string

Recovery

string

RestoreExternalBackup

string

RestoreLongTermRetentionBackup

string

ManagedDatabaseStatus

Der Status der Datenbank.

Name Typ Beschreibung
Creating

string

Inaccessible

string

Offline

string

Online

string

Restoring

string

Shutdown

string

Updating

string

ManagedDatabaseUpdate

Eine verwaltete Datenbankaktualisierung.

Name Typ Beschreibung
properties.autoCompleteRestore

boolean

Gibt an, ob die Wiederherstellung dieser verwalteten Datenbank automatisch abgeschlossen werden soll.

properties.catalogCollation

CatalogCollationType

Sortierung des Metadatenkatalogs.

properties.collation

string

Sortierung der verwalteten Datenbank.

properties.createMode

ManagedDatabaseCreateMode

Erstellungsmodus für verwaltete Datenbanken. PointInTimeRestore: Erstellen Sie eine Datenbank, indem Sie eine Zeitpunktsicherung einer vorhandenen Datenbank wiederherstellen. SourceDatabaseName, SourceManagedInstanceName und PointInTime müssen angegeben werden. RestoreExternalBackup: Erstellen Sie eine Datenbank, indem Sie die Wiederherstellung aus externen Sicherungsdateien durchführen. Sortierung, StorageContainerUri und StorageContainerSasToken müssen angegeben werden. Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. RecoverableDatabaseId muss als wiederherzustellende Datenbankressourcen-ID angegeben werden. RestoreLongTermRetentionBackup: Erstellen Sie eine Datenbank, indem Sie eine Wiederherstellung aus einer sicherung mit langfristiger Aufbewahrung durchführen (longTermRetentionBackupResourceId erforderlich).

properties.creationDate

string

Erstellungsdatum der Datenbank.

properties.defaultSecondaryLocation

string

Geografische Region.

properties.earliestRestorePoint

string

Frühester Wiederherstellungspunkt für die Zeitpunktwiederherstellung.

properties.failoverGroupId

string

Ressourcenbezeichner der Instanzfailovergruppe, zu der diese verwaltete Datenbank gehört.

properties.lastBackupName

string

Name der letzten Sicherungsdatei für die Wiederherstellung dieser verwalteten Datenbank.

properties.longTermRetentionBackupResourceId

string

Der Name der Sicherung für die langfristige Aufbewahrung, 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 gelöschte Datenbankressourcen-ID, die beim Erstellen dieser Datenbank wiederhergestellt werden soll.

properties.restorePointInTime

string

Bedingte. Wenn createMode den Wert PointInTimeRestore aufweist, ist dieser Wert erforderlich. Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die zum Erstellen der neuen Datenbank wiederhergestellt wird.

properties.sourceDatabaseId

string

Der Ressourcenbezeichner der Quelldatenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist.

properties.status

ManagedDatabaseStatus

Der Status der Datenbank.

properties.storageContainerSasToken

string

Bedingte. Wenn createMode auf RestoreExternalBackup festgelegt ist, ist dieser Wert erforderlich. Gibt das SAS-Token des Speichercontainers an.

properties.storageContainerUri

string

Bedingte. Wenn createMode auf RestoreExternalBackup festgelegt ist, ist dieser Wert erforderlich. Gibt den URI des Speichercontainers an, in dem Sicherungen für diese Wiederherstellung gespeichert werden.

tags

object

Ressourcentags.