Web Apps - Backup
Beschreibung für Erstellt eine Sicherung einer App.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/backup?api-version=2023-12-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
name
|
path | True |
string |
Name der App |
resource
|
path | True |
string |
Name der Ressourcengruppe, zu der die Ressource gehört. RegEx-Muster: |
subscription
|
path | True |
string |
die Azure-Abonnement-ID Dies ist eine GUID-formatierte Zeichenfolge (z. B. 0000000-0000-0000-0000-00000000000000000). |
api-version
|
query | True |
string |
API-Version |
Anforderungstext
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
properties.storageAccountUrl | True |
string |
SAS-URL für den Container. |
kind |
string |
Art der Ressource. |
|
properties.backupName |
string |
Name der Sicherung. |
|
properties.backupSchedule |
Planen Sie die Sicherung, wenn sie in regelmäßigen Abständen ausgeführt wird. |
||
properties.databases |
Datenbanken, die in der Sicherung enthalten sind. |
||
properties.enabled |
boolean |
True, wenn der Sicherungszeitplan aktiviert ist (muss in diesem Fall eingeschlossen werden), false, wenn der Sicherungszeitplan deaktiviert werden soll. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
App Service Fehlerantwort. |
Sicherheit
azure_auth
Azure Active Directory-OAuth2-Flow
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel Ihres Benutzerkontos |
Beispiele
Backup web app
Beispielanforderung
POST https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141/backup?api-version=2023-12-01
{
"properties": {
"storageAccountUrl": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<account-key>",
"backupName": "abcdwe",
"enabled": true,
"databases": [
{
"databaseType": "SqlAzure",
"name": "backenddb",
"connectionStringName": "backend",
"connectionString": "DSN=data-source-name[;SERVER=value] [;PWD=value] [;UID=value] [;<Attribute>=<value>]"
},
{
"databaseType": "SqlAzure",
"name": "statsdb",
"connectionStringName": "stats",
"connectionString": "DSN=data-source-name[;SERVER=value] [;PWD=value] [;UID=value] [;<Attribute>=<value>]"
}
],
"backupSchedule": {
"frequencyInterval": 7,
"frequencyUnit": "Day",
"keepAtLeastOneBackup": true,
"retentionPeriodInDays": 30,
"startTime": "2022-09-02T17:33:11.641Z"
}
}
}
Beispiel für eine Antwort
{
"id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141",
"name": "sitef6141",
"type": "Microsoft.Web/sites",
"properties": {
"id": 12345,
"storageAccountUrl": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<account-key>",
"blobName": "sitef6141_2023-12-01",
"name": "sitef6141_2023-12-01",
"status": "InProgress",
"sizeInBytes": 56091883,
"created": "2022-09-03T17:33:11.641Z",
"log": "Succeeded",
"databases": [
{
"databaseType": "SqlAzure",
"name": "backenddb",
"connectionStringName": "backend",
"connectionString": "DSN=data-source-name[;SERVER=value] [;PWD=value] [;UID=value] [;<Attribute>=<value>]"
},
{
"databaseType": "SqlAzure",
"name": "statsdb",
"connectionStringName": "stats",
"connectionString": "DSN=data-source-name[;SERVER=value] [;PWD=value] [;UID=value] [;<Attribute>=<value>]"
}
],
"scheduled": true,
"lastRestoreTimeStamp": "2022-09-04T17:33:11.641Z",
"finishedTimeStamp": "2022-09-02T17:33:11.641Z",
"websiteSizeInBytes": 56091883
}
}
Definitionen
Name | Beschreibung |
---|---|
Backup |
Beschreibung der Sicherung. |
Backup |
Sicherungsstatus |
Backup |
Beschreibung einer Sicherung, die ausgeführt wird. |
Backup |
Beschreibung eines Sicherungszeitplans. Beschreibt, wie oft die Sicherung ausgeführt werden sollte und was die Aufbewahrungsrichtlinie sein sollte. |
Database |
Datenbanksicherungseinstellungen. |
Database |
Datenbanktyp (z. B. SqlAzure/MySql). |
Default |
App Service Fehlerantwort. |
Details | |
Error |
Fehlermodell. |
Frequency |
Die Zeiteinheit, wie oft die Sicherung ausgeführt werden soll (z. B. für die wöchentliche Sicherung sollte diese auf Day und FrequencyInterval auf 7 festgelegt werden) |
BackupItem
Beschreibung der Sicherung.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcen-ID. |
kind |
string |
Art der Ressource. |
name |
string |
Ressourcenname. |
properties.blobName |
string |
Name des Blobs, das Daten für diese Sicherung enthält. |
properties.correlationId |
string |
Eindeutiger Korrelationsbezeichner. Verwenden Sie dies zusammen mit dem Zeitstempel, während Sie mit Azure-Support kommunizieren. |
properties.created |
string |
Zeitstempel der Sicherungserstellung. |
properties.databases |
Liste der Datenbanken, die in der Sicherung enthalten sind. |
|
properties.finishedTimeStamp |
string |
Zeitstempel, zu dem diese Sicherung abgeschlossen ist. |
properties.id |
integer |
ID der Sicherung. |
properties.lastRestoreTimeStamp |
string |
Zeitstempel eines letzten Wiederherstellungsvorgangs, der diese Sicherung verwendet hat. |
properties.log |
string |
Details zu dieser Sicherung. Kann eine Fehlermeldung enthalten. |
properties.name |
string |
Der Name dieser Sicherung. |
properties.scheduled |
boolean |
True, wenn diese Sicherung aufgrund eines ausgelösten Zeitplans erstellt wurde. |
properties.sizeInBytes |
integer |
Größe der Sicherung in Bytes. |
properties.status |
Sicherungsstatus |
|
properties.storageAccountUrl |
string |
SAS-URL für den Speicherkontocontainer, der diese Sicherung enthält. |
properties.websiteSizeInBytes |
integer |
Größe der ursprünglichen Web-App, die gesichert wurde. |
type |
string |
Der Ressourcentyp. |
BackupItemStatus
Sicherungsstatus
Name | Typ | Beschreibung |
---|---|---|
Created |
string |
|
DeleteFailed |
string |
|
DeleteInProgress |
string |
|
Deleted |
string |
|
Failed |
string |
|
InProgress |
string |
|
PartiallySucceeded |
string |
|
Skipped |
string |
|
Succeeded |
string |
|
TimedOut |
string |
BackupRequest
Beschreibung einer Sicherung, die ausgeführt wird.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcen-ID. |
kind |
string |
Art der Ressource. |
name |
string |
Ressourcenname. |
properties.backupName |
string |
Name der Sicherung. |
properties.backupSchedule |
Planen Sie die Sicherung, wenn sie in regelmäßigen Abständen ausgeführt wird. |
|
properties.databases |
Datenbanken, die in der Sicherung enthalten sind. |
|
properties.enabled |
boolean |
True, wenn der Sicherungszeitplan aktiviert ist (muss in diesem Fall eingeschlossen werden), false, wenn der Sicherungszeitplan deaktiviert werden soll. |
properties.storageAccountUrl |
string |
SAS-URL für den Container. |
type |
string |
Der Ressourcentyp. |
BackupSchedule
Beschreibung eines Sicherungszeitplans. Beschreibt, wie oft die Sicherung ausgeführt werden sollte und was die Aufbewahrungsrichtlinie sein sollte.
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
frequencyInterval |
integer |
7 |
Wie oft die Sicherung ausgeführt werden soll (z. B. für wöchentliche Sicherungen sollte diese auf 7 und FrequencyUnit auf Day festgelegt werden) |
frequencyUnit | Day |
Die Zeiteinheit, wie oft die Sicherung ausgeführt werden soll (z. B. für die wöchentliche Sicherung sollte diese auf Day und FrequencyInterval auf 7 festgelegt werden) |
|
keepAtLeastOneBackup |
boolean |
True |
True, wenn die Aufbewahrungsrichtlinie immer mindestens eine Sicherung im Speicherkonto beibehalten soll, unabhängig davon, wie alt es ist; Andernfalls false. |
lastExecutionTime |
string |
Das letzte Mal, zu dem dieser Zeitplan ausgelöst wurde. |
|
retentionPeriodInDays |
integer |
30 |
Nach wie vielen Tagen sollten Sicherungen gelöscht werden. |
startTime |
string |
Wann der Zeitplan funktioniert. |
DatabaseBackupSetting
Datenbanksicherungseinstellungen.
Name | Typ | Beschreibung |
---|---|---|
connectionString |
string |
Enthält eine Verbindungszeichenfolge zu einer Datenbank, die gesichert oder wiederhergestellt wird. Wenn die Wiederherstellung für eine neue Datenbank erfolgen soll, ist der datenbankinterne Name der neue. |
connectionStringName |
string |
Enthält einen Verbindungszeichenfolge Namen, der mit SiteConfig.ConnectionStrings verknüpft ist. Dies wird während der Wiederherstellung mit Optionen zum Überschreiben von Verbindungszeichenfolgen verwendet. |
databaseType |
Datenbanktyp (z. B. SqlAzure/MySql). |
|
name |
string |
DatabaseType
Datenbanktyp (z. B. SqlAzure/MySql).
Name | Typ | Beschreibung |
---|---|---|
LocalMySql |
string |
|
MySql |
string |
|
PostgreSql |
string |
|
SqlAzure |
string |
DefaultErrorResponse
App Service Fehlerantwort.
Name | Typ | Beschreibung |
---|---|---|
error |
Fehlermodell. |
Details
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Standardisierte Zeichenfolge zum programmgesteuerten Identifizieren des Fehlers. |
message |
string |
Ausführliche Fehlerbeschreibung und Debuginformationen. |
target |
string |
Ausführliche Fehlerbeschreibung und Debuginformationen. |
Error
Fehlermodell.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Standardisierte Zeichenfolge zum programmgesteuerten Identifizieren des Fehlers. |
details |
Details[] |
Detaillierte Fehler. |
innererror |
string |
Weitere Informationen zum Debuggen des Fehlers. |
message |
string |
Ausführliche Fehlerbeschreibung und Debuginformationen. |
target |
string |
Ausführliche Fehlerbeschreibung und Debuginformationen. |
FrequencyUnit
Die Zeiteinheit, wie oft die Sicherung ausgeführt werden soll (z. B. für die wöchentliche Sicherung sollte diese auf Day und FrequencyInterval auf 7 festgelegt werden)
Name | Typ | Beschreibung |
---|---|---|
Day |
string |
|
Hour |
string |