Web Apps - List Backups

Service:: App Service

Version d'API:: 2026-03-15

Description de Obtient les sauvegardes existantes d’une application.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
name	path	True	string	Nom de l’application.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string (uuid)	ID de l’abonnement cible. La valeur doit être un UUID.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Réponses

Nom	Type	Description
200 OK	BackupItemCollection	Opération Azure terminée avec succès.
Other Status Codes	DefaultErrorResponse	Réponse d’erreur inattendue.

Sécurité

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

List web app backups

Exemple de requête

HTTP

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

Exemple de réponse

Code d’état:: 200

{
  "value": [
    {
      "name": "sitef6141",
      "type": "Microsoft.Web/sites",
      "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141/backups/12345",
      "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-05T17: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
      }
    }
  ]
}

Définitions

Nom	Description
BackupItem	Description de la sauvegarde.
BackupItemCollection	Collection d’éléments de sauvegarde.
BackupItemStatus	État de la sauvegarde.
createdByType	Type d’identité qui a créé la ressource.
DatabaseBackupSetting	Paramètres de sauvegarde de la base de données.
DatabaseType	Type de base de données (par exemple, SqlAzure / MySql).
DefaultErrorResponse	Réponse d’erreur App Service.
DefaultErrorResponseError	Modèle d’erreur.
DefaultErrorResponseErrorDetailsItem	Erreurs détaillées.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.

BackupItem

Objet

Description de la sauvegarde.

Nom	Type	Description
id	string (arm-id)	ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
kind	string	Type de ressource.
name	string	Nom de la ressource
properties.blobName	string	Nom de l’objet blob qui contient les données pour cette sauvegarde.
properties.correlationId	string	Identificateur de corrélation unique. Veuillez utiliser cela avec l’horodatage lors de la communication avec le support support Azure.
properties.created	string (date-time)	Horodatage de la création de la sauvegarde.
properties.databases	DatabaseBackupSetting[]	Liste des bases de données incluses dans la sauvegarde.
properties.finishedTimeStamp	string (date-time)	Horodatage à la fin de cette sauvegarde.
properties.id	integer (int32)	ID de la sauvegarde.
properties.lastRestoreTimeStamp	string (date-time)	Horodatage d’une dernière opération de restauration qui a utilisé cette sauvegarde.
properties.log	string	Détails concernant cette sauvegarde. Peut contenir un message d’erreur.
properties.name	string	Nom de cette sauvegarde.
properties.scheduled	boolean	True si cette sauvegarde a été créée en raison du déclenchement d’une planification.
properties.sizeInBytes	integer (int64)	Taille de la sauvegarde en octets.
properties.status	BackupItemStatus	État de la sauvegarde.
properties.storageAccountUrl	string	URL SAS du conteneur de compte de stockage qui contient cette sauvegarde.
properties.websiteSizeInBytes	integer (int64)	Taille de l’application web d’origine qui a été sauvegardée.
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

BackupItemCollection

Objet

Collection d’éléments de sauvegarde.

Nom	Type	Description
nextLink	string (uri)	Lien vers la page suivante des éléments
value	BackupItem[]	Les éléments BackupItem sur cette page

BackupItemStatus

Énumération

État de la sauvegarde.

Valeur	Description
InProgress
Failed
Succeeded
TimedOut
Created
Skipped
PartiallySucceeded
DeleteInProgress
DeleteFailed
Deleted

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
User
Application
ManagedIdentity
Key

DatabaseBackupSetting

Objet

Paramètres de sauvegarde de la base de données.

Nom	Type	Description
connectionString	string	Contient une chaîne de connexion vers une base de données qui est en cours de sauvegarde ou de restauration. Si la restauration doit se produire dans une nouvelle base de données, le nom de la base de données à l’intérieur est le nouveau.
connectionStringName	string	Contient un nom de chaîne de connexion qui est lié au SiteConfig.ConnectionStrings. Cela est utilisé lors de la restauration avec des options de chaînes de connexion de remplacement.
databaseType	DatabaseType	Type de base de données (par exemple, SqlAzure / MySql).
name	string

DatabaseType

Énumération

Type de base de données (par exemple, SqlAzure / MySql).

Valeur	Description
SqlAzure
MySql
LocalMySql
PostgreSql

DefaultErrorResponse

Objet

Réponse d’erreur App Service.

Nom	Type	Description
error	DefaultErrorResponseError	Modèle d’erreur.

DefaultErrorResponseError

Objet

Modèle d’erreur.

Nom	Type	Description
code	string	Chaîne standardisée pour identifier l’erreur par programmation.
details	DefaultErrorResponseErrorDetailsItem[]	Erreurs détaillées.
innererror	string	Plus d’informations pour déboguer l’erreur.
message	string	Description détaillée de l’erreur et informations de débogage.
target	string	Description détaillée de l’erreur et informations de débogage.

DefaultErrorResponseErrorDetailsItem

Objet

Erreurs détaillées.

Nom	Type	Description
code	string	Chaîne standardisée pour identifier l’erreur par programmation.
message	string	Description détaillée de l’erreur et informations de débogage.
target	string	Description détaillée de l’erreur et informations de débogage.

systemData

Objet

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.