Восстановление файлов Azure с помощью Azure CLI

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

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

Просмотрите точки восстановления для резервной копии файлов Azure.
Восстановите полный файл Azure.
Восстановление отдельных файлов или папок.

Примечание.

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

Предпосылки

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

Общий доступ к файлам	учетная запись хранения	Регион	Сведения
`azurefiles`	afsaccount	Восточный регион США (EastUS)	Исходный источник резервируется с помощью Azure Backup
azurefiles1	afaccount1	Восточный регион США (EastUS)	Источник назначения, используемый для восстановления альтернативного расположения

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

Подготовка среды к работе с Azure CLI

Используйте среду 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, последняя версия уже установлена.

Получение точек восстановления для файлов Azure

Используйте командлет az backup recoverypoint list для перечисления всех точек восстановления для файловой общей папки, сохраненной в резервной копии.

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

az backup recoverypoint list --vault-name azurefilesvault --resource-group azurefiles --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --backup-management-type azurestorage --item-name "AzureFileShare;azurefiles" --workload-type azurefileshare --out table

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

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

az backup recoverypoint list --vault-name azurefilesvault --resource-group azurefiles --container-name afsaccount --backup-management-type azurestorage --item-name azurefiles --workload-type azurefileshare --out table

Результирующий набор — это список точек восстановления со сведениями о времени и согласованности для каждой точки восстановления.

Name                Time                        Consistency
------------------  -------------------------   --------------------
932887541532871865  2020-01-05T07:08:23+00:00   FileSystemConsistent
932885927361238054  2020-01-05T07:08:10+00:00   FileSystemConsistent
932879614553967772  2020-01-04T21:33:04+00:00   FileSystemConsistent

Атрибут Name в выходных данных соответствует имени точки восстановления, которое можно использовать в качестве значения параметра --rp-name в операциях восстановления.

Этот параметр восстановления можно использовать для восстановления полного файлового ресурса в исходном или альтернативном расположении.

Определите следующие параметры для выполнения операций восстановления:

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

При восстановлении в исходное расположение не нужно указывать параметры, связанные с целевыми объектами. Необходимо предоставить только разрешение конфликта .

В следующем примере используется командлет с установленным режимом az backup restore restore-azurefileshare восстановления для восстановления общей папки File Share в исходном расположении. Вы используете точку восстановления 932883129628959823, полученную в точках восстановления для файлов Azure:

az backup restore restore-azurefileshare --vault-name azurefilesvault --resource-group azurefiles --rp-name 932887541532871865   --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode originallocation --resolve-conflict overwrite --out table

Name                                  ResourceGroup
------------------------------------  ---------------
6a27cc23-9283-4310-9c27-dcfb81b7b4bb  azurefiles

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

Этот параметр можно использовать для восстановления общей папки в альтернативном расположении и сохранения исходной общей папки. Укажите следующие параметры для восстановления данных в альтернативном месте расположения:

--target-storage-account: учетная запись хранения, в которую восстанавливается резервное копирование содержимого. Целевая учетная запись хранения должна быть в том же расположении, что и резервное хранилище.
--target-file-share: Файловое хранилище в целевой учетной записи хранения, куда восстанавливается содержимое, которое было выведено в резерв.
--target-folder: папка в общей папке, в которой восстанавливаются данные. Если содержимое резервной копии необходимо восстановить в корневую папку, укажите значения целевой папки в виде пустой строки.
--resolve-conflict: инструкция, если есть конфликт с восстановленными данными. Принимает перезаписать или пропустить.

В следующем примере используется режим az backup restore restore-azurefileshare в качестве alternatelocation для восстановления файлового ресурса azurefiles в учетной записи хранения afsaccount в файловый ресурс azurefiles1 в учетной записи хранения afaccount1.

az backup restore restore-azurefileshare --vault-name azurefilesvault --resource-group azurefiles --rp-name 932883129628959823 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode alternatelocation --target-storage-account afaccount1 --target-file-share azurefiles1 --target-folder restoredata --resolve-conflict overwrite --out table

