Web Apps - Restore Slot

Servicio:: App Service

Versión de la API:: 2025-05-01

Descripción de Restaura una copia de seguridad específica en otra aplicación (o ranura de implementación, si se especifica).

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/backups/{backupId}/restore?api-version=2025-05-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
backupId	path	True	string	ID de la copia de seguridad.
name	path	True	string	Nombre de la aplicación.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
slot	path	True	string	Nombre de la ranura de implementación. Si no se especifica una ranura, la API obtendrá una copia de seguridad de la ranura de producción.
subscriptionId	path	True	string (uuid)	Identificador de la suscripción de destino. El valor debe ser un UUID.
api-version	query	True	string minLength: 1	Versión de API que se usará para esta operación.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
properties.overwrite	True	boolean	`true` si la operación de restauración puede sobrescribir la aplicación de destino; de lo contrario, `false`. `true` es necesario si intenta restaurar sobre una aplicación existente.
properties.storageAccountUrl	True	string	Dirección URL de SAS al contenedor.
kind		string	Tipo de recurso.
properties.adjustConnectionStrings		boolean	`true` si SiteConfig.ConnectionStrings debe establecerse en la nueva aplicación; de lo contrario, `false`.
properties.appServicePlan		string	Especifique el plan de App Service que poseerá el sitio restaurado.
properties.blobName		string	Nombre de un blob que contiene la copia de seguridad.
properties.databases		DatabaseBackupSetting[]	Colección de bases de datos que se deben restaurar. Esta lista tiene que coincidir con la lista de bases de datos incluidas en la copia de seguridad.
properties.hostingEnvironment		string	Nombre de App Service Environment, si es necesario (solo al restaurar una aplicación a un entorno de App Service).
properties.ignoreConflictingHostNames		boolean	Cambia una lógica al restaurar una aplicación con dominios personalizados. `true` para eliminar dominios personalizados automáticamente. Si `false`, se añaden dominios personalizados para \nel objeto de la aplicación cuando se restaura, pero eso podría fallar debido a conflictos durante la operación.
properties.ignoreDatabases		boolean	Omitir las bases de datos y restaurar solo el contenido del sitio
properties.operationType		BackupRestoreOperationType	Tipo de operación.
properties.siteName		string	Nombre de una aplicación.

Respuestas

Nombre	Tipo	Description
200 OK		La operación de Azure se completó correctamente.
202 Accepted		Operación de recurso aceptada. Encabezados Location: string Retry-After: integer
Other Status Codes	DefaultErrorResponse	Una respuesta de error inesperada.

Nombre

Tipo

Description

200 OK

La operación de Azure se completó correctamente.

202 Accepted

Operación de recurso aceptada.

Encabezados

Location: string
Retry-After: integer

Other Status Codes

DefaultErrorResponse

Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Definiciones

Nombre	Description
BackupRestoreOperationType	Tipo de operación.
DatabaseBackupSetting	Configuración de copia de seguridad de la base de datos.
DatabaseType	Tipo de base de datos (por ejemplo, SqlAzure /MySql).
DefaultErrorResponse	Respuesta de error de App Service.
DefaultErrorResponseError	Modelo de error.
DefaultErrorResponseErrorDetailsItem	Errores detallados.
RestoreRequest	Descripción de una solicitud de restauración.

BackupRestoreOperationType

Enumeración

Tipo de operación.

Valor	Description
Default
Clone
Relocation
Snapshot
CloudFS

DatabaseBackupSetting

Objeto

Configuración de copia de seguridad de la base de datos.

Nombre	Tipo	Description
connectionString	string	Contiene una cadena de conexión a una base de datos de la que se realiza una copia de seguridad o se restaura. Si la restauración debe producirse en una nueva base de datos, el nombre de la base de datos dentro es el nuevo.
connectionStringName	string	Contiene un nombre de cadena de conexión que está vinculado a SiteConfig.ConnectionStrings. Esto se usa durante la restauración con opciones de cadenas de conexión sobrescritura.
databaseType	DatabaseType	Tipo de base de datos (por ejemplo, SqlAzure /MySql).
name	string

DatabaseType

Enumeración

Tipo de base de datos (por ejemplo, SqlAzure /MySql).

Valor	Description
SqlAzure
MySql
LocalMySql
PostgreSql

DefaultErrorResponse

Objeto

Respuesta de error de App Service.

Nombre	Tipo	Description
error	DefaultErrorResponseError	Modelo de error.

DefaultErrorResponseError

Objeto

Modelo de error.

Nombre	Tipo	Description
code	string	Cadena estandarizada para identificar el error mediante programación.
details	DefaultErrorResponseErrorDetailsItem[]	Errores detallados.
innererror	string	Más información para depurar el error.
message	string	Descripción detallada del error e información de depuración.
target	string	Descripción detallada del error e información de depuración.

DefaultErrorResponseErrorDetailsItem

Objeto

Errores detallados.

Nombre	Tipo	Description
code	string	Cadena estandarizada para identificar el error mediante programación.
message	string	Descripción detallada del error e información de depuración.
target	string	Descripción detallada del error e información de depuración.

RestoreRequest

Objeto

Descripción de una solicitud de restauración.

Nombre	Tipo	Valor predeterminado	Description
id	string		Identificador de recurso.
kind	string		Tipo de recurso.
name	string		Nombre del recurso.
properties.adjustConnectionStrings	boolean		`true` si SiteConfig.ConnectionStrings debe establecerse en la nueva aplicación; de lo contrario, `false`.
properties.appServicePlan	string		Especifique el plan de App Service que poseerá el sitio restaurado.
properties.blobName	string		Nombre de un blob que contiene la copia de seguridad.
properties.databases	DatabaseBackupSetting[]		Colección de bases de datos que se deben restaurar. Esta lista tiene que coincidir con la lista de bases de datos incluidas en la copia de seguridad.
properties.hostingEnvironment	string		Nombre de App Service Environment, si es necesario (solo al restaurar una aplicación a un entorno de App Service).
properties.ignoreConflictingHostNames	boolean	False	Cambia una lógica al restaurar una aplicación con dominios personalizados. `true` para eliminar dominios personalizados automáticamente. Si `false`, se añaden dominios personalizados para \nel objeto de la aplicación cuando se restaura, pero eso podría fallar debido a conflictos durante la operación.
properties.ignoreDatabases	boolean	False	Omitir las bases de datos y restaurar solo el contenido del sitio
properties.operationType	BackupRestoreOperationType	Default	Tipo de operación.
properties.overwrite	boolean		`true` si la operación de restauración puede sobrescribir la aplicación de destino; de lo contrario, `false`. `true` es necesario si intenta restaurar sobre una aplicación existente.
properties.siteName	string		Nombre de una aplicación.
properties.storageAccountUrl	string		Dirección URL de SAS al contenedor.
type	string		Tipo de recurso.