如何使用Azure SDK恢复Azure App Service最新自动备份？

常见原因及修复方法 #

• 权限配置错误：SDK使用的身份（服务主体/用户账号）必须具备Microsoft.Web/sites/backups/read权限。门户能看到备份但SDK查不到，通常是权限范围没覆盖目标App Service，或选错了订阅/租户ID。
• SDK版本陈旧：升级Microsoft.Azure.Management.WebSites到最新稳定版，旧版本API可能无法正确读取新备份系统的元数据。
• 未处理分页逻辑：GetSiteBackups()可能返回分页结果，部分SDK版本不会自动拼接所有页面。可以手动遍历分页：

  var backups = new List<BackupItem>();
  var currentPage = webSiteForRestore.GetSiteBackups();
  backups.AddRange(currentPage);
  while (currentPage.NextPageLink != null)
  {
      currentPage = webSiteForRestore.GetSiteBackupsNext(currentPage.NextPageLink);
      backups.AddRange(currentPage);
  }
  var latestBackup = backups.OrderByDescending(b => b.Data.CreatedOn).FirstOrDefault();
  

• 存储账户权限缺失：若备份存在外部存储账户，SDK身份需拥有该存储账户的Storage Blob Data Reader权限，否则无法读取备份元数据。
• 状态过滤遗漏：门户显示的备份包含所有状态（成功/失败/进行中），但SDK可能默认只返回部分状态。尝试筛选成功备份：

  var backups = webSiteForRestore.GetSiteBackups().Where(b => b.Data.Status == BackupStatus.Succeeded);
  var latestBackup = backups.OrderByDescending(b => b.Data.CreatedOn).FirstOrDefault();
  

• 资源实例指向错误：确认webSiteForRestore对应的订阅ID、资源组、App Service名称完全匹配门户中的目标资源。

调试步骤 #

1. 输出backups集合的元素数量，判断是API未返回数据，还是排序时出现问题。
2. 检查备份项的CreatedOn字段是否存在null值，这类数据会影响排序结果。
3. 开启SDK请求日志，对比门户调用的API请求（浏览器F12抓包），排查请求参数或端点的差异。

内容的提问来源于stack exchange，提问作者Adnan Hodzic