Name                                  ResourceGroup
------------------------------------  ---------------
babeb61c-d73d-4b91-9830-b8bfa83c349a  azurefiles

Восстановление на уровне элементов

Эту функцию восстановления можно использовать для восстановления отдельных файлов или папок в исходном или альтернативном расположении.

Определите следующие параметры для выполнения операций восстановления:

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

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

SourceFilePath: абсолютный путь к файлу, который необходимо восстановить в общей папке, в виде строки. Этот путь является тем же, который используется в командах az storage file download или az storage file show CLI.
SourceFileType: выберите, выбран ли каталог или файл. Принимает каталог или файл.
ResolveConflict: инструкции в случае конфликта с восстановленными данными. Принимает перезаписать или пропустить.

Восстановление отдельных файлов или папок в исходном расположении

Используйте командлет в режиме az backup restore restore-azurefiles восстановления для того, чтобы восстановить определенные файлы или папки в их исходное расположение.

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

az backup restore restore-azurefiles --vault-name azurefilesvault --resource-group azurefiles --rp-name 932881556234035474 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode originallocation  --source-file-type file --source-file-path "Restore/RestoreTest.txt" --resolve-conflict overwrite  --out table

Name                                  ResourceGroup
------------------------------------  ---------------
df4d9024-0dcb-4edc-bf8c-0a3d18a25319  azurefiles

Восстановление отдельных файлов или папок в альтернативном расположении

Чтобы восстановить определенные файлы или папки в альтернативном расположении, используйте az backup restore restore-azurefiles командлет с режимом alternatelocation восстановления и укажите следующие параметры, связанные с целевыми объектами:

--target-storage-account: учетная запись хранения, в которую восстанавливается резервное копирование содержимого. Целевая учетная запись хранения должна быть в том же расположении, что и резервное хранилище.
--target-file-share: Файловое хранилище в целевой учетной записи хранения, куда восстанавливается содержимое, которое было выведено в резерв.
--target-folder: папка в общей папке, в которой восстанавливаются данные. Если резервное копирование содержимого необходимо восстановить в корневой папке, присвойте целевой папке значение пустой строки.

В следующем примере файл RestoreTest.txt, изначально находившийся в azurefiles File Share, восстанавливается в альтернативное расположение: папка restoredata, находящаяся в File Share azurefiles1, размещенном в учетной записи хранения afaccount1.

az backup restore restore-azurefiles --vault-name azurefilesvault --resource-group azurefiles --rp-name 932881556234035474 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode alternatelocation --target-storage-account afaccount1 --target-file-share azurefiles1 --target-folder restoredata --resolve-conflict overwrite --source-file-type file --source-file-path "Restore/RestoreTest.txt" --out table

Name                                  ResourceGroup
------------------------------------  ---------------
df4d9024-0dcb-4edc-bf8c-0a3d18a25319  azurefiles

Восстановление нескольких файлов или папок в исходном или альтернативном расположении

Чтобы выполнить восстановление для нескольких элементов, передайте значение параметра source-file-path в виде разделенных пробелами путей всех файлов или папок, которые требуется восстановить.

В следующем примере выполняется восстановление Restore.txt и файлов тестирования AFS Report.docx в их исходном расположении.

az backup restore restore-azurefiles --vault-name azurefilesvault --resource-group azurefiles --rp-name 932889937058317910 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode originallocation  --source-file-type file --source-file-path "Restore Test.txt" "AFS Testing Report.docx" --resolve-conflict overwrite  --out table

Результат будет выглядеть примерно так:

Name                                          ResourceGroup
------------------------------------          ---------------
649b0c14-4a94-4945-995a-19e2aace0305          azurefiles

Если вы хотите восстановить несколько элементов в альтернативном расположении, используйте приведенную выше команду, указав параметры, связанные с целевыми объектами, как описано в разделе "Восстановление отдельных файлов или папок" в альтернативный раздел расположения .

Дальнейшие действия

Управление резервными копиями файлов Azure с помощью портала Azure, Azure PowerShell, Azure CLI, REST API.

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

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

Last updated on 2025-06-03

Поделиться через