Управление резервными копиями файлов Azure с помощью Azure CLI

В этой статье описывается, как управлять и отслеживать резервные копии файлов Azure (моментальные снимки и резервные копии в хранилищах) с помощью Azure CLI. Интерфейс командной строки Azure предоставляет возможности командной строки для управления ресурсами Azure. Это отличный инструмент для создания пользовательской автоматизации для использования ресурсов Azure. Вы также можете управлять резервными копиями файлов Azure с помощью портала Azure, Azure PowerShell, REST API.

Предварительные условия

В этой статье предполагается, что вы уже создали резервную копию файлов Azure с помощью Azure Backup. Если у вас нет файлов, см. статью "Резервное копирование файлов Azure" с помощью интерфейса командной строки для настройки резервного копирования для общих папок. В этой статье вы используете следующие ресурсы.

Группа ресурсов: azurefiles
RecoveryServicesVault: azurefilesvault
Учетная запись хранения: afsaccount
Общий доступ к файлам: azurefiles

Используйте среду Bash в Azure Cloud Shell. Дополнительные сведения см. в статье "Начало работы с Azure Cloud Shell".
Если вы предпочитаете выполнять справочные команды CLI локально, установите Azure CLI. Если вы работаете в Windows или macOS, Azure CLI можно запустить в контейнере Docker. Дополнительные сведения см. в статье Как запустить Azure CLI в контейнере Docker.
- Если вы используете локальную установку, выполните вход в Azure CLI с помощью команды az login. Чтобы выполнить аутентификацию, следуйте инструкциям в окне терминала. Сведения о других параметрах входа см. в статье "Проверка подлинности в Azure с помощью Azure CLI".
- Установите расширение Azure CLI при первом использовании, когда появится соответствующий запрос. Дополнительные сведения о расширениях см. в статье Использование расширений и управление ими с помощью Azure CLI.
- Выполните команду az version, чтобы узнать установленную версию и зависимые библиотеки. Чтобы обновиться до последней версии, выполните команду az upgrade.

Для работы с этим руководством требуется Azure CLI версии 2.0.18 или более поздней. Если вы используете Azure Cloud Shell, последняя версия уже установлена.

Мониторинг работ

При запуске операций резервного копирования или восстановления служба резервного копирования создает задание для отслеживания. Чтобы отслеживать выполненные или выполняемые в данный момент задания, используйте командлет az backup job list. С помощью CLI вы также можете приостановить выполнение текущего задания или дождаться его завершения .

В следующем примере отображается состояние заданий резервного копирования для хранилища служб восстановления azurefilesvault.

az backup job list --resource-group azurefiles --vault-name azurefilesvault

[
  {
    "eTag": null,
    "id": "/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupJobs/d477dfb6-b292-4f24-bb43-6b14e9d06ab5",
    "location": null,
    "name": "d477dfb6-b292-4f24-bb43-6b14e9d06ab5",
    "properties": {
      "actionsInfo": null,
      "activityId": "3cef43ed-0af4-43e2-b9cb-1322c496ccb4",
      "backupManagementType": "AzureStorage",
      "duration": "0:00:29.718011",
      "endTime": "2020-01-13T08:05:29.180606+00:00",
      "entityFriendlyName": "azurefiles",
      "errorDetails": null,
      "extendedInfo": null,
      "jobType": "AzureStorageJob",
      "operation": "Backup",
      "startTime": "2020-01-13T08:04:59.462595+00:00",
      "status": "Completed",
      "storageAccountName": "afsaccount",
      "storageAccountVersion": "MicrosoftStorage"
    },
    "resourceGroup": "azurefiles",
    "tags": null,
    "type": "Microsoft.RecoveryServices/vaults/backupJobs"
  },
  {
    "eTag": null,
    "id": "/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupJobs/1b9399bf-c23c-4caa-933a-5fc2bf884519",
    "location": null,
    "name": "1b9399bf-c23c-4caa-933a-5fc2bf884519",
    "properties": {
      "actionsInfo": null,
      "activityId": "2663449c-94f1-4735-aaf9-5bb991e7e00c",
      "backupManagementType": "AzureStorage",
      "duration": "0:00:28.145216",
      "endTime": "2020-01-13T08:05:27.519826+00:00",
      "entityFriendlyName": "azurefilesresource",
      "errorDetails": null,
      "extendedInfo": null,
      "jobType": "AzureStorageJob",
      "operation": "Backup",
      "startTime": "2020-01-13T08:04:59.374610+00:00",
      "status": "Completed",
      "storageAccountName": "afsaccount",
      "storageAccountVersion": "MicrosoftStorage"
    },
    "resourceGroup": "azurefiles",
    "tags": null,
    "type": "Microsoft.RecoveryServices/vaults/backupJobs"
  }
]

