Backups - Trigger

Référence

Service:: Recovery Services - Backup

Version d'API:: 2024-10-01

Déclenche la sauvegarde de l’élément sauvegardé spécifié. Il s’agit d’une opération asynchrone. Pour connaître l’état de l’opération, appelez 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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
containerName	path	True	string	Nom du conteneur associé à l’élément de sauvegarde.
fabricName	path	True	string	Nom de l’infrastructure associé à l’élément de sauvegarde.
protectedItemName	path	True	string	Élément de sauvegarde pour lequel la sauvegarde doit être déclenchée.
resourceGroupName	path	True	string	Nom du groupe de ressources où se trouve le coffre Recovery Services.
subscriptionId	path	True	string	ID d’abonnement.
vaultName	path	True	string	Nom du coffre Recovery Services.
api-version	query	True	string	Version de l’API cliente.

Corps de la demande

Nom	Type	Description
eTag	string	ETag facultatif.
location	string	Emplacement des ressources.
properties	BackupRequest: AzureFileShareBackupRequest AzureWorkloadBackupRequest IaasVMBackupRequest	Propriétés BackupRequestResource
tags	object	Balises de ressource.

Réponses

Nom	Type	Description
202 Accepted		Accepté
Other Status Codes	CloudError	Réponse d’erreur décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	empruntez l’identité de votre compte d’utilisateur.

Exemples

Trigger Backup

Exemple de requête

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"
  }
}

Exemple de réponse

Code d’état:: 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

Définitions

Nom	Description
AzureFileShareBackupRequest	Demande de sauvegarde spécifique à la charge de travail AzureFileShare.
AzureWorkloadBackupRequest	Demande de sauvegarde spécifique à la charge de travail AzureWorkload.
BackupRequestResource	Classe de base pour la demande de sauvegarde. Les demandes de sauvegarde spécifiques à la charge de travail sont dérivées de cette classe.
backupType	Type de sauvegarde, viz. Full, Differential, Log ou CopyOnlyFull
CloudError	Réponse d’erreur du service Container Instance.
CloudErrorBody	Réponse d’erreur du service Container Instance.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
IaasVMBackupRequest	Demande de sauvegarde spécifique à la charge de travail de machine virtuelle IaaS.

AzureFileShareBackupRequest

Demande de sauvegarde spécifique à la charge de travail AzureFileShare.

Nom	Type	Description
objectType	string: AzureFileShareBackupRequest	Cette propriété sera utilisée comme discriminateur pour décider des types spécifiques dans la chaîne polymorphe de types.
recoveryPointExpiryTimeInUTC	string	La copie de sauvegarde expire après l’heure spécifiée (UTC).

AzureWorkloadBackupRequest

Demande de sauvegarde spécifique à la charge de travail AzureWorkload.

Nom	Type	Description
backupType	backupType	Type de sauvegarde, viz. Full, Differential, Log ou CopyOnlyFull
enableCompression	boolean	Bool pour le paramètre compression
objectType	string: AzureWorkloadBackupRequest	Cette propriété sera utilisée comme discriminateur pour décider des types spécifiques dans la chaîne polymorphe de types.
recoveryPointExpiryTimeInUTC	string	La copie de sauvegarde expire après l’heure spécifiée (UTC).

BackupRequestResource

Classe de base pour la demande de sauvegarde. Les demandes de sauvegarde spécifiques à la charge de travail sont dérivées de cette classe.

Nom	Type	Description
eTag	string	ETag facultatif.
id	string	L’ID de ressource représente le chemin d’accès complet à la ressource.
location	string	Emplacement des ressources.
name	string	Nom de la ressource associé à la ressource.
properties	BackupRequest: AzureFileShareBackupRequest AzureWorkloadBackupRequest IaasVMBackupRequest	Propriétés BackupRequestResource
tags	object	Balises de ressource.
type	string	Le type de ressource représente le chemin d’accès complet du formulaire Namespace/ResourceType/ResourceType/...

backupType

Type de sauvegarde, viz. Full, Differential, Log ou CopyOnlyFull

Nom	Type	Description
CopyOnlyFull	string
Differential	string
Full	string
Incremental	string
Invalid	string
Log	string
SnapshotCopyOnlyFull	string
SnapshotFull	string

CloudError

Réponse d’erreur du service Container Instance.

Nom	Type	Description
error	CloudErrorBody	Objet d’erreur.

CloudErrorBody