Compartilhar via

Gerenciar backups de Arquivos do Azure com a CLI do Azure

Este artigo descreve como gerenciar e monitorar os backups dos Arquivos do Azure (backups instantâneos e armazenados em cofre) usando a CLI do Azure. A CLI do Azure fornece uma experiência de linha de comando para gerenciamento de recursos do Azure. Ela é uma excelente ferramenta para a criação de automação personalizada para usar os recursos do Azure. Você também pode gerenciar backups dos Arquivos do Azure usando o portal do Azure, o Azure PowerShell, a API REST.

Pré-requisitos

Este artigo pressupõe que você já tenha um backup dos Arquivos do Azure pelo Backup do Azure. Se você não tiver um, consulte Fazer backup dos Arquivos do Azure com a CLI para configurar o backup para seus Compartilhamentos de Arquivos. Neste artigo, você usará os seguintes recursos:

  • Grupo de recursos: azurefiles
  • RecoveryServicesVault: azurefilesvault
  • Conta de armazenamento: afsaccount
  • Compartilhamento de Arquivo: azurefiles
  • Este tutorial exige a versão 2.0.18 ou posterior da CLI do Azure. Se você está usando o Azure Cloud Shell, a versão mais recente já está instalada.

Monitorar trabalhos

Ao acionar operações de backup ou de restauração, o serviço de backup cria um trabalho de rastreamento. Para monitorar trabalhos concluídos ou em execução no momento, use o cmdlet az backup job list. Com a CLI, você também pode suspender um trabalho atualmente em execução ou aguardar até que um trabalho seja concluído.

O próximo exemplo exibe o status dos trabalhos de backup do cofre dos Serviços de Recuperação do 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"
  }
]

Criar uma política de backup

A política de Backup do Azure para Arquivos do Azure define como e quando os backups são criados, o período de retenção para pontos de recuperação e as regras de proteção e recuperação de dados.

Escolher um nível de backup:

Para criar uma política de backup incremental, execute o comando az backup policy create com os seguintes parâmetros:

  • --backup-management-type – Armazenamento do Azure
  • --workload-type – AzureFileShare
  • --name – o nome da política
  • --policy – arquivo JSON com os detalhes adequados para agenda e retenção
  • --resource-group – grupo de recursos do cofre
  • --vault-name – nome do cofre

Exemplo

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

JSON de exemplo (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"
}

Exemplo para criar uma política de backup que configura vários backups por dia

Este JSON de amostra é para os seguintes requisitos:

  • Agendamento: fazer backup a cada 4 horas a partir das 8h (UTC) pelas próximas 12 horas.
  • Retenção: Diariamente - cinco dias, Semanal - Todos os Domingos por 12 semanas, Mensal - Primeiro Domingo de cada mês por 60 meses, e Anual - Primeiro Domingo de Janeiro por 10 anos.
{
    "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"
                }
            }
        }
    }
}

Depois que a política é criada com êxito, a saída do comando exibe o JSON da política que você passou como um parâmetro durante a execução do comando.

Você pode modificar a seção de agendamento e de retenção da política conforme necessário.

Exemplo

Se você quiser manter o backup do primeiro domingo de cada mês por dois meses, atualize o agendamento mensal de acordo com o exemplo a seguir:

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

Modificar a política

Você pode modificar uma política de backup para alterar a frequência de backup ou o período de retenção usando az backup item set-policy.

Para alterar a política, defina os seguintes parâmetros:

  • --container-name: o nome da conta de armazenamento que hospeda o Compartilhamento de Arquivos. Para recuperar o nome ou nome amigável do seu contêiner, use o comando az backup container list.
  • --name: o nome do Compartilhamento de Arquivos para o qual você deseja alterar a política. Para recuperar o nome ou nome amigável de seu item de backup, use o comando az backup item list.
  • --policy-name: o nome da política de backup que você deseja definir para o Compartilhamento de Arquivos. Você pode usar az backup policy list para exibir todas as políticas de seu cofre.

O exemplo a seguir define a política de backup schedule2 para o azurefiles File Share presente na conta de armazenamento afsaccount.

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

Você também pode executar o comando anterior usando os nomes amigáveis para o contêiner e o item fornecendo mais dois parâmetros a seguir:

  • --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

O atributo Name na saída corresponde ao nome do trabalho criado pelo serviço de backup para a operação de restauração. Para acompanhar o status do trabalho, use o cmdlet az backup job show.

Interromper a proteção em um Compartilhamento de arquivo