Создание политики резервного копирования

Политика Архивации Azure для файлов Azure определяет, как и когда создаются резервные копии, период хранения для точек восстановления и правила защиты данных и восстановления.

Выберите уровень резервного копирования:

Уровень снимков
уровеньVault-Standard

Политику архивации можно создать, выполнив команду az backup policy create со следующими параметрами:

--backup-management-type – Azure Storage
--workload-type — AzureFileShare
--name — имя политики
--policy -— файл JSON с соответствующими сведениями о расписании и хранении
--resource-group — группа ресурсов хранилища
--vault-name — имя хранилища

Пример

az backup policy create --resource-group azurefiles --vault-name azurefilesvault --name schedule20 --backup-management-type AzureStorage --policy samplepolicy.json --workload-type AzureFileShare

Пример JSON (samplepolicy.json)

{
  "eTag": null,
  "id": "/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupPolicies/schedule20",
  "location": null,
  "name": "schedule20",
  "properties": {
    "backupManagementType": "AzureStorage",
    "protectedItemsCount": 0,
    "retentionPolicy": {
      "dailySchedule": {
        "retentionDuration": {
          "count": 30,
          "durationType": "Days"
        },
        "retentionTimes": [
          "2020-01-05T08:00:00+00:00"
        ]
      },
      "monthlySchedule": null,
      "retentionPolicyType": "LongTermRetentionPolicy",
      "weeklySchedule": null,
      "yearlySchedule": null
    },
    "schedulePolicy": {
      "schedulePolicyType": "SimpleSchedulePolicy",
      "scheduleRunDays": null,
      "scheduleRunFrequency": "Daily",
      "scheduleRunTimes": [
        "2020-01-05T08:00:00+00:00"
      ],
      "scheduleWeeklyFrequency": 0
    },
    "timeZone": "UTC",
    "workLoadType": “AzureFileShare”
  },
  "resourceGroup": "azurefiles",
  "tags": null,
  "type": "Microsoft.RecoveryServices/vaults/backupPolicies"
}

Пример настройки политики резервного копирования, которая создает несколько резервных копий в день

Этот пример JSON предназначен для выполнения следующих требований:

Расписание. Создавать резервную копию каждые 4 часа, начиная с 08:00 (UTC) в течение следующих 12 часов.
Хранение: Ежедневно - пять дней, Еженедельно - Каждый воскресенье в течение 12 недель, Ежемесячно - Первое воскресенье каждого месяца в течение 60 месяцев, и Ежегодно - Первое воскресенье января в течение 10 лет.

