Strumenti di Azure MCP Server per Backup di Azure

Quando si usa Azure server MCP, è possibile gestire Backup di Azure risorse tramite richieste in linguaggio naturale usando il protocollo MCP (Model Context Protocol). Backup di Azure supporta due tipi di insieme di credenziali: l'insieme di credenziali di Servizi di ripristino (RSV) e l'insieme di credenziali di Backup, noto anche come Data Protection Platform (DPP). È possibile creare e configurare archivi di backup, definire e aggiornare i criteri di backup e proteggere e ripristinare gli elementi eliminati. È anche possibile gestire impostazioni di governance come l'eliminazione temporanea e l'immutabilità, configurare l'autorizzazione multiutente (MUA) e monitorare i processi di backup e i punti di ripristino.

Backup di Azure offre funzionalità basate sul cloud per le applicazioni. Per altre informazioni, vedere la documentazione Backup di Azure.

Note

Parametri degli strumenti: gli strumenti del server MCP di Azure definiscono i parametri per i dati necessari per completare le attività. Alcuni di questi parametri sono specifici di ogni strumento e sono documentati qui. Altri parametri sono globali e condivisi da tutti gli strumenti. Per altre informazioni, vedere Parametri degli strumenti.

Backup: Ottenere lo stato

Questo strumento controlla lo stato di backup di una risorsa Azure tramite Backup di Azure. Restituisce un valore che indica se la risorsa è protetta, insieme ai dettagli dell'insieme di credenziali e dei criteri associati. Usarlo per verificare se viene eseguito il backup di una macchina virtuale, un disco, un account di archiviazione o un'altra origine dati. Richiede l'ID risorsa Azure Resource Manager per l'origine dati e l'area Azure in cui esiste la risorsa.

Comando CLI di esempio

azmcp azurebackup backup status \
  --datasource-id <datasource-id> \
  --location <location>
Parameter Type Obbligatorio Description
datasource-id string Yes Identificatore dell'origine dati. Per i carichi di lavoro VM/FileShare/DPP, usare l'ID risorsa Resource Manager , ad esempio /subscriptions/.../virtualMachines/myvm. Per i carichi di lavoro guest RSV (SQL/SAPHANA), usare il nome dell'elemento proteggibile da protectableitem list (ad esempio, SAPHanaDatabase;instance;dbname).
location string Yes Area Azure, ad esempio eastus, westus2.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
❌ ✅ ❌ ✅ ❌ ❌

Ripristino di emergenza: abilitare il ripristino tra aree

Questo strumento abilita il ripristino tra aree geografiche (CRR) in un insieme di credenziali di backup con archiviazione con ridondanza geografica abilitata, in modo da poter recuperare i backup da un'area secondaria.

Comando CLI di esempio

azmcp azurebackup disasterrecovery enable-crr \
  --vault <vault> \
  --resource-group <resource-group> \
  [--vault-type <vault-type>]
Parameter Type Obbligatorio Description
vault string Yes Nome dell'insieme di credenziali di backup (insieme di credenziali di Servizi di ripristino o Insieme di credenziali di backup).
resource-group string Yes Nome del gruppo di risorse di Azure.
vault-type string No Il tipo di insieme di credenziali di backup: rsv per un insieme di credenziali di Servizi di ripristino o dpp per un insieme di credenziali di backup (Piattaforma di protezione dei dati). Lo strumento rileva automaticamente il tipo degli insiemi di credenziali esistenti se si omette questo parametro.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
✅ ✅ ❌ ❌ ❌ ❌

Governance: elenco delle risorse senza criterio di backup

Questo strumento analizza la sottoscrizione ed elenca Azure risorse che non sono protette da alcun criterio di Backup di Azure. Usa due percorsi di individuazione: l'enumerazione delle risorse ARM trova le risorse non protette di primo livello e l'individuazione dell'insieme di credenziali di Servizi di ripristino trova le sottorisorse proteggibili che un insieme di credenziali individua ma non protegge ancora. I risultati includono un valore discoverySource (arm o vault) e gli elementi individuati nell'insieme di credenziali includono protectionState, in modo da poter distinguere gli elementi mai protetti da quelli per cui la protezione è stata interrotta.

È possibile filtrare i risultati in base al tipo di risorsa, al gruppo di risorse o ai tag. Il filtro dei tag si applica solo alle risorse rilevate da ARM perché le sottorisorse rilevate dal vault non dispongono di tag ARM. La copertura include macchine virtuali IaaS, SQL nelle macchine virtuali IaaS, SAP HANA nelle macchine virtuali IaaS, Condivisioni file di Azure, Archiviazione BLOB, ADLS Gen2, AKS, Managed Disks, Server flessibile per PostgreSQL, Cosmos DB ed Elastic SAN.

Comando CLI di esempio

azmcp azurebackup governance find-unprotected \
  [--resource-type-filter <resource-type-filter>] \
  [--tag-filter <tag-filter>] \
  [--resource-group <resource-group>]
Parameter Type Obbligatorio Description
resource-type-filter string No Tipi di risorse da filtrare (delimitati da virgole).
tag-filter string No Filtro basato su tag in formato key=value (ad esempio, environment=production).
resource-group string No Nome del gruppo di risorse di Azure.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
❌ ✅ ❌ ✅ ❌ ❌

Governance: configurazione dello stato di immutabilità

Questo strumento configura lo stato di immutabilità per una cassaforte di backup. Impostare lo stato su Disabled, Enabledo Locked. Avviso: Locked è irreversibile.

Comando CLI di esempio

azmcp azurebackup governance immutability \
  --immutability-state <immutability-state> \
  --vault <vault> \
  --resource-group <resource-group> \
  [--vault-type <vault-type>]
