Web Apps - Backup
Opis tworzenia kopii zapasowej aplikacji.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/backup?api-version=2023-12-01
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
name
|
path | True |
string |
Nazwa aplikacji. |
resource
|
path | True |
string |
Nazwa grupy zasobów, do której należy zasób. Wzorzec wyrażenia regularnego: |
subscription
|
path | True |
string |
Identyfikator subskrypcji platformy Azure. Jest to ciąg w formacie GUID (np. 00000000-0000-0000-0000-0000-0000000000000000000000000000000000000000 00000). |
api-version
|
query | True |
string |
Wersja interfejsu API |
Treść żądania
Nazwa | Wymagane | Typ | Opis |
---|---|---|---|
properties.storageAccountUrl | True |
string |
Adres URL sygnatury dostępu współdzielonego do kontenera. |
kind |
string |
Rodzaj zasobu. |
|
properties.backupName |
string |
Nazwa kopii zapasowej. |
|
properties.backupSchedule |
Zaplanuj tworzenie kopii zapasowej, jeśli jest ona wykonywana okresowo. |
||
properties.databases |
Bazy danych zawarte w kopii zapasowej. |
||
properties.enabled |
boolean |
Prawda, jeśli harmonogram tworzenia kopii zapasowej jest włączony (musi być uwzględniony w tym przypadku), wartość false, jeśli harmonogram tworzenia kopii zapasowej powinien zostać wyłączony. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
App Service odpowiedź na błąd. |
Zabezpieczenia
azure_auth
Przepływ OAuth2 usługi Azure Active Directory
Typ:
oauth2
Flow:
implicit
Adres URL autoryzacji:
https://login.microsoftonline.com/common/oauth2/authorize
Zakresy
Nazwa | Opis |
---|---|
user_impersonation | personifikacja konta użytkownika |
Przykłady
Backup web app
Przykładowe żądanie
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"
}
}
}
Przykładowa odpowiedź
{
"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
}
}
Definicje
Nazwa | Opis |
---|---|
Backup |
Opis kopii zapasowej. |
Backup |
Stan kopii zapasowej. |
Backup |
Opis kopii zapasowej, która zostanie wykonana. |
Backup |
Opis harmonogramu tworzenia kopii zapasowych. Opisuje, jak często powinna być wykonywana kopia zapasowa i jakie powinny być zasady przechowywania. |
Database |
Ustawienia kopii zapasowej bazy danych. |
Database |
Typ bazy danych (np. SqlAzure / MySql). |
Default |
App Service odpowiedź na błąd. |
Details | |
Error |
Model błędu. |
Frequency |
Jednostka czasu dla częstotliwości wykonywania kopii zapasowej (np. w przypadku cotygodniowej kopii zapasowej powinna być ustawiona wartość Day (Dzień) i FrequencyInterval (CzęstotliwośćInterval) |
BackupItem
Opis kopii zapasowej.
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Identyfikator zasobu. |
kind |
string |
Rodzaj zasobu. |
name |
string |
Nazwa zasobu. |
properties.blobName |
string |
Nazwa obiektu blob zawierającego dane dla tej kopii zapasowej. |
properties.correlationId |
string |
Unikatowy identyfikator korelacji. Użyj tej opcji wraz ze znacznikiem czasu podczas komunikowania się z pomoc techniczna platformy Azure. |
properties.created |
string |
Sygnatura czasowa tworzenia kopii zapasowej. |
properties.databases |
Lista baz danych zawartych w kopii zapasowej. |
|
properties.finishedTimeStamp |
string |
Sygnatura czasowa po zakończeniu tworzenia kopii zapasowej. |
properties.id |
integer |
Identyfikator kopii zapasowej. |
properties.lastRestoreTimeStamp |
string |
Sygnatura czasowa ostatniej operacji przywracania, która użyła tej kopii zapasowej. |
properties.log |
string |
Szczegóły dotyczące tej kopii zapasowej. Może zawierać komunikat o błędzie. |
properties.name |
string |
Nazwa tej kopii zapasowej. |
properties.scheduled |
boolean |
Prawda, jeśli ta kopia zapasowa została utworzona z powodu wyzwalania harmonogramu. |
properties.sizeInBytes |
integer |
Rozmiar kopii zapasowej w bajtach. |
properties.status |
Stan kopii zapasowej. |
|
properties.storageAccountUrl |
string |
Adres URL sygnatury dostępu współdzielonego dla kontenera konta magazynu, który zawiera tę kopię zapasową. |
properties.websiteSizeInBytes |
integer |
Rozmiar oryginalnej aplikacji internetowej, której kopia zapasowa została utworzona. |
type |
string |
Typ zasobu. |
BackupItemStatus
Stan kopii zapasowej.
Nazwa | Typ | Opis |
---|---|---|
Created |
string |
|
DeleteFailed |
string |
|
DeleteInProgress |
string |
|
Deleted |
string |
|
Failed |
string |
|
InProgress |
string |
|
PartiallySucceeded |
string |
|
Skipped |
string |
|
Succeeded |
string |
|
TimedOut |
string |
BackupRequest
Opis kopii zapasowej, która zostanie wykonana.
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Identyfikator zasobu. |
kind |
string |
Rodzaj zasobu. |
name |
string |
Nazwa zasobu. |
properties.backupName |
string |
Nazwa kopii zapasowej. |
properties.backupSchedule |
Zaplanuj tworzenie kopii zapasowej, jeśli jest ona wykonywana okresowo. |
|
properties.databases |
Bazy danych zawarte w kopii zapasowej. |
|
properties.enabled |
boolean |
Prawda, jeśli harmonogram tworzenia kopii zapasowej jest włączony (musi być uwzględniony w tym przypadku), wartość false, jeśli harmonogram tworzenia kopii zapasowej powinien zostać wyłączony. |
properties.storageAccountUrl |
string |
Adres URL sygnatury dostępu współdzielonego do kontenera. |
type |
string |
Typ zasobu. |
BackupSchedule
Opis harmonogramu tworzenia kopii zapasowych. Opisuje, jak często powinna być wykonywana kopia zapasowa i jakie powinny być zasady przechowywania.
Nazwa | Typ | Domyślna wartość | Opis |
---|---|---|---|
frequencyInterval |
integer |
7 |
Jak często należy wykonać kopię zapasową (np. w przypadku cotygodniowej kopii zapasowej należy ustawić wartość 7, a parametr FrequencyUnit powinien być ustawiony na Dzień) |
frequencyUnit | Day |
Jednostka czasu dla częstotliwości wykonywania kopii zapasowej (np. w przypadku cotygodniowej kopii zapasowej powinna być ustawiona wartość Day (Dzień) i FrequencyInterval (CzęstotliwośćInterval) |
|
keepAtLeastOneBackup |
boolean |
True |
Prawda, jeśli zasady przechowywania powinny zawsze przechowywać co najmniej jedną kopię zapasową na koncie magazynu, niezależnie od tego, jak stary jest; false w przeciwnym razie. |
lastExecutionTime |
string |
Czas ostatniego wyzwolenia tego harmonogramu. |
|
retentionPeriodInDays |
integer |
30 |
Po tylu dniach należy usunąć kopie zapasowe. |
startTime |
string |
Kiedy harmonogram powinien zacząć działać. |
DatabaseBackupSetting
Ustawienia kopii zapasowej bazy danych.
Nazwa | Typ | Opis |
---|---|---|
connectionString |
string |
Zawiera parametry połączenia bazy danych, która jest tworzona lub przywracana. Jeśli przywracanie powinno nastąpić do nowej bazy danych, nazwa bazy danych wewnątrz to nowa. |
connectionStringName |
string |
Zawiera nazwę parametry połączenia połączoną z elementem SiteConfig.ConnectionStrings. Jest to używane podczas przywracania z opcjami zastąp parametry połączenia. |
databaseType |
Typ bazy danych (np. SqlAzure / MySql). |
|
name |
string |
DatabaseType
Typ bazy danych (np. SqlAzure / MySql).
Nazwa | Typ | Opis |
---|---|---|
LocalMySql |
string |
|
MySql |
string |
|
PostgreSql |
string |
|
SqlAzure |
string |
DefaultErrorResponse
App Service odpowiedź na błąd.
Nazwa | Typ | Opis |
---|---|---|
error |
Model błędu. |
Details
Nazwa | Typ | Opis |
---|---|---|
code |
string |
Ustandaryzowany ciąg w celu programowego identyfikowania błędu. |
message |
string |
Szczegółowy opis błędu i informacje o debugowaniu. |
target |
string |
Szczegółowy opis błędu i informacje o debugowaniu. |
Error
Model błędu.
Nazwa | Typ | Opis |
---|---|---|
code |
string |
Ustandaryzowany ciąg w celu programowego identyfikowania błędu. |
details |
Details[] |
Szczegółowe błędy. |
innererror |
string |
Więcej informacji na temat błędu debugowania. |
message |
string |
Szczegółowy opis błędu i informacje o debugowaniu. |
target |
string |
Szczegółowy opis błędu i informacje o debugowaniu. |
FrequencyUnit
Jednostka czasu dla częstotliwości wykonywania kopii zapasowej (np. w przypadku cotygodniowej kopii zapasowej powinna być ustawiona wartość Day (Dzień) i FrequencyInterval (CzęstotliwośćInterval)
Nazwa | Typ | Opis |
---|---|---|
Day |
string |
|
Hour |
string |