{
    "properties":{
        "backupManagementType": "AzureStorage",
        "workloadType": "AzureFileShare",
        "schedulePolicy": {
            "schedulePolicyType": "SimpleSchedulePolicy",
            "scheduleRunFrequency": "Hourly",
            "hourlySchedule": {
                "interval": 4,
                "scheduleWindowStartTime": "2021-09-29T08:00:00.000Z",
                "scheduleWindowDuration": 12
            }
        },
        "timeZone": "UTC",
        "retentionPolicy": {
            "retentionPolicyType": "LongTermRetentionPolicy",
            "dailySchedule": {
                "retentionTimes": null,
                "retentionDuration": {
                    "count": 5,
                    "durationType": "Days"
                }
            },
            "weeklySchedule": {
                "daysOfTheWeek": [
                    "Sunday"
                ],
                "retentionTimes": null,
                "retentionDuration": {
                    "count": 12,
                    "durationType": "Weeks"
                }
            },
            "monthlySchedule": {
                "retentionScheduleFormatType": "Weekly",
                "retentionScheduleDaily": null,
                "retentionScheduleWeekly": {
                    "daysOfTheWeek": [
                        "Sunday"
                    ],
                    "weeksOfTheMonth": [
                        "First"
                    ]
                },
                "retentionTimes": null,
                "retentionDuration": {
                    "count": 60,
                    "durationType": "Months"
                }
            },
            "yearlySchedule": {
                "retentionScheduleFormatType": "Weekly",
                "monthsOfYear": [
                    "January"
                ],
                "retentionScheduleDaily": null,
                "retentionScheduleWeekly": {
                    "daysOfTheWeek": [
                        "Sunday"
                    ],
                    "weeksOfTheMonth": [
                        "First"
                    ]
                },
                "retentionTimes": null,
                "retentionDuration": {
                    "count": 10,
                    "durationType": "Years"
                }
            }
        }
    }
}

После успешного создания политики выходные данные команды отображают json политики, переданную в качестве параметра при выполнении команды.

Вы можете изменить раздел расписания и хранения в политике по мере необходимости.

Пример

Если вы хотите сохранить резервную копию первого воскресенья каждого месяца в течение двух месяцев, обновите ежемесячное расписание следующим образом:

"monthlySchedule": {
        "retentionDuration": {
          "count": 2,
          "durationType": "Months"
        },
        "retentionScheduleDaily": null,
        "retentionScheduleFormatType": "Weekly",
        "retentionScheduleWeekly": {
          "daysOfTheWeek": [
            "Sunday"
          ],
          "weeksOfTheMonth": [
            "First"
          ]
        },
        "retentionTimes": [
          "2020-01-05T08:00:00+00:00"
        ]
      }

Чтобы создать политику резервного копирования для уровня Vault-Standard файлов Azure, выполните следующие команды:

Экспортируйте стандартные политики моментального снимка и хранилища по умолчанию в виде JSON-файлов для создания политики.
```
az backup policy show --resource-group myResourceGroup --vault-name myRecoveryServicesVault  --name DefaultVaultPolicy > vaultdemopol.json 
```

Создайте политику резервного копирования с помощью команды az backup policy create.

az backup policy create --resource-group myResourceGroup --vault-name myRecoveryServicesVault  --policy vaultdemopol.json  --name vaultpol --backup-management-type AzureStorage

Пример выходных данных:

(azcli) C:\Users\testuser\Downloads\CLIForAFS\azure-cli>az backup policy create -g myResourceGroup  -v afsbugbashvault --policy vaultdemopol.json  --name vaultpol --backup-management-type AzureStorage
{
  "eTag": null,
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup /providers/Microsoft.RecoveryServices/vaults/ myRecoveryServicesVault  /backupPolicies/vaultpol",
  "location": null,
  "name": "vaultpol",
  "properties": {
    "backupManagementType": "AzureStorage",
    "protectedItemsCount": 0,
    "resourceGuardOperationRequests": null,
    "retentionPolicy": null,
    "schedulePolicy": {
      "hourlySchedule": null,
      "schedulePolicyType": "SimpleSchedulePolicy",
      "scheduleRunDays": null,
      "scheduleRunFrequency": "Daily",
      "scheduleRunTimes": [
        "2024-12-30T23:00:00+00:00"
      ],
      "scheduleWeeklyFrequency": 0
    },
    "timeZone": "UTC",
    "vaultRetentionPolicy": {
      "snapshotRetentionInDays": 5,
      "vaultRetention": {
        "dailySchedule": {
          "retentionDuration": {
            "count": 30,
            "durationType": "Days"
          },
          "retentionTimes": [
            "2024-12-30T23:00:00+00:00"
          ]
        },
        "monthlySchedule": null,
        "retentionPolicyType": "LongTermRetentionPolicy",
        "weeklySchedule": null,
        "yearlySchedule": null
      }
    },
    "workLoadType": "AzureFileShare"
  },
  "resourceGroup": "myResourceGroup ",
  "tags": null,
  "type": "Microsoft.RecoveryServices/vaults/backupPolicies"
}

