Restore Points - Create

Dienst:

SQL Database

API-Version:

2023-08-01

Erstellt einen Wiederherstellungspunkt für ein Data Warehouse.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/restorePoints?api-version=2023-08-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
databaseName	path	True	string	Der Name der Datenbank.
resourceGroupName	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.
serverName	path	True	string	Der Name des Servers.
subscriptionId	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	Erforderlich	Typ	Beschreibung
restorePointLabel	True	string	Angewendete Wiederherstellungspunktbezeichnung

Antworten

Name	Typ	Beschreibung
200 OK	RestorePoint	Die Wiederherstellungspunktanforderung wurde erfolgreich erstellt.
201 Created	RestorePoint	Die Wiederherstellungspunktanforderung wurde erfolgreich erstellt.
202 Accepted		Angenommen Header Location: string
Other Status Codes	ErrorResponse	Fehlerantworten: *** 400 FeatureDisabledOnSelectedEdition – Der Benutzer hat versucht, ein Feature zu verwenden, das in der aktuellen Datenbankedition deaktiviert ist. 400 BackupNotAllowedOnDeactivatedDatabase – Der Wiederherstellungspunkt einer deaktivierten Datenbank kann nicht erstellt werden. 400 RestorePointLimitReached – Ein Wiederherstellungspunkt kann nicht erstellt werden, da die Datenbank das zulässige Kontingent der Wiederherstellungspunkte überschreitet. 400 RestorePointAttemptToDeleteSystemBackup – Systemwiederherstellungspunkt kann nicht gelöscht werden. 404 DatabaseRestorePointNotFound - Datenbankwiederherstellungspunkt kann nicht gefunden werden. 404 SubscriptionDoesNotHaveServer – Der angeforderte Server wurde nicht gefunden. 404 DatabaseDoesNotExist – Der Benutzer hat einen Datenbanknamen angegeben, der in dieser Serverinstanz nicht vorhanden ist. 404 OperationIdNotFound – Der Vorgang mit der ID ist nicht vorhanden. 408 DatabaseRestorePointTimedOut – Fehler beim Erstellen des Datenbankwiederherstellungspunkts. 409 CannotCancelOperation – Der Verwaltungsvorgang befindet sich in einem Zustand, der nicht abgebrochen werden kann. 409 OperationCancelled – Der Vorgang wurde vom Benutzer abgebrochen. 409 OperationInterrupted – Der Vorgang für die Ressource konnte nicht abgeschlossen werden, weil er durch einen anderen Vorgang in derselben Ressource unterbrochen wurde. 429 SubscriptionTooManyCreateUpdateRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können. 500 OperationTimedOut – Timeout des Vorgangs und automatisches Zurücksetzen. Versuchen Sie den Vorgang erneut. 503 TooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.

Beispiele

Creates datawarehouse database restore point.

Beispielanforderung

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testserver/databases/testDatabase/restorePoints?api-version=2023-08-01

{
  "restorePointLabel": "mylabel"
}

Beispiel für eine Antwort

Statuscode:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/servers/testserver/databases/testDatabase/restorePoints/131546477590000000",
  "name": "131546477590000000",
  "type": "Microsoft.Sql/servers/databases/restorePoints",
  "location": "japaneast",
  "properties": {
    "restorePointType": "DISCRETE",
    "restorePointCreationDate": "2017-03-10T08:00:00Z",
    "restorePointLabel": "mylabel"
  }
}

Statuscode:

201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/servers/testserver/databases/testDatabase/restorePoints/131546477590000000",
  "name": "131546477590000000",
  "type": "Microsoft.Sql/servers/databases/restorePoints",
  "location": "southeastasia",
  "properties": {
    "restorePointType": "DISCRETE",
    "restorePointCreationDate": "2017-03-10T08:00:00Z",
    "restorePointLabel": "mylabel"
  }
}

Statuscode:

202

Location: https://management.azure.com/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/manageddatabaserestoreazureasyncoperation/00000000-1111-2222-3333-444444444444?api-version=2022-11-01-preview

Definitionen

Name	Beschreibung
CreateDatabaseRestorePointDefinition	Enthält die informationen, die zum Ausführen eines Vorgangs zum Erstellen eines Datenbankwiederherstellungspunkts erforderlich sind.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
RestorePoint	Datenbankwiederherstellungspunkte.
RestorePointType	Der Typ des Wiederherstellungspunkts

CreateDatabaseRestorePointDefinition

Objekt

Enthält die informationen, die zum Ausführen eines Vorgangs zum Erstellen eines Datenbankwiederherstellungspunkts erforderlich sind.

Name	Typ	Beschreibung
restorePointLabel	string	Angewendete Wiederherstellungspunktbezeichnung

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

RestorePoint

Objekt

Datenbankwiederherstellungspunkte.

Name	Typ	Beschreibung
id	string	Ressourcen-ID.
location	string	Ressourcenspeicherort.
name	string	Ressourcenname.
properties.earliestRestoreDate	string (date-time)	Die früheste Zeit, zu der diese Datenbank wiederhergestellt werden kann
properties.restorePointCreationDate	string (date-time)	Die Zeit, zu der die Sicherung durchgeführt wurde
properties.restorePointLabel	string	Die Bezeichnung des Wiederherstellungspunkts für die Sicherungsanforderung durch den Benutzer
properties.restorePointType	RestorePointType	Der Typ des Wiederherstellungspunkts
type	string	Ressourcentyp.

RestorePointType

Enumeration

Der Typ des Wiederherstellungspunkts

Wert	Beschreibung
CONTINUOUS
DISCRETE