Parameter Type Obbligatorio Description
immutability-state string Yes Stato di immutabilità: Disabled, Enabledo Locked (irreversibile).
vault string Yes Nome dell'insieme di credenziali di backup (insieme di credenziali di Servizi di ripristino o Insieme di credenziali di backup).
resource-group string Yes Nome del gruppo di risorse di Azure.
vault-type string No Il tipo di insieme di credenziali di backup: rsv per un insieme di credenziali di Servizi di ripristino o dpp per un insieme di credenziali di backup (Piattaforma di protezione dei dati). Lo strumento rileva automaticamente il tipo degli insiemi di credenziali esistenti se si omette questo parametro.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
✅ ✅ ❌ ❌ ❌ ❌

Governance: Configurazione dell'eliminazione temporanea

Questo strumento configura le impostazioni di eliminazione temporanea per una cassaforte di backup. Impostare lo stato di eliminazione temporanea su AlwaysOn, Ono Off. Facoltativamente, specifica il periodo di conservazione dell'eliminazione temporanea (soft-delete) in giorni (da 14 a 180). Ad esempio, abilita l'eliminazione temporanea On con un periodo di conservazione di 30 giorni per l'insieme di credenziali contosoBackupVault nel gruppo di risorse rg-backup.

Comando CLI di esempio

azmcp azurebackup governance soft-delete \
  --soft-delete <soft-delete> \
  --vault <vault> \
  --resource-group <resource-group> \
  [--soft-delete-retention-days <soft-delete-retention-days>] \
  [--vault-type <vault-type>]
Parameter Type Obbligatorio Description
soft-delete string Yes Stato di eliminazione temporanea: AlwaysOn, Ono Off.
vault string Yes Nome dell'insieme di credenziali di backup (insieme di credenziali di Servizi di ripristino o Insieme di credenziali di backup).
resource-group string Yes Nome del gruppo di risorse di Azure.
soft-delete-retention-days string No Periodo di conservazione dell'eliminazione temporanea (14-180 giorni).
vault-type string No Il tipo di insieme di credenziali di backup: rsv per un insieme di credenziali di Servizi di ripristino o dpp per un insieme di credenziali di backup (Piattaforma di protezione dei dati). Lo strumento rileva automaticamente il tipo degli insiemi di credenziali esistenti se si omette questo parametro.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
✅ ✅ ❌ ❌ ❌ ❌

Processo: ottenere informazioni sul processo di backup

Questo strumento recupera le informazioni sul processo di backup da un archivio protetto. Quando si specifica l'ID processo, lo strumento restituisce informazioni dettagliate su tale processo. Le informazioni includono il tipo di operazione, lo stato, l'ora di inizio e di fine, i codici di errore e i dettagli dell'origine dati. Quando si omette l'ID del processo, lo strumento elenca tutti i processi di backup nell'insieme di credenziali.

Comando CLI di esempio

azmcp azurebackup job get \
  --vault <vault> \
  --resource-group <resource-group> \
  [--job <job>] \
  [--vault-type <vault-type>]
Parameter Type Obbligatorio Description
vault string Yes Nome dell'insieme di credenziali di backup (insieme di credenziali di Servizi di ripristino o Insieme di credenziali di backup).
resource-group string Yes Nome del gruppo di risorse di Azure.
job string No L'ID del processo di backup.
vault-type string No Il tipo di insieme di credenziali di backup: rsv per un insieme di credenziali di Servizi di ripristino o dpp per un insieme di credenziali di backup (Piattaforma di protezione dei dati). Lo strumento rileva automaticamente il tipo degli insiemi di credenziali esistenti se si omette questo parametro.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
❌ ✅ ❌ ✅ ❌ ❌

Criteri: Creare criteri di backup

Questo strumento crea criteri di backup per il tipo di carico di lavoro specificato e consente di impostare regole di pianificazione e conservazione.

Comando CLI di esempio

azmcp azurebackup policy create \
  --policy <policy> \
  --workload-type <workload-type> \
  --vault <vault> \
  --resource-group <resource-group> \
  [--daily-retention-days <daily-retention-days>] \
  [--time-zone <time-zone>] \
  [--schedule-frequency <schedule-frequency>] \
  [--schedule-times <schedule-times>] \
  [--schedule-days-of-week <schedule-days-of-week>] \
  [--hourly-interval-hours <hourly-interval-hours>] \
  [--hourly-window-start-time <hourly-window-start-time>] \
  [--hourly-window-duration-hours <hourly-window-duration-hours>] \
  [--weekly-retention-weeks <weekly-retention-weeks>] \
  [--weekly-retention-days-of-week <weekly-retention-days-of-week>] \
  [--monthly-retention-months <monthly-retention-months>] \
  [--monthly-retention-week-of-month <monthly-retention-week-of-month>] \
  [--monthly-retention-days-of-week <monthly-retention-days-of-week>] \
  [--monthly-retention-days-of-month <monthly-retention-days-of-month>] \
  [--yearly-retention-years <yearly-retention-years>] \
  [--yearly-retention-months <yearly-retention-months>] \
  [--yearly-retention-week-of-month <yearly-retention-week-of-month>] \
  [--yearly-retention-days-of-week <yearly-retention-days-of-week>] \
  [--yearly-retention-days-of-month <yearly-retention-days-of-month>] \
  [--archive-tier-after-days <archive-tier-after-days>] \
  [--archive-tier-mode <archive-tier-mode>] \
  [--policy-sub-type <policy-sub-type>] \
  [--instant-rp-retention-days <instant-rp-retention-days>] \
  [--instant-rp-resource-group <instant-rp-resource-group>] \
  [--snapshot-consistency <snapshot-consistency>] \
  [--full-schedule-frequency <full-schedule-frequency>] \
  [--full-schedule-days-of-week <full-schedule-days-of-week>] \
  [--differential-schedule-days-of-week <differential-schedule-days-of-week>] \
  [--differential-retention-days <differential-retention-days>] \
  [--incremental-schedule-days-of-week <incremental-schedule-days-of-week>] \
  [--incremental-retention-days <incremental-retention-days>] \
  [--log-frequency-minutes <log-frequency-minutes>] \
  [--log-retention-days <log-retention-days>] \
  [--is-compression <is-compression>] \
  [--is-sql-compression <is-sql-compression>] \
  [--smart-tier <smart-tier>] \
  [--enable-snapshot-backup <enable-snapshot-backup>] \
  [--snapshot-instant-rp-retention-days <snapshot-instant-rp-retention-days>] \
  [--snapshot-instant-rp-resource-group <snapshot-instant-rp-resource-group>] \
  [--enable-vault-tier-copy <enable-vault-tier-copy>] \
  [--vault-tier-copy-after-days <vault-tier-copy-after-days>] \
  [--backup-mode <backup-mode>] \
  [--pitr-retention-days <pitr-retention-days>] \
  [--policy-tags <policy-tags>] \
  [--vault-type <vault-type>]
