Backups - Trigger

Služba:: Recovery Services - Backup

Verze rozhraní API:: 2025-08-01

Aktivuje zálohování pro zadanou zálohovanou položku. Jedná se o asynchronní operaci. Pokud chcete zjistit stav operace, zavolejte rozhraní GetProtectedItemOperationResult API.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
containerName	path	True	string	Název kontejneru, jehož podrobnosti je třeba načíst.
fabricName	path	True	string	Název prostředku BackupFabricResource
protectedItemName	path	True	string	Název zálohované položky, jejíž detaily mají být načteny.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string minLength: 1	ID cílového předplatného.
vaultName	path	True	string	Název prostředku úložiště
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Typ	Description
eTag	string	Volitelná značka ETag.
location	string	Umístění prostředku
properties	BackupRequest: AzureFileShareBackupRequest AzureWorkloadBackupRequest IaasVMBackupRequest	Vlastnosti BackupRequestResource
tags	object	Značky prostředků

Odpovědi

Name	Typ	Description
202 Accepted		Žádost byla přijata ke zpracování, ale zpracování ještě nebylo dokončeno.
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

Trigger Backup

Ukázkový požadavek

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=2025-08-01

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

Ukázková odpověď

Stavový kód:: 202

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
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
Retry-After: 60

Definice

Name	Description
AzureFileShareBackupRequest	Žádost o zálohování specifickou pro úlohy AzureFileShare
AzureWorkloadBackupRequest	Žádost o zálohování specifickou pro úlohy AzureWorkload
BackupRequestResource	Základní třída pro žádost o zálohování Požadavky na zálohování specifické pro úlohy jsou odvozeny z této třídy.
BackupType	Typ zálohování viz. Full, Differential, Log nebo CopyOnlyFull
createdByType	Typ identity, která prostředek vytvořila.
ErrorDetail	Třída Error Detail, která zapouzdřuje kód, zprávu a doporučení.
ErrorResponse	Chybová odpověď
IaasVMBackupRequest	Žádost o zálohování specifické pro úlohy virtuálního počítače IaaS
systemData	Metadata týkající se vytvoření a poslední změny prostředku.

AzureFileShareBackupRequest

Objekt

Žádost o zálohování specifickou pro úlohy AzureFileShare

Name	Typ	Description
objectType	string: AzureFileShareBackupRequest	Tato vlastnost se použije jako diskriminátor pro rozhodování o konkrétních typech v polymorfním řetězci typů.
recoveryPointExpiryTimeInUTC	string (date-time)	Záložní kopie vyprší po zadaném čase (UTC).

AzureWorkloadBackupRequest

Objekt

Žádost o zálohování specifickou pro úlohy AzureWorkload

Name	Typ	Description
backupType	BackupType	Typ zálohování viz. Full, Differential, Log nebo CopyOnlyFull
enableCompression	boolean	Logická hodnota pro nastavení komprese
objectType	string: AzureWorkloadBackupRequest	Tato vlastnost se použije jako diskriminátor pro rozhodování o konkrétních typech v polymorfním řetězci typů.
recoveryPointExpiryTimeInUTC	string (date-time)	Záložní kopie vyprší po zadaném čase (UTC).

BackupRequestResource

Objekt

Základní třída pro žádost o zálohování Požadavky na zálohování specifické pro úlohy jsou odvozeny z této třídy.

Name	Typ	Description
eTag	string	Volitelná značka ETag.
id	string	Plně kvalifikované ID prostředku pro prostředek. Příklad : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Umístění prostředku
name	string	Název prostředku
properties	BackupRequest: AzureFileShareBackupRequest AzureWorkloadBackupRequest IaasVMBackupRequest	Vlastnosti BackupRequestResource
systemData	systemData	Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
tags	object	Značky prostředků
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

BackupType

Výčet

Typ zálohování viz. Full, Differential, Log nebo CopyOnlyFull

Hodnota	Description
Invalid
Full
Differential
Log
CopyOnlyFull
Incremental
SnapshotFull
SnapshotCopyOnlyFull

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

ErrorDetail

Objekt

Třída Error Detail, která zapouzdřuje kód, zprávu a doporučení.

Name	Typ	Description
code	string	Kód chyby
message	string	Chybová zpráva související s kódem.
recommendations	string[]	Seznam řetězců doporučení.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

IaasVMBackupRequest

Objekt

Žádost o zálohování specifické pro úlohy virtuálního počítače IaaS

Name	Typ	Description
objectType	string: IaasVMBackupRequest	Tato vlastnost se použije jako diskriminátor pro rozhodování o konkrétních typech v polymorfním řetězci typů.
recoveryPointExpiryTimeInUTC	string (date-time)	Záložní kopie vyprší po zadaném čase (UTC).

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

Sdílet prostřednictvím

Backups - Trigger

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

Trigger Backup

Ukázkový požadavek

Ukázková odpověď

Definice

AzureFileShareBackupRequest

AzureWorkloadBackupRequest

BackupRequestResource

BackupType

createdByType

ErrorDetail

ErrorResponse

IaasVMBackupRequest

systemData