Web Apps - Backup

Servizio:: App Service

Versione API:: 2026-07-15

Descrizione per Crea un backup di un'app.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/backup?api-version=2026-07-15

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
name	path	True	string	Nome dell'app.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
properties.storageAccountUrl	True	string	URL di firma di accesso condiviso al contenitore.
kind		string	Tipo di risorsa.
properties.backupName		string	Nome del backup.
properties.backupSchedule		BackupSchedule	Pianificare il backup se viene eseguito periodicamente.
properties.databases		DatabaseBackupSetting[]	Database inclusi nel backup.
properties.enabled		boolean	True se la pianificazione del backup è abilitata (deve essere inclusa in questo caso), false se la pianificazione del backup deve essere disabilitata.

Risposte

Nome	Tipo	Descrizione
200 OK	BackupItem	L'operazione di Azure è stata completata correttamente.
Other Status Codes	DefaultErrorResponse	Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	impersonare il tuo account utente

Esempio

Backup web app

Esempio di richiesta

HTTP

POST https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141/backup?api-version=2026-07-15

{
  "properties": {
    "backupName": "abcdwe",
    "backupSchedule": {
      "frequencyInterval": 7,
      "frequencyUnit": "Day",
      "keepAtLeastOneBackup": true,
      "retentionPeriodInDays": 30,
      "startTime": "2022-09-02T17:33:11.641Z"
    },
    "databases": [
      {
        "name": "backenddb",
        "connectionString": "DSN=data-source-name[;SERVER=value] [;PWD=value] [;UID=value] [;<Attribute>=<value>]",
        "connectionStringName": "backend",
        "databaseType": "SqlAzure"
      },
      {
        "name": "statsdb",
        "connectionString": "DSN=data-source-name[;SERVER=value] [;PWD=value] [;UID=value] [;<Attribute>=<value>]",
        "connectionStringName": "stats",
        "databaseType": "SqlAzure"
      }
    ],
    "enabled": true,
    "storageAccountUrl": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<account-key>"
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "name": "sitef6141",
  "type": "Microsoft.Web/sites",
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141",
  "properties": {
    "name": "sitef6141_2024-11-01",
    "blobName": "sitef6141_2024-11-01",
    "created": "2022-09-03T17:33:11.641Z",
    "databases": [
      {
        "name": "backenddb",
        "connectionString": "DSN=data-source-name[;SERVER=value] [;PWD=value] [;UID=value] [;<Attribute>=<value>]",
        "connectionStringName": "backend",
        "databaseType": "SqlAzure"
      },
      {
        "name": "statsdb",
        "connectionString": "DSN=data-source-name[;SERVER=value] [;PWD=value] [;UID=value] [;<Attribute>=<value>]",
        "connectionStringName": "stats",
        "databaseType": "SqlAzure"
      }
    ],
    "finishedTimeStamp": "2022-09-02T17:33:11.641Z",
    "id": 12345,
    "lastRestoreTimeStamp": "2022-09-04T17:33:11.641Z",
    "log": "Succeeded",
    "scheduled": true,
    "sizeInBytes": 56091883,
    "status": "InProgress",
    "storageAccountUrl": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<account-key>",
    "websiteSizeInBytes": 56091883
  }
}

Definizioni

Nome	Descrizione
BackupItem	Descrizione del backup.
BackupItemStatus	Stato del backup.
BackupRequest	Descrizione di un backup che verrà eseguito.
BackupSchedule	Descrizione di una pianificazione di backup. Viene descritta la frequenza con cui deve essere eseguito il backup e quali devono essere i criteri di conservazione.
createdByType	Tipo di identità che ha creato la risorsa.
DatabaseBackupSetting	Impostazioni di backup del database.
DatabaseType	Tipo di database (ad esempio SqlAzure/MySql).
DefaultErrorResponse	Risposta di errore del servizio app.
DefaultErrorResponseError	Modello di errore.
DefaultErrorResponseErrorDetailsItem	Errori dettagliati.
FrequencyUnit	Unità di tempo per la frequenza con cui deve essere eseguito il backup (ad esempio, per il backup settimanale, deve essere impostato su Day e FrequencyInterval deve essere impostato su 7)
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

BackupItem

Oggetto

Descrizione del backup.

Nome	Tipo	Descrizione
id	string (arm-id)	Identificatore di risorsa completamente qualificato per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Tipo di risorsa.
name	string	nome della risorsa.
properties.blobName	string	Nome del BLOB che contiene i dati per il backup.
properties.correlationId	string	Identificatore univoco di correlazione. Per favore, usa questo insieme al timestamp mentre comunichi con il supporto supporto tecnico di Azure.
properties.created	string (date-time)	Timestamp della creazione del backup.
properties.databases	DatabaseBackupSetting[]	Elenco dei database inclusi nel backup.
properties.finishedTimeStamp	string (date-time)	Timestamp al termine del backup.
properties.id	integer (int32)	ID del backup.
properties.lastRestoreTimeStamp	string (date-time)	Timestamp di un'ultima operazione di ripristino che ha utilizzato questo backup.
properties.log	string	Dettagli relativi a questo backup. Potrebbe contenere un messaggio di errore.
properties.name	string	Nome di questo backup.
properties.scheduled	boolean	True se questo backup è stato creato a causa dell'attivazione di una pianificazione.
properties.sizeInBytes	integer (int64)	Dimensione del backup in byte.
properties.status	BackupItemStatus	Stato del backup.
properties.storageAccountUrl	string	URL di firma di accesso condiviso per il contenitore dell'account di archiviazione che contiene questo backup.
properties.websiteSizeInBytes	integer (int64)	Dimensioni dell'app Web originale di cui è stato eseguito il backup.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

BackupItemStatus

Enumerazione

Stato del backup.

Valore	Descrizione
InProgress
Failed
Succeeded
TimedOut
Created
Skipped
PartiallySucceeded
DeleteInProgress
DeleteFailed
Deleted

BackupRequest

Oggetto

Descrizione di un backup che verrà eseguito.

Nome	Tipo	Descrizione
id	string	ID risorsa.
kind	string	Tipo di risorsa.
name	string	Nome risorsa.
properties.backupName	string	Nome del backup.
properties.backupSchedule	BackupSchedule	Pianificare il backup se viene eseguito periodicamente.
properties.databases	DatabaseBackupSetting[]	Database inclusi nel backup.
properties.enabled	boolean	True se la pianificazione del backup è abilitata (deve essere inclusa in questo caso), false se la pianificazione del backup deve essere disabilitata.
properties.storageAccountUrl	string	URL di firma di accesso condiviso al contenitore.
type	string	Tipo di risorsa.

BackupSchedule

Oggetto

Descrizione di una pianificazione di backup. Viene descritta la frequenza con cui deve essere eseguito il backup e quali devono essere i criteri di conservazione.

Nome	Tipo	Valore predefinito	Descrizione
frequencyInterval	integer (int32)	7	Frequenza con cui deve essere eseguito il backup (ad esempio, per il backup settimanale, deve essere impostato su 7 e FrequencyUnit deve essere impostato su Giorno)
frequencyUnit	FrequencyUnit	Day	Unità di tempo per la frequenza con cui deve essere eseguito il backup (ad esempio, per il backup settimanale, deve essere impostato su Day e FrequencyInterval deve essere impostato su 7)
keepAtLeastOneBackup	boolean	True	True se i criteri di conservazione devono sempre mantenere almeno un backup nell'account di archiviazione, indipendentemente dalla data in cui è; false in caso contrario.
lastExecutionTime	string (date-time)		L'ultima volta in cui è stata attivata questa programmazione.
retentionPeriodInDays	integer (int32)	30	Dopo quanti giorni devono essere eliminati i backup.
startTime	string (date-time)		Quando la pianificazione deve iniziare a funzionare.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

DatabaseBackupSetting

Oggetto

Impostazioni di backup del database.

Nome	Tipo	Descrizione
connectionString	string	Contiene una stringa di connessione a un database di cui viene eseguito il backup o il ripristino. Se il ripristino dovrebbe verificarsi in un nuovo database, il nome del database all'interno è quello nuovo.
connectionStringName	string	Contiene un nome di stringa di connessione collegato a SiteConfig.ConnectionStrings. Viene usato durante il ripristino con le opzioni sovrascrivere le stringhe di connessione.
databaseType	DatabaseType	Tipo di database (ad esempio SqlAzure/MySql).
name	string

DatabaseType

Enumerazione

Tipo di database (ad esempio SqlAzure/MySql).

Valore	Descrizione
SqlAzure
MySql
LocalMySql
PostgreSql

DefaultErrorResponse

Oggetto

Risposta di errore del servizio app.

Nome	Tipo	Descrizione
error	DefaultErrorResponseError	Modello di errore.

DefaultErrorResponseError

Oggetto

Modello di errore.

Nome	Tipo	Descrizione
code	string	Stringa standardizzata per identificare l'errore a livello di codice.
details	DefaultErrorResponseErrorDetailsItem[]	Errori dettagliati.
innererror	string	Ulteriori informazioni per eseguire il debug dell'errore.
message	string	Descrizione dettagliata dell'errore e informazioni di debug.
target	string	Descrizione dettagliata dell'errore e informazioni di debug.

DefaultErrorResponseErrorDetailsItem

Oggetto

Errori dettagliati.

Nome	Tipo	Descrizione
code	string	Stringa standardizzata per identificare l'errore a livello di codice.
message	string	Descrizione dettagliata dell'errore e informazioni di debug.
target	string	Descrizione dettagliata dell'errore e informazioni di debug.

FrequencyUnit

Enumerazione

Unità di tempo per la frequenza con cui deve essere eseguito il backup (ad esempio, per il backup settimanale, deve essere impostato su Day e FrequencyInterval deve essere impostato su 7)

Valore	Descrizione
Day
Hour

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.