通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Web Apps - Restore From Backup Blob

服务:
App Service
API 版本:
2025-03-01

从 Azure 存储中的备份 blob 还原应用的说明。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/restoreFromBackupBlob?api-version=2025-03-01

URI 参数

名称 在 必需 类型 说明
name
 path True

string

应用的名称。
resourceGroupName
 path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+[^\.]$

资源所属的资源组的名称。
subscriptionId
 path True

string

Azure 订阅 ID。 这是 GUID 格式的字符串（例如 000000000-0000-0000-0000-00000000000000）。
api-version
 query True

string

API 版本

请求正文

名称 必需 类型 说明
properties.overwrite True

boolean

true 如果还原作可以覆盖目标应用;否则， false. true 如果尝试通过现有应用还原，则需要。
properties.storageAccountUrl True

string

容器的 SAS URL。
kind

string

资源类型。
properties.adjustConnectionStrings

boolean

true 如果应在新应用中设置 SiteConfig.ConnectionStrings;否则， false.
properties.appServicePlan

string

指定将拥有已还原站点的应用服务计划。
properties.blobName

string

包含备份的 Blob 的名称。
properties.databases

DatabaseBackupSetting[]

应还原的数据库集合。 此列表必须与备份中包含的数据库列表匹配。
properties.hostingEnvironment

string

应用服务环境名称（如果需要）（仅当将应用还原到应用服务环境时）。
properties.ignoreConflictingHostNames

boolean

使用自定义域还原应用时更改逻辑。 true 以自动删除自定义域。 如果 ，则 false在还原应用对象时会将自定义域添加到应用对象中，但可能会因作期间的冲突而失败。
properties.ignoreDatabases

boolean

忽略数据库并仅还原站点内容
properties.operationType

BackupRestoreOperationType

作类型。
properties.siteName

string

应用的名称。

响应

名称 类型 说明
200 OK

恢复作已启动。
202 Accepted

恢复作已启动。
Other Status Codes

DefaultErrorResponse

应用服务错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 冒充您的用户帐户

定义

名称 说明
BackupRestoreOperationType

作类型。
DatabaseBackupSetting

数据库备份设置。
DatabaseType

数据库类型（例如 SqlAzure/MySql）。
DefaultErrorResponse

应用服务错误响应。
Details
Error

错误模型。
RestoreRequest

还原请求的说明。

BackupRestoreOperationType

枚举

作类型。

值 说明
Default
Clone
Relocation
Snapshot
CloudFS

DatabaseBackupSetting

Object

数据库备份设置。

名称 类型 说明
connectionString

string

包含要备份或还原的数据库的连接字符串。 如果还原应发生在新数据库，则内部的数据库名称为新数据库。
connectionStringName

string

包含链接到 SiteConfig.ConnectionStrings 的连接字符串名称。 这在还原期间与覆盖连接字符串选项一起使用。
databaseType

DatabaseType

数据库类型（例如 SqlAzure/MySql）。
name

string

DatabaseType

枚举

数据库类型（例如 SqlAzure/MySql）。

值 说明
SqlAzure
MySql
LocalMySql
PostgreSql

DefaultErrorResponse

Object

应用服务错误响应。

名称 类型 说明
error

Error

错误模型。

Details

Object
名称 类型 说明
code

string

标准化字符串，以编程方式识别错误。
message

string

详细的错误描述和调试信息。
target

string

详细的错误描述和调试信息。

Error

Object

错误模型。

名称 类型 说明
code

string

标准化字符串，以编程方式识别错误。
details

Details[]

详细错误。
innererror

string

调试错误的更多信息。
message

string

详细的错误描述和调试信息。
target

string

详细的错误描述和调试信息。

RestoreRequest

Object

还原请求的说明。

名称 类型 默认值 说明
id

string

资源 ID。
kind

string

资源类型。
name

string

资源名称。
properties.adjustConnectionStrings

boolean

true 如果应在新应用中设置 SiteConfig.ConnectionStrings;否则， false.
properties.appServicePlan

string

指定将拥有已还原站点的应用服务计划。
properties.blobName

string

包含备份的 Blob 的名称。
properties.databases

DatabaseBackupSetting[]

应还原的数据库集合。 此列表必须与备份中包含的数据库列表匹配。
properties.hostingEnvironment

string

应用服务环境名称（如果需要）（仅当将应用还原到应用服务环境时）。
properties.ignoreConflictingHostNames

boolean

False

使用自定义域还原应用时更改逻辑。 true 以自动删除自定义域。 如果 ，则 false在还原应用对象时会将自定义域添加到应用对象中，但可能会因作期间的冲突而失败。
properties.ignoreDatabases

boolean

False

忽略数据库并仅还原站点内容
properties.operationType

BackupRestoreOperationType

Default

作类型。
properties.overwrite

boolean

true 如果还原作可以覆盖目标应用;否则， false. true 如果尝试通过现有应用还原，则需要。
properties.siteName

string

应用的名称。
properties.storageAccountUrl

string

容器的 SAS URL。
type

string

资源类型。