Backups - Trigger

Riferimento

Servizio:: Recovery Services - Backup

Versione API:: 2024-10-01

Attiva il backup per l'elemento di backup specificato. Si tratta di un'operazione asincrona. Per conoscere lo stato dell'operazione, chiamare l'API GetProtectedItemOperationResult.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}/backup?api-version=2024-10-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
containerName	path	True	string	Nome del contenitore associato all'elemento di backup.
fabricName	path	True	string	Nome dell'infrastruttura associato all'elemento di backup.
protectedItemName	path	True	string	Elemento di backup per il quale deve essere attivato il backup.
resourceGroupName	path	True	string	Nome del gruppo di risorse in cui è presente l'insieme di credenziali dei servizi di ripristino.
subscriptionId	path	True	string	ID sottoscrizione.
vaultName	path	True	string	Nome dell'insieme di credenziali di Servizi di ripristino.
api-version	query	True	string	Versione dell'API client.

Corpo della richiesta

Nome	Tipo	Descrizione
eTag	string	ETag facoltativo.
location	string	Percorso della risorsa.
properties	BackupRequest: AzureFileShareBackupRequest AzureWorkloadBackupRequest IaasVMBackupRequest	Proprietà BackupRequestResource
tags	object	Tag di risorsa.

Risposte

Nome	Tipo	Descrizione
202 Accepted		Accettato
Other Status Codes	CloudError	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente.

Esempio

Trigger Backup

Esempio di richiesta

HTTP

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/linuxRsVaultRG/providers/Microsoft.RecoveryServices/vaults/linuxRsVault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;testrg;v1win2012r/protectedItems/VM;iaasvmcontainerv2;testrg;v1win2012r/backup?api-version=2024-10-01

{
  "properties": {
    "objectType": "IaasVMBackupRequest"
  }
}

Risposta di esempio

Codice di stato:: 202

Location: https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/linuxRsVaultRG/providers/Microsoft.RecoveryServices/vaults/linuxRsVault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainer;testrg;v1win2012r/protectedItems/VM;iaasvmcontainer;testrg;v1win2012r/operationResults/00000000-0000-0000-0000-000000000000?api-version=2016-12-01
Azure-AsyncOperation: https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/linuxRsVaultRG/providers/Microsoft.RecoveryServices/vaults/linuxRsVault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainer;testrg;v1win2012r/protectedItems/VM;iaasvmcontainer;testrg;v1win2012r/operationsStatus/00000000-0000-0000-0000-000000000000?api-version=2016-12-01
Retry-After: 60

Definizioni

Nome	Descrizione
AzureFileShareBackupRequest	Richiesta di backup specifica del carico di lavoro di AzureFileShare.
AzureWorkloadBackupRequest	Richiesta di backup specifica del carico di lavoro di AzureWorkload.
BackupRequestResource	Classe di base per la richiesta di backup. Le richieste di backup specifiche del carico di lavoro derivano da questa classe.
backupType	Tipo di backup, viz. Full, Differential, Log o CopyOnlyFull
CloudError	Risposta di errore del servizio Istanza contenitore.
CloudErrorBody	Risposta di errore del servizio Istanza contenitore.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
IaasVMBackupRequest	Richiesta di backup specifica del carico di lavoro della macchina virtuale IaaS.

AzureFileShareBackupRequest

Richiesta di backup specifica del carico di lavoro di AzureFileShare.

Nome	Tipo	Descrizione
objectType	string: AzureFileShareBackupRequest	Questa proprietà verrà utilizzata come discriminante per decidere i tipi specifici nella catena polimorfica di tipi.
recoveryPointExpiryTimeInUTC	string	La copia di backup scadrà dopo l'ora utc specificata.

AzureWorkloadBackupRequest

Richiesta di backup specifica del carico di lavoro di AzureWorkload.

Nome	Tipo	Descrizione
backupType	backupType	Tipo di backup, viz. Full, Differential, Log o CopyOnlyFull
enableCompression	boolean	Valore Bool per l'impostazione di compressione
objectType	string: AzureWorkloadBackupRequest	Questa proprietà verrà utilizzata come discriminante per decidere i tipi specifici nella catena polimorfica di tipi.
recoveryPointExpiryTimeInUTC	string	La copia di backup scadrà dopo l'ora utc specificata.

BackupRequestResource

Classe di base per la richiesta di backup. Le richieste di backup specifiche del carico di lavoro derivano da questa classe.

Nome	Tipo	Descrizione
eTag	string	ETag facoltativo.
id	string	L'ID risorsa rappresenta il percorso completo della risorsa.
location	string	Percorso della risorsa.
name	string	Nome della risorsa associato alla risorsa.
properties	BackupRequest: AzureFileShareBackupRequest AzureWorkloadBackupRequest IaasVMBackupRequest	Proprietà BackupRequestResource
tags	object	Tag di risorsa.
type	string	Tipo di risorsa rappresenta il percorso completo del modulo Spazio dei nomi/ResourceType/ResourceType/...

backupType

Tipo di backup, viz. Full, Differential, Log o CopyOnlyFull

Nome	Tipo	Descrizione
CopyOnlyFull	string
Differential	string
Full	string
Incremental	string
Invalid	string
Log	string
SnapshotCopyOnlyFull	string
SnapshotFull	string

CloudError

Risposta di errore del servizio Istanza contenitore.

Nome	Tipo	Descrizione
error	CloudErrorBody	Oggetto error.

CloudErrorBody