Compartilhar via

az dataprotection enable-backup

Observação

Essa referência faz parte da extensão dataprotection para o CLI do Azure (versão 2.75.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando az dataprotection enable-backup . Saiba mais sobre extensões.

Habilite o backup para recursos de Azure.

Comandos

Nome Description Tipo Status
az dataprotection enable-backup trigger

Habilite o backup para um cluster do AKS configurando todos os recursos necessários, incluindo cofre de backup, política, conta de armazenamento, extensão e acesso confiável.

 Extensão GA

az dataprotection enable-backup trigger

Habilite o backup para um cluster do AKS configurando todos os recursos necessários, incluindo cofre de backup, política, conta de armazenamento, extensão e acesso confiável.

Esse comando orquestra todas as etapas necessárias para habilitar o backup para um cluster do AKS:

  1. Cria ou reutiliza um grupo de recursos de backup, uma conta de armazenamento e um contêiner de blob
  2. Instala a extensão de backup no cluster (ou reutiliza uma existente)
  3. Cria ou reutiliza um cofre de backup e uma política de backup
  4. Configura atribuições de função e acesso confiável
  5. Cria uma instância de backup

O parâmetro --backup-configuration-file aceita um arquivo JSON (@file.json) ou uma cadeia de caracteres JSON embutida com as seguintes configurações opcionais:

  • storageAccountResourceId: ID do ARM de uma conta de armazenamento existente a ser usada
  • blobContainerName: nome de um contêiner de blob existente (usado com storageAccountResourceId)
  • backupResourceGroupId: ID do ARM de um grupo de recursos existente para recursos de backup
  • backupVaultId: ID do ARM de um cofre de backup existente (necessário para a estratégia personalizada)
  • backupPolicyId: ID do ARM de uma política de backup existente (necessária para a estratégia personalizada)
  • marcas: dicionário de marcas a serem aplicadas aos recursos criados (por exemplo, {"Proprietário": "team", "Env": "prod"})

Predefinições de estratégia de backup (--backup-strategy):

  • Semana (padrão): backups incrementais diários com retenção de 7 dias no Repositório Operacional.
  • Mês: Backups incrementais diários com retenção de 30 dias no Repositório Operacional.
  • DisasterRecovery: backups incrementais diários com repositório operacional de 7 dias + retenção de 90 dias do Vault Store. Os backups do FirstOfDay são copiados para o Vault Store para restauração entre regiões.
  • Personalizado: traga seu próprio cofre e política. Requer backupVaultId e backupPolicyId em --backup-configuration-file.
az dataprotection enable-backup trigger --datasource-id
                                        --datasource-type
                                        [--acquire-policy-token]
                                        [--backup-configuration-file]
                                        [--backup-strategy {Custom, DisasterRecovery, Month, Week}]
                                        [--change-reference]
                                        [--yes]

Exemplos

Habilitar o backup para um cluster do AKS com a estratégia de Semana padrão

az dataprotection enable-backup trigger --datasource-type AzureKubernetesService --datasource-id /subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.ContainerService/managedClusters/{cluster}

Habilitar o backup com a estratégia de mês

az dataprotection enable-backup trigger --datasource-type AzureKubernetesService --datasource-id /subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.ContainerService/managedClusters/{cluster} --backup-strategy Month

Habilitar o backup com a estratégia personalizada usando o cofre e a política existentes

az dataprotection enable-backup trigger --datasource-type AzureKubernetesService \
  --datasource-id /subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.ContainerService/managedClusters/{cluster} \
  --backup-strategy Custom \
  --backup-configuration-file @config.json

Where config.json contains:
{
  "backupVaultId": "/subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.DataProtection/backupVaults/{vault}",
  "backupPolicyId": "/subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.DataProtection/backupVaults/{vault}/backupPolicies/{policy}"
}

Habilitar o backup com marcas de recurso para conformidade de política

az dataprotection enable-backup trigger --datasource-type AzureKubernetesService \
  --datasource-id /subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.ContainerService/managedClusters/{cluster} \
  --backup-configuration-file '{"tags": {"Owner": "team", "Environment": "prod", "DeleteBy": "2026-12"}}'

Habilitar o backup usando uma conta de armazenamento existente

az dataprotection enable-backup trigger --datasource-type AzureKubernetesService \
  --datasource-id /subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.ContainerService/managedClusters/{cluster} \
  --backup-configuration-file @config.json

Where config.json contains:
{
  "storageAccountResourceId": "/subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.Storage/storageAccounts/{sa}",
  "blobContainerName": "my-backup-container"
}

Parâmetros Exigidos

--datasource-id

A ID de recurso do ARM completa da fonte de dados a ser backup.

--datasource-type

O tipo de fonte de dados a ser feito em backup. Valores com suporte: AzureKubernetesService.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--backup-configuration-file -f

Caminho para um arquivo de configuração de backup JSON. Dá suporte a backupVaultId e backupPolicyId (necessário para estratégia personalizada). Para configurações específicas da carga de trabalho, consulte a documentação.

--backup-strategy

Predefinição de estratégia de backup (backups incrementais diários). Para AzureKubernetesService: Semana (retenção de repositório operacional de 7 dias), Mês (retenção de repositório operacional de 30 dias), DisasterRecovery (retenção de repositório de cofre operacional de 7 dias + 90 dias), Personalizado (traga seu próprio cofre/política). Padrão: Semana.

Propriedade Valor
Valores aceitos: Custom, DisasterRecovery, Month, Week
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--yes -y

Não solicite confirmação.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False