Изменение политики

Вы можете изменить политику резервного копирования, чтобы изменить периодичность резервного копирования или диапазон хранения с помощью команды az backup item set-policy.

Чтобы изменить политику, определите следующие параметры.

--container-name: имя учетной записи хранения, хранящей файловый ресурс. Чтобы получить имя или понятное имя контейнера, используйте команду az backup container list.
--name: имя файлового хранилища, для которого вы хотите изменить политику. Чтобы получить имя или понятное имя архивированного элемента, используйте команду az backup item list.
--policy-name: имя политики резервного копирования, которую вы хотите задать для общей папки. Чтобы просмотреть все политики для хранилища, можно использовать команду az backup policy list.

В следующем примере устанавливается политика резервного копирования schedule2 для файлового хранилища, присутствующего в учетной записи хранения azurefiles.

az backup item set-policy --policy-name schedule2 --name azurefiles --vault-name azurefilesvault --resource-group azurefiles --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --name "AzureFileShare;azurefiles" --backup-management-type azurestorage --out table

Вы также можете выполнить предыдущую команду с помощью понятных имен для контейнера и элемента, указав следующие два дополнительных параметра:

--backup-management-type: azurestorage
--workload-type: azurefileshare

az backup item set-policy --policy-name schedule2 --name azurefiles --vault-name azurefilesvault --resource-group azurefiles --container-name afsaccount --name azurefiles --backup-management-type azurestorage --out table

Name                                  ResourceGroup
------------------------------------  ---------------
fec6f004-0e35-407f-9928-10a163f123e5  azurefiles

Атрибут Name в выходных данных соответствует имени задания, созданного службой резервного копирования для операции изменения политики. Чтобы отслеживать состояние задания, используйте командлет az backup job show.

Существует два способа остановить защиту файлов Azure:

остановить все будущие задания резервного копирования и удалить все точки восстановления.
Можно остановить все будущие задания резервного копирования, но сохранить точки восстановления.

Может возникнуть стоимость, связанная с сохранением точек восстановления в хранилище, так как создаваемые Azure Backup базовые снимки состояния остаются сохранёнными. Преимуществом сохранения точек восстановления является возможность позже восстановить File Share, если вы захотите. Дополнительные сведения о стоимости сохранения точек восстановления см. в подробностях о ценах. Если вы решите удалить все точки восстановления, восстановление общего файлового ресурса станет невозможным.

Чтобы остановить защиту файлового хранилища, определите следующие параметры:

--container-name: имя учетной записи хранения, хранящей файловый ресурс. Чтобы получить имя или понятное имя контейнера, используйте команду az backup container list.
--item-name: имя общей папки, для которой требуется остановить защиту. Чтобы получить имя или понятное имя архивированного элемента, используйте команду az backup item list.

Отключение защиты и сохранение точек восстановления

Чтобы остановить защиту при сохранении данных, используйте командлет az backup protection disable.

В следующем примере защита файлового хранилища azurefiles останавливается, но сохраняются все точки восстановления.

az backup protection disable --vault-name azurefilesvault --resource-group azurefiles --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name “AzureFileShare;azurefiles” --out table

Вы также можете выполнить предыдущую команду с помощью понятного имени контейнера и элемента, указав следующие два дополнительных параметра:

--backup-management-type: azurestorage
--workload-type: azurefileshare