Parameter Type Obbligatorio Description
policy string Yes Il nome della policy di backup.
workload-type string Yes Tipo di carico di lavoro: VM, SQL, SAPHANA, SAPASE, AzureFileShare (tipi RSV); AzureDisk, AzureBlob, AKS, ElasticSAN, PostgreSQLFlexible, ADLS, CosmosDB (tipi DPP). Accetta anche alias come AzureVM e SQLDatabase.
vault string Yes Nome dell'insieme di credenziali di backup (insieme di credenziali di Servizi di ripristino o Insieme di credenziali di backup).
resource-group string Yes Nome del gruppo di risorse di Azure.
daily-retention-days string No Conservazione giornaliera dei punti di ripristino in giorni. Il valore predefinito è quello specifico dell'origine dati se non ne specifichi uno.
time-zone string No Identificatore del fuso orario di Windows per la pianificazione del backup (ad esempio, UTC, Pacific Standard Time, India Standard Time). Se viene omesso, la pianificazione viene eseguita in UTC.
schedule-frequency string No Frequenza di pianificazione del backup. Gli insiemi di credenziali RSV accettano Daily, Weeklyo Hourly. I vault DPP (Backup) accettano intervalli ISO 8601: PT4H, PT6H, PT8H, PT12H, P1D, P1W, P2W, o P1M.
schedule-times string No Elenco delimitato da virgole dei tempi di backup in formato HH:mm 24h (ad esempio, 02:00 o 02:00,14:00). Interpretato con --time-zone. L'impostazione predefinita è 02:00 UTC se non si specifica un valore. Solo la prima volta vale come orario di inizio della pianificazione.
schedule-days-of-week string No Giorni della settimana, separati da virgole, in cui deve essere eseguito il backup (ad esempio, Monday,Wednesday,Friday). Obbligatorio per le pianificazioni Weekly.
hourly-interval-hours string No Intervallo di ore tra i backup orari. Valori validi: 4, 6, 8, 12. Si applica solo quando --schedule-frequency è Hourly (RSV).
hourly-window-start-time string No Ora di inizio della finestra di backup oraria in formato HH:mm 24h (ad esempio, 08:00). Si applica solo quando --schedule-frequency è Hourly (RSV).
hourly-window-duration-hours string No Durata dell'intervallo di backup orario espresso in ore (ad esempio, 12). Si applica solo quando --schedule-frequency è Hourly (RSV).
weekly-retention-weeks string No Numero di settimane per mantenere i punti di ripristino settimanali. Obbligatorio insieme a --weekly-retention-days-of-week.
weekly-retention-days-of-week string No Giorni delimitati da virgole della settimana contrassegnati per la conservazione settimanale (ad esempio, Sunday o Saturday,Sunday). Obbligatorio insieme a --weekly-retention-weeks.
monthly-retention-months string No Numero di mesi per mantenere i punti di ripristino mensili. Combinare --monthly-retention-days-of-month con (assoluto) OR --monthly-retention-week-of-month + --monthly-retention-days-of-week (relativo).
monthly-retention-week-of-month string No Settimana del mese da contrassegnare per la conservazione mensile: First, Second, ThirdFourth, o Last. Da usare con --monthly-retention-days-of-week (schema relativo).
monthly-retention-days-of-week string No Giorni della settimana separati da virgole per il tag di conservazione mensile (ad esempio, Sunday). Da usare con --monthly-retention-week-of-month (schema relativo).
monthly-retention-days-of-month string No Giorni delimitati da virgole del mese per la conservazione mensile (da 1 a 28 o Last; ad esempio, 1,15,Last). Schema assoluto; mutuamente esclusivo con --monthly-retention-week-of-month.
yearly-retention-years string No Numero di anni per mantenere i punti di recupero annuali. Combinare con --yearly-retention-months e --yearly-retention-days-of-month (assoluto) OR --yearly-retention-week-of-month + --yearly-retention-days-of-week (relativo).
yearly-retention-months string No Mesi delimitati da virgole contrassegnati per la conservazione annuale ,ad esempio January o January,July.
yearly-retention-week-of-month string No Settimana del mese o dei mesi selezionati da contrassegnare per la conservazione annuale: First, Second, Third, Fourtho Last. Da usare con --yearly-retention-days-of-week (schema relativo).
yearly-retention-days-of-week string No Giorni della settimana separati da virgole per il tag di conservazione annuale, ad esempio Sunday. Da usare con --yearly-retention-week-of-month (schema relativo).
yearly-retention-days-of-month string No Giorni delimitati da virgole del mese o dei mesi selezionati per la conservazione annuale (da 1 a 28 o Last, ad esempio ). 1,Last Schema assoluto; mutuamente esclusivo con --yearly-retention-week-of-month.
archive-tier-after-days string No Sposta i punti di ripristino al livello di archiviazione dopo questo numero di giorni. Associare con --archive-tier-mode.
archive-tier-mode string No Modalità di archiviazione a livelli: TierAfter (sempre a livelli dopo --archive-tier-after-days) o CopyOnExpiry (copia nell'archivio alla scadenza del punto di ripristino). Usare --smart-tier per la suddivisione in livelli consigliata dal servizio.
policy-sub-type string No Sottotipo del criterio VM RSV: Standard o Enhanced. Enhanced è necessario per le pianificazioni su base oraria e per le macchine virtuali Trusted Launch. Solo per VM RSV.
instant-rp-retention-days string No Periodo di conservazione dei punti di ripristino istantanei in giorni (da 1 a 30 per Standard, da 1 a 7 per Migliorato). Solo per VM RSV.
instant-rp-resource-group string No Gruppo di risorse che ospita gli snapshot dei punti di ripristino istantanei. Solo per VM RSV.
snapshot-consistency string No Modalità di coerenza dello snapshot per i backup delle VM: ApplicationConsistent o CrashConsistent. Solo per VM RSV.
full-schedule-frequency string No Frequenza di pianificazione del backup completo per SQL/SAPHANA/SAPASE: Daily o Weekly. Solo per RSV VmWorkload.
full-schedule-days-of-week string No Giorni delimitati da virgole della settimana per il backup completo (ad esempio, Sunday). Obbligatorio quando --full-schedule-frequency è Weekly. Solo per RSV VmWorkload.
differential-schedule-days-of-week string No Giorni della settimana separati da virgole per il backup differenziale (ad esempio, Monday,Thursday). Solo per RSV VmWorkload.
differential-retention-days string No Periodo di conservazione in giorni per i backup differenziali. Solo per RSV VmWorkload.
incremental-schedule-days-of-week string No Giorni della settimana separati da virgole per il backup incrementale. RSV SAPHANA / SAPASE solo.
incremental-retention-days string No Periodo di conservazione in giorni per i backup incrementali. RSV SAPHANA / SAPASE solo.
log-frequency-minutes string No Frequenza di backup del log delle transazioni in minuti ( ad esempio , 1530, 60). Solo per RSV VmWorkload.
log-retention-days string No Periodo di conservazione in giorni per i backup del log delle transazioni. Solo per RSV VmWorkload.
is-compression string No Abilita la compressione dei backup a livello di policy. Solo per RSV VmWorkload.
is-sql-compression string No Abilitare SQL Server nella compressione del backup nativo della macchina virtuale. Soltanto RSV SQL.
smart-tier string No Abilitare la suddivisione in livelli intelligenti (raccomandazione per l'archiviazione basata su Machine Learning). Solo per VM RSV. Equivalente a TieringMode=TierRecommended. Rimane separato da --archive-tier-mode perché genera una struttura di livelli strutturalmente diversa (Duration=0, DurationType=Invalid).
enable-snapshot-backup string No Abilitare i backup di snapshot/istanze (punti di ripristino dello snapshot della replica di sistema HANA). Solo RSV SAPHANA.
snapshot-instant-rp-retention-days string No Intervallo di conservazione dei punti di ripristino istantaneo in giorni. RSV SAPHANA solo snapshot.
snapshot-instant-rp-resource-group string No Prefisso del gruppo di risorse per i punti di ripristino istantaneo dello snapshot. RSV SAPHANA solo snapshot.
enable-vault-tier-copy string No Abilitare la copia dei backup dell'archivio operativo nel livello vault. Solo per DPP AzureDisk.
vault-tier-copy-after-days string No Numero di giorni dopo i quali un backup operativo viene copiato nel livello vault. Solo per DPP AzureDisk.
backup-mode string No Modalità di backup per i carichi di lavoro di archiviazione: Continuous (impostazione predefinita per AzureBlob, ADLS) o Vaulted (punti di ripristino discreti). DPP AzureBlob, AzureDataLakeStorage.
pitr-retention-days string No Conservazione in giorni del ripristino point-in-time per i backup continui. DPP AzureBlob, AzureDataLakeStorage.
policy-tags string No Tag di risorsa applicati ai criteri di backup RSV come k1=v1,k2=v2. Solo RSV.
vault-type string No Il tipo di insieme di credenziali di backup: rsv per un insieme di credenziali di Servizi di ripristino o dpp per un insieme di credenziali di backup (Piattaforma di protezione dei dati). Lo strumento rileva automaticamente il tipo degli archivi esistenti quando si omette questo parametro.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
✅ ❌ ❌ ❌ ❌ ❌

Criterio: Ottieni criterio

Questo strumento recupera informazioni sui criteri di backup. Lo strumento fornisce informazioni dettagliate per un singolo criterio quando si specifica il policy parametro . Quando si omette il parametro policy, lo strumento elenca tutti i criteri di backup configurati nell'insieme di credenziali.

Comando CLI di esempio

azmcp azurebackup policy get \
  --vault <vault> \
  --resource-group <resource-group> \
  [--policy <policy>] \
  [--vault-type <vault-type>]
Parameter Type Obbligatorio Description
vault string Yes Nome dell'insieme di credenziali di backup (insieme di credenziali di Servizi di ripristino o Insieme di credenziali di backup).
resource-group string Yes Nome del gruppo di risorse di Azure.
policy string No Il nome della policy di backup.
vault-type string No Il tipo di insieme di credenziali di backup: rsv per un insieme di credenziali di Servizi di ripristino o dpp per un insieme di credenziali di backup (Piattaforma di protezione dei dati). Lo strumento rileva automaticamente il tipo dei vault esistenti quando si omette questo parametro.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
❌ ✅ ❌ ✅ ❌ ❌

Criterio: Aggiornare i criteri

Questo strumento modifica un criterio di backup dell'insieme di credenziali di Servizi di ripristino esistente. È possibile aggiornare i tempi di pianificazione del backup e i giorni di conservazione giornalieri per i criteri del carico di lavoro vm, SQL, SAP HANA e condivisione file. Il criterio indicato deve già esistere nell'insieme di credenziali.

Comando CLI di esempio

azmcp azurebackup policy update \
  --policy <policy> \
  --vault <vault> \
  --resource-group <resource-group> \
  [--schedule-time <schedule-time>] \
  [--daily-retention-days <daily-retention-days>] \
  [--vault-type <vault-type>]
Parameter Type Obbligatorio Description
policy string Yes Il nome della policy di backup.
vault string Yes Nome dell'insieme di credenziali di backup (insieme di credenziali di Servizi di ripristino o Insieme di credenziali di backup).
resource-group string Yes Nome del gruppo di risorse di Azure.
schedule-time string No Tempo di backup in HH:mm formato 24 ore (ad esempio, 02:00), interpretato nel fuso orario del criterio.
daily-retention-days string No Conservazione giornaliera dei punti di ripristino in giorni. Il valore predefinito è quello specifico dell'origine dati se non ne specifichi uno.
vault-type string No Il tipo di archivio di backup. È supportato solo rsv per l'aggiornamento dei criteri. Lo strumento rileva automaticamente il tipo quando si omette questo parametro. L'aggiornamento dei criteri non è supportato per i criteri di dpp (Backup vault).

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
✅ ✅ ❌ ❌ ❌ ❌

Elemento proteggibile: elencare gli elementi che possono essere protetti

Questo strumento elenca gli elementi di cui è possibile effettuare il backup (elementi proteggibili) in un insieme di credenziali di Servizi di ripristino. Gli esempi includono i database SQL e i database SAP HANA individuati dallo strumento nelle macchine virtuali registrate. Usare lo strumento per trovare database e carichi di lavoro disponibili per la protezione dei backup. Questo strumento supporta solo gli insiemi di credenziali di Servizi di ripristino. Le origini dati di Data Protection Platform usano gli ID risorsa di Resource Manager per la protezione. Filtrare i risultati in base al tipo di carico di lavoro, ad esempio SQL o SAP HANA o per contenitore.

Comando CLI di esempio

azmcp azurebackup protectableitem list \
  --vault <vault> \
  --resource-group <resource-group> \
  [--workload-type <workload-type>] \
  [--container <container>] \
  [--vault-type <vault-type>]
Parameter Type Obbligatorio Description
vault string Yes Nome dell'insieme di credenziali di backup (insieme di credenziali di Servizi di ripristino o Insieme di credenziali di backup).
resource-group string Yes Nome del gruppo di risorse di Azure.
workload-type string No Tipo di carico di lavoro: VM, SQL, SAPHANA, SAPASE, AzureFileShare (tipi RSV); AzureDisk, AzureBlob, AKS, ElasticSAN, PostgreSQLFlexible, ADLS, CosmosDB (tipi DPP). Accetta anche alias come AzureVM e SQLDatabase.
container string No Nome del contenitore di protezione RSV. Si applica solo agli insiemi di credenziali di Servizi di ripristino.
vault-type string No Il tipo di insieme di credenziali di backup: rsv per un insieme di credenziali di Servizi di ripristino o dpp per un insieme di credenziali di backup (Piattaforma di protezione dei dati). Lo strumento rileva automaticamente il tipo dei vault esistenti se si omette questo parametro.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
❌ ✅ ❌ ✅ ❌ ❌

Elemento protetto: Ottenere informazioni

Recupera informazioni sugli elementi protetti da un insieme di credenziali di backup.

Questo strumento restituisce informazioni dettagliate su una singola istanza di backup quando si specifica l'elemento protetto. I dettagli includono lo stato di protezione, le informazioni sull'origine dati, l'assegnazione dei criteri e l'ora dell'ultimo backup. Specifica il contenitore per gli elementi dell'insieme di credenziali di Servizi di ripristino. Se si omette l'elemento protetto, lo strumento elenca tutti gli elementi protetti (istanze di backup) nell'insieme di credenziali.

Comando CLI di esempio

azmcp azurebackup protecteditem get \
  --vault <vault> \
  --resource-group <resource-group> \
  [--protected-item <protected-item>] \
  [--container <container>] \
  [--vault-type <vault-type>]
Parameter Type Obbligatorio Description
vault string Yes Nome dell'insieme di credenziali di backup (insieme di credenziali di Servizi di ripristino o Insieme di credenziali di backup).
resource-group string Yes Nome del gruppo di risorse di Azure.
protected-item string No Nome dell'elemento protetto o dell'istanza di backup.
container string No Nome del contenitore di protezione RSV. Si applica solo agli insiemi di credenziali di Servizi di ripristino.
vault-type string No Il tipo di insieme di credenziali di backup: rsv per un insieme di credenziali di Servizi di ripristino o dpp per un insieme di credenziali di backup (Piattaforma di protezione dei dati). Lo strumento rileva automaticamente il tipo degli insiemi di credenziali esistenti se si omette questo parametro.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
❌ ✅ ❌ ✅ ❌ ❌

Elemento protetto: configurare la protezione di backup

Configurare la protezione di backup per una risorsa Azure creando un elemento protetto o un'istanza di backup. Questo strumento protegge macchine virtuali, dischi, condivisioni file, database SQL, database SAP HANA e altre origini dati supportate. Per le VM, fornire l'ID risorsa di Resource Manager della VM come Datasource ID. Per i carichi di lavoro SQL e SAP HANA, specificare il nome dell'elemento proteggibile come Datasource ID (ad esempio, SAPHanaDatabase;instance;dbname) e specificare .Container name Specificare i criteri di backup con il Policy parametro . L'operazione viene eseguita in modo asincrono, quindi monitorare il processo di protezione fino al termine.

Comando CLI di esempio

azmcp azurebackup protecteditem protect \
  --policy <policy> \
  --datasource-id <datasource-id> \
  --vault <vault> \
  --resource-group <resource-group> \
  [--datasource-type <datasource-type>] \
  [--aks-snapshot-resource-group <aks-snapshot-resource-group>] \
  [--aks-included-namespaces <aks-included-namespaces>] \
  [--aks-excluded-namespaces <aks-excluded-namespaces>] \
  [--aks-label-selectors <aks-label-selectors>] \
  [--aks-include-cluster-scope-resources <aks-include-cluster-scope-resources>] \
  [--protected-item <protected-item>] \
  [--container <container>] \
  [--vault-type <vault-type>]
Parameter Type Obbligatorio Description
policy string Yes Il nome della policy di backup.
datasource-id string Yes Identificatore dell'origine dati. Per i carichi di lavoro VM/FileShare/DPP, usare l'ID risorsa Resource Manager , ad esempio /subscriptions/.../virtualMachines/myvm. Per i carichi di lavoro RSV in esecuzione nel guest (SQL/SAPHANA), utilizzare il nome dell'elemento proteggibile indicato in protectableitem list (ad esempio, SAPHanaDatabase;instance;dbname).
vault string Yes Nome dell'insieme di credenziali di backup (insieme di credenziali di Servizi di ripristino o Insieme di credenziali di backup).
resource-group string Yes Nome del gruppo di risorse di Azure.
datasource-type string No Hint per il tipo di carico di lavoro: VM, SQL, SAPHANA, SAPASE, AzureFileShare (tipi RSV); AzureDisk, AzureBlob, AKS, ElasticSAN, PostgreSQLFlexible, ADLS, CosmosDB (tipi DPP). Accetta anche alias come AzureVM e SQLDatabase.
aks-snapshot-resource-group string No Gruppo di risorse che archivia gli snapshot dei volumi AKS creati dal servizio Backup. Solo servizio Azure Kubernetes DPP.
aks-included-namespaces string No Elenco di namespace separati da virgole da includere nell'ambito predefinito del criterio di backup AKS. Solo servizio Azure Kubernetes DPP.
aks-excluded-namespaces string No Elenco di namespace separati da virgole da escludere dall'ambito predefinito del criterio di backup di AKS. Solo servizio Azure Kubernetes DPP.
aks-label-selectors string No Selettori di etichette delimitati da virgole (ad esempio, app=frontend,tier=web) che si applicano all'ambito predefinito dei criteri di backup di AKS. Solo servizio Azure Kubernetes DPP.
aks-include-cluster-scope-resources string No Includi le risorse a livello di cluster nel criterio di backup di AKS. Solo servizio Azure Kubernetes DPP.
protected-item string No Nome dell'elemento protetto o dell'istanza di backup.
container string No Nome del contenitore di protezione RSV. Si applica solo agli insiemi di credenziali di Servizi di ripristino.
vault-type string No Il tipo di insieme di credenziali di backup: rsv per un insieme di credenziali di Servizi di ripristino o dpp per un insieme di credenziali di backup (Piattaforma di protezione dei dati). Lo strumento rileva automaticamente il tipo degli insiemi di credenziali esistenti se si omette questo parametro.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
✅ ❌ ❌ ❌ ❌ ❌

Elemento protetto: ripristino dell'elemento eliminato temporaneamente

Questo strumento riporta un elemento di backup eliminato temporaneamente a uno stato di protezione attivo. Consente di ripristinare backup o elementi protetti eliminati accidentalmente. Per gli insiemi di credenziali di Servizi di ripristino e gli insiemi di credenziali di Backup, specificare l'origine dati Resource Manager ID risorsa con il datasource-id parametro . Facoltativamente, è possibile specificare il parametro container per gli elementi del carico di lavoro dell'insieme di credenziali di Servizi di ripristino, come SQL o SAP HANA. L'operazione viene eseguita in modo asincrono e si monitora lo stato di avanzamento con azurebackup job get.

Comando CLI di esempio

azmcp azurebackup protecteditem undelete \
  --datasource-id <datasource-id> \
  --vault <vault> \
  --resource-group <resource-group> \
  [--container <container>] \
  [--vault-type <vault-type>]
Parameter Type Obbligatorio Description
datasource-id string Yes Identificatore dell'origine dati. Per i carichi di lavoro VM/FileShare/DPP, usare l'ID risorsa Resource Manager , ad esempio /subscriptions/.../virtualMachines/myvm. Per i carichi di lavoro guest RSV (SQL/SAPHANA), usare il nome dell'elemento proteggibile da protectableitem list (ad esempio, SAPHanaDatabase;instance;dbname).
vault string Yes Nome dell'insieme di credenziali di backup (insieme di credenziali di Servizi di ripristino o Insieme di credenziali di backup).
resource-group string Yes Nome del gruppo di risorse di Azure.
container string No Nome del contenitore di protezione RSV. Si applica solo agli insiemi di credenziali di Servizi di ripristino.
vault-type string No Il tipo di insieme di credenziali di backup: rsv per un insieme di credenziali di Servizi di ripristino o dpp per un insieme di credenziali di backup (Piattaforma di protezione dei dati). Lo strumento rileva automaticamente il tipo degli insiemi di credenziali esistenti quando si omette questo parametro.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
✅ ✅ ❌ ❌ ❌ ❌

Punto di ripristino: ottenere informazioni sul punto di ripristino

Questo strumento recupera le informazioni sul punto di ripristino per un elemento protetto. Quando si specifica il punto di ripristino, lo strumento restituisce informazioni dettagliate sul punto di ripristino, incluso il tempo e il tipo. Quando si omette il punto di ripristino, lo strumento elenca tutti i punti di ripristino disponibili per l'elemento protetto.

Comando CLI di esempio

azmcp azurebackup recoverypoint get \
  --protected-item <protected-item> \
  --vault <vault> \
  --resource-group <resource-group> \
  [--container <container>] \
  [--recovery-point <recovery-point>] \
  [--vault-type <vault-type>]
Parameter Type Obbligatorio Description
protected-item string Yes Nome dell'elemento protetto o dell'istanza di backup.
vault string Yes Nome dell'insieme di credenziali di backup (insieme di credenziali di Servizi di ripristino o Insieme di credenziali di backup).
resource-group string Yes Nome del gruppo di risorse di Azure.
container string No Nome del contenitore di protezione RSV. Si applica solo agli insiemi di credenziali di Servizi di ripristino.
recovery-point string No ID del punto di ripristino.
vault-type string No Il tipo di insieme di credenziali di backup: rsv per un insieme di credenziali di Servizi di ripristino o dpp per un insieme di credenziali di backup (Piattaforma di protezione dei dati). Lo strumento rileva automaticamente il tipo degli insiemi di credenziali esistenti se si omette questo parametro.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
❌ ✅ ❌ ✅ ❌ ❌

Sicurezza: configurare la crittografia

Questo strumento configura la crittografia con chiavi gestite dal cliente (CMK) in un archivio di backup utilizzando una chiave di Azure Key Vault. Supporta sia gli insiemi di credenziali di Servizi di ripristino sia gli insiemi di credenziali di Backup (DPP). L'identità gestita del vault deve disporre del ruolo Utente della crittografia del servizio Crittografia di Key Vault nel Key Vault. Usare identity-type per specificare SystemAssigned o UserAssigned identità. Specificare user-assigned-identity-id quando si usa un'identità assegnata dall'utente.

Comando CLI di esempio

azmcp azurebackup security configure-encryption \
  --key-vault-uri <key-vault-uri> \
  --key-name <key-name> \
  --identity-type <identity-type> \
  --vault <vault> \
  --resource-group <resource-group> \
  [--key-version <key-version>] \
  [--user-assigned-identity-id <user-assigned-identity-id>] \
  [--vault-type <vault-type>]
Parameter Type Obbligatorio Description
key-vault-uri string Yes Key Vault URI (ad esempio, https://kv-security-prod.vault.azure.net/).
key-name string Yes Nome della chiave di crittografia nel Key Vault.
identity-type string Yes Tipo di identità gestita: SystemAssigned, UserAssigned, SystemAssigned,UserAssignedo None.
vault string Yes Nome dell'insieme di credenziali di backup (insieme di credenziali di Servizi di ripristino o Insieme di credenziali di backup).
resource-group string Yes Nome del gruppo di risorse di Azure.
key-version string No Versione specifica della chiave. Non specificare per utilizzare sempre la versione più recente.
user-assigned-identity-id string No ID risorsa di Resource Manager dell'identità gestita assegnata dall'utente per l'accesso a Key Vault. Obbligatorio quando --identity-type è UserAssigned.
vault-type string No Il tipo di insieme di credenziali di backup: rsv per un insieme di credenziali di Servizi di ripristino o dpp per un insieme di credenziali di backup (Piattaforma di protezione dei dati). Lo strumento rileva automaticamente il tipo degli insiemi di credenziali esistenti quando si omette questo parametro.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
✅ ✅ ❌ ❌ ❌ ❌

Sicurezza: configurare l'autorizzazione multiutente

Questo strumento configura MUA su un deposito di backup tramite il collegamento o lo scollegamento di un'istanza di Resource Guard. Fornire un ID di Resource Guard per abilitare MUA, che protegge le operazioni critiche, ad esempio la disabilitazione dell'eliminazione temporanea, la rimozione dell'immutabilità e l'interruzione della protezione. Queste operazioni richiedono l'approvazione da parte di un amministratore della sicurezza con autorizzazioni per l'istanza di Resource Guard. Omettere l'ID di Resource Guard per disabilitare MUA. La disabilitazione di MUA è un'operazione protetta che richiede il ruolo Operatore MUA di backup nell'istanza di Resource Guard.

Comando CLI di esempio

azmcp azurebackup security configure-mua \
  --vault <vault> \
  --resource-group <resource-group> \
  [--resource-guard-id <resource-guard-id>] \
  [--vault-type <vault-type>]
Parameter Type Obbligatorio Description
vault string Yes Nome dell'insieme di credenziali di backup (insieme di credenziali di Servizi di ripristino o Insieme di credenziali di backup).
resource-group string Yes Nome del gruppo di risorse di Azure.
resource-guard-id string No ID risorsa ARM del Resource Guard da collegare per l'autorizzazione per più utenti (ad esempio, /subscriptions/.../resourceGroups/.../providers/Microsoft.DataProtection/resourceGuards/myGuard).
vault-type string No Il tipo di insieme di credenziali di backup: rsv per un insieme di credenziali di Servizi di ripristino o dpp per un insieme di credenziali di backup (Piattaforma di protezione dei dati). Lo strumento rileva automaticamente il tipo degli archivi esistenti se si omette questo parametro.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
✅ ✅ ❌ ❌ ❌ ❌

Cassaforte: creare una cassaforte di backup

Questo strumento crea un nuovo archivio di backup. Specificare il tipo di insieme di credenziali come rsv per un insieme di credenziali di Servizi di ripristino o dpp per un insieme di credenziali di backup (Piattaforma protezione dati). Per gli dpp insiemi di credenziali, lo strumento abilita per impostazione predefinita un'identità gestita assegnata dal sistema. L'insieme di credenziali si autentica con origini dati protette, ad esempio account di archiviazione, dischi e server flessibili di PostgreSQL. È possibile modificare il tipo di identità in un secondo momento. Per usare ReadAccessGeoZoneRedundant, creare l'insieme di credenziali con un tipo di ridondanza supportato e quindi aggiornarlo. Dopo la creazione, lo strumento fornisce i dettagli del vault.

Comando CLI di esempio

azmcp azurebackup vault create \
  --location <location> \
  --vault <vault> \
  --resource-group <resource-group> \
  [--sku <sku>] \
  [--storage-type <storage-type>] \
  [--vault-type <vault-type>]
Parameter Type Obbligatorio Description
location string Yes Area Azure, ad esempio eastus, westus2.
vault string Yes Nome dell'insieme di credenziali di backup (insieme di credenziali di Servizi di ripristino o Insieme di credenziali di backup).
resource-group string Yes Nome del gruppo di risorse di Azure.
sku string No Lo SKU dell'insieme di credenziali. Per gli insiemi di credenziali di Servizi di ripristino, i valori accettati sono Standard e RS0.
storage-type string No Ridondanza dell'archiviazione: GeoRedundant, LocallyRedundanto ZoneRedundant.
vault-type string No Il tipo di insieme di credenziali di backup: rsv per un insieme di credenziali di Servizi di ripristino o dpp per un insieme di credenziali di backup (Piattaforma di protezione dei dati). Lo strumento rileva automaticamente il tipo degli insiemi di credenziali esistenti se si omette questo parametro.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
✅ ❌ ❌ ❌ ❌ ❌

Archivio: ottenere l'archivio di backup

Questo strumento recupera le informazioni del vault di backup. Quando si specifica un insieme di credenziali e un gruppo di risorse, lo strumento restituisce informazioni dettagliate su tale insieme di credenziali, tra cui tipo di insieme di credenziali, posizione, SKU e ridondanza dell'archiviazione. Se si omettono questi parametri, lo strumento elenca tutti gli insiemi di credenziali di backup nella sottoscrizione, inclusi gli insiemi di credenziali di Recovery Services e i Backup vaults (Data Protection Platform). Per restringere l'elenco, filtra i risultati per tipo di insieme di credenziali rsv o dpp, oppure per gruppo di risorse. Usare il parametro --expand per includere nella risposta campi aggiuntivi relativi allo stato dell'insieme di credenziali, ad esempio l'URI della chiave di crittografia, lo stato del ripristino tra aree geografiche e il collegamento a Resource Guard per l'autorizzazione multiutente (MUA).

Comando CLI di esempio

azmcp azurebackup vault get \
  [--vault <vault>] \
  [--vault-type <vault-type>] \
  [--resource-group <resource-group>] \
  [--expand <expand>]
Parameter Type Obbligatorio Description
vault string No Nome dell'insieme di credenziali di backup (insieme di credenziali di Servizi di ripristino o Insieme di credenziali di backup).
vault-type string No Il tipo di insieme di credenziali di backup: rsv per un insieme di credenziali di Servizi di ripristino o dpp per un insieme di credenziali di backup (Piattaforma di protezione dei dati). Lo strumento rileva automaticamente il tipo degli insiemi di credenziali esistenti se si omette questo parametro.
resource-group string No Nome del gruppo di risorse di Azure.
expand string No Elenco separato da virgole di campi di postura aggiuntivi del vault da includere: security, mua o all.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
❌ ✅ ❌ ✅ ❌ ❌

Cassaforte: Aggiorna le impostazioni della cassaforte

Questo strumento aggiorna le impostazioni a livello di insieme di credenziali per un insieme di credenziali di Servizi di ripristino o un insieme di credenziali di Backup. È possibile modificare la ridondanza dell'archiviazione, abilitare o disabilitare l'eliminazione temporanea, configurare l'immutabilità e impostare il tipo di identità gestita.

Comando CLI di esempio

azmcp azurebackup vault update \
  --vault <vault> \
  --resource-group <resource-group> \
  [--redundancy <redundancy>] \
  [--soft-delete <soft-delete>] \
  [--soft-delete-retention-days <soft-delete-retention-days>] \
  [--immutability-state <immutability-state>] \
  [--identity-type <identity-type>] \
  [--tags <tags>] \
  [--vault-type <vault-type>]
Parameter Type Obbligatorio Description
vault string Yes Nome dell'insieme di credenziali di backup (insieme di credenziali di Servizi di ripristino o Insieme di credenziali di backup).
resource-group string Yes Nome del gruppo di risorse di Azure.
redundancy string No Ridondanza dell'archiviazione: GeoRedundant, LocallyRedundant, ZoneRedundanto ReadAccessGeoZoneRedundant.
soft-delete string No Stato di eliminazione temporanea: AlwaysOn, Ono Off.
soft-delete-retention-days string No Periodo di conservazione dell'eliminazione temporanea (14-180 giorni).
immutability-state string No Stato di immutabilità: Disabled, Enabledo Locked (irreversibile).
identity-type string No Tipo di identità gestita: SystemAssigned, UserAssigned, SystemAssigned,UserAssignedo None.
tags string No Tag di risorsa come oggetto chiave-valore JSON.
vault-type string No Il tipo di insieme di credenziali di backup: rsv per un insieme di credenziali di Servizi di ripristino o dpp per un insieme di credenziali di backup (Piattaforma di protezione dei dati). Lo strumento rileva automaticamente il tipo degli insiemi di credenziali esistenti se si omette questo parametro.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
✅ ✅ ❌ ❌ ❌ ❌