Há duas maneiras de parar de proteger os Arquivos do Azure:

  • Interromper todos os trabalhos de backup futuros e excluir todos os pontos de recuperação.
  • Interromper todos os trabalhos de backup futuros, mas deixar os pontos de recuperação.

Pode haver um custo associado à manutenção dos pontos de recuperação no armazenamento, pois os instantâneos de base criados pelo Backup do Azure são mantidos. O benefício de deixar os pontos de recuperação é a opção de restaurar o Compartilhamento de Arquivos posteriormente, se desejar. Para obter informações sobre o custo de deixar os pontos de recuperação, confira os detalhes de preços. Se você optar por excluir todos os pontos de recuperação, não poderá restaurar o Compartilhamento de Arquivos.

Para interromper a proteção para o Compartilhamento de Arquivos, defina os seguintes parâmetros:

  • --container-name: o nome da conta de armazenamento que hospeda o Compartilhamento de Arquivos. Para recuperar o nome ou nome amigável do seu contêiner, use o comando az backup container list.
  • --item-name: o nome do Compartilhamento de Arquivos para o qual você deseja interromper a proteção. Para recuperar o nome ou nome amigável de seu item de backup, use o comando az backup item list.

Interromper a proteção e manter os pontos de recuperação

Para interromper a proteção, mas manter a retenção de dados, use o cmdlet az backup protection disable.

O exemplo a seguir interrompe a proteção para o azurefiles Compartilhamento de Arquivos, mas retém todos os pontos de recuperação.

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

Você também pode executar o comando anterior usando o nome amigável para o contêiner e o item fornecendo mais dois parâmetros a seguir:

  • --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

O atributo Name na saída corresponde ao nome do trabalho criado pelo serviço de backup para a operação de interrupção de proteção. Para acompanhar o status do trabalho, use o cmdlet az backup job show.

Interromper a proteção sem reter os pontos de recuperação

Para interromper a proteção sem reter os pontos de recuperação, use o cmdlet az backup protection disable com a opção delete-backup-data definida como true.

O exemplo a seguir interrompe a proteção para o azurefiles Compartilhamento de Arquivos sem reter pontos de recuperação.

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

Você também pode executar o comando anterior usando o nome amigável para o contêiner e o item fornecendo mais dois parâmetros a seguir:

  • --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

Retomar a proteção em um Compartilhamento de arquivo

Se você parou a proteção de um Arquivos do Azure, mas manteve pontos de recuperação, poderá retomar a proteção mais tarde. Se você não retiver os pontos de recuperação, não poderá retomar a proteção.

Para retomar a proteção para o Compartilhamento de Arquivos, defina os seguintes parâmetros:

  • --container-name: o nome da conta de armazenamento que hospeda o Compartilhamento de Arquivos. Para recuperar o nome ou nome amigável do seu contêiner, use o comando az backup container list.
  • --item-name: o nome do Compartilhamento de Arquivos para o qual você deseja retomar a proteção. Para recuperar o nome ou nome amigável de seu item de backup, use o comando az backup item list.
  • --policy-name: o nome da política de backup para a qual você deseja retomar a proteção para o Compartilhamento de Arquivos.

O exemplo a seguir usa o cmdlet az backup protection resume para retomar a proteção do azurefiles Compartilhamento de Arquivos utilizando a política de backup 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

Você também pode executar o comando anterior usando o nome amigável para o contêiner e o item fornecendo mais dois parâmetros a seguir:

  • --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

O atributo Name na saída corresponde ao nome do trabalho criado pelo serviço de backup para a operação de retomada de proteção. Para acompanhar o status do trabalho, use o cmdlet az backup job show.

Cancelar o registro de uma conta de armazenamento

Se você quiser proteger seus Compartilhamentos de Arquivos em uma conta de armazenamento específica usando um cofre dos Serviços de Recuperação diferente, primeiro pare a proteção para todos os Compartilhamentos de Arquivos nessa conta de armazenamento. Em seguida, cancele o registro da conta do cofre dos Serviços de Recuperação usado no momento para proteção.

Você precisa fornecer um nome de contêiner para cancelar o registro da conta de armazenamento. Para recuperar o nome ou o nome amigável do seu contêiner, use o comando az backup container list.

O exemplo a seguir cancela o registro da conta de armazenamento afsaccount do azurefilesvault usando o cmdlet az backup container unregister.

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

Você também pode executar o cmdlet anterior usando o nome amigável do contêiner fornecendo o seguinte parâmetro:

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

Próximas etapas

Solucionar problemas de backup dos Arquivos do Azure.

  • Last updated on