az backup protection disable --vault-name azurefilesvault --resource-group azurefiles --container-name afsaccount --item-name azurefiles --workload-type azurefileshare --backup-management-type Azurestorage --out table

Name                                  ResourceGroup
------------------------------------  ---------------
fec6f004-0e35-407f-9928-10a163f123e5  azurefiles

Атрибут Name в выходных данных соответствует имени задания, созданного службой резервного копирования для операции остановки защиты. Чтобы отслеживать состояние задания, используйте командлет az backup job show.

Отключение защиты без сохранения точек восстановления

Чтобы отключить защиту без удержания точек восстановления, используйте командлет az backup protection disable, указав для параметра delete-backup-data значение true.

В следующем примере защита файлового общего ресурса azurefiles прекращается без сохранения точек восстановления.

az backup protection disable --vault-name azurefilesvault --resource-group azurefiles --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name “AzureFileShare;azurefiles” --delete-backup-data true --out table

--backup-management-type: azurestorage
--workload-type: azurefileshare

az backup protection disable --vault-name azurefilesvault --resource-group azurefiles --container-name afsaccount --item-name azurefiles --workload-type azurefileshare --backup-management-type Azurestorage --delete-backup-data true --out table

Если вы остановили защиту для файлов Azure, но сохранили точки восстановления, вы можете возобновить защиту позже. Если точки восстановления не сохранены, вы не сможете возобновить защиту.

Чтобы возобновить защиту файлового ресурса, определите следующие параметры:

--container-name: имя учетной записи хранения, хранящей файловый ресурс. Чтобы получить имя или понятное имя контейнера, используйте команду az backup container list.
--item-name: имя общей папки, для которой требуется возобновить защиту. Чтобы получить имя или понятное имя архивированного элемента, используйте команду az backup item list.
--policy-name: имя политики резервного копирования, для которой требуется возобновить защиту для общей папки.

В следующем примере используется командлет az backup protection resume для azurefiles возобновления защиты общего доступа к файлам с помощью политики резервного копирования schedule1.

az backup protection resume --vault-name azurefilesvault --resource-group azurefiles --container-name "StorageContainer;Storage;AzureFiles;afsaccount” --item-name “AzureFileShare;azurefiles” --policy-name schedule2 --out table

--backup-management-type: azurestorage
--workload-type: azurefileshare

az backup protection resume --vault-name azurefilesvault --resource-group azurefiles --container-name afsaccount --item-name azurefiles --workload-type azurefileshare --backup-management-type Azurestorage --policy-name schedule2 --out table

Name                                  ResourceGroup
------------------------------------  ---------------
75115ab0-43b0-4065-8698-55022a234b7f  azurefiles

Атрибут Name в выходных данных соответствует имени задания, созданного службой резервного копирования для операции защиты данных резервной копией. Чтобы отслеживать состояние задания, используйте командлет az backup job show.

Отмена регистрации учетной записи хранения

Если вы хотите защитить общие папки в определенной учетной записи хранения с помощью другого хранилища служб восстановления, сначала остановите защиту всех общих папок в этой учетной записи хранения. Затем отмените регистрацию учетной записи в хранилище служб восстановления, которое сейчас используется для защиты.

Чтобы отменить регистрацию учетной записи хранения, необходимо указать имя контейнера. Чтобы получить имя или понятное имя контейнера, используйте команду az backup container list.

В следующем примере выполняется отмена регистрации учетной записи хранения afsaccount из azurefilesvault с помощью командлета az backup container unregister.

az backup container unregister --vault-name azurefilesvault --resource-group azurefiles --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --out table

Вы также можете запустить предыдущий командлет с помощью понятного имени контейнера, указав следующий дополнительный параметр:

--backup-management-type: azurestorage

az backup container unregister --vault-name azurefilesvault --resource-group azurefiles --container-name afsaccount --backup-management-type azurestorage --out table

Следующие шаги

Устранение неполадок резервного копирования файлов Azure.

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2025-05-22