Backups - Trigger

服務:: Recovery Services - Backup

API 版本:: 2025-08-01

觸發指定備份項目的備份。這是異步操作。若要知道作業的狀態，請呼叫 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

URI 參數

名稱	位於	必要	類型	Description
containerName	path	True	string	需要擷取其詳細資料的容器名稱。
fabricName	path	True	string	BackupFabricResource 的名稱
protectedItemName	path	True	string	要擷取其詳細資料的備份項目名稱。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	資源群組的名稱。名稱不區分大小寫。
subscriptionId	path	True	string minLength: 1	目標訂用帳戶的標識碼。
vaultName	path	True	string	VaultResource 的名稱
api-version	query	True	string minLength: 1	用於此作業的 API 版本。

要求本文

名稱	類型	Description
eTag	string	選擇性 ETag。
location	string	資源位置。
properties	BackupRequest: AzureFileShareBackupRequest AzureWorkloadBackupRequest IaasVMBackupRequest	BackupRequestResource 屬性
tags	object	資源標籤。

回應

名稱	類型	Description
202 Accepted		要求已接受進行處理，但尚未完成處理。
Other Status Codes	ErrorResponse	未預期的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

Trigger Backup

範例要求

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

範例回覆

狀態碼:: 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

定義

名稱	Description
AzureFileShareBackupRequest	AzureFileShare 工作負載特定的備份要求。
AzureWorkloadBackupRequest	AzureWorkload 工作負載特定的備份要求。
BackupRequestResource	備份要求的基類。工作負載特定的備份要求衍生自這個類別。
BackupType	備份類型，viz。 Full、Differential、Log 或 CopyOnlyFull
createdByType	建立資源的身分識別類型。
ErrorDetail	Error Detail 類別，其中封裝了程式碼、訊息和建議。
ErrorResponse	錯誤回應
IaasVMBackupRequest	IaaS VM 工作負載特定的備份要求。
systemData	與建立和上次修改資源相關的元數據。

AzureFileShareBackupRequest

Object

AzureFileShare 工作負載特定的備份要求。

名稱	類型	Description
objectType	string: AzureFileShareBackupRequest	這個屬性將做為決定型別多型鏈結中特定類型的歧視性。
recoveryPointExpiryTimeInUTC	string (date-time)	備份複本會在指定的時間之後到期（UTC）。

AzureWorkloadBackupRequest

Object

AzureWorkload 工作負載特定的備份要求。

名稱	類型	Description
backupType	BackupType	備份類型，viz。 Full、Differential、Log 或 CopyOnlyFull
enableCompression	boolean	用於壓縮的Bool設定
objectType	string: AzureWorkloadBackupRequest	這個屬性將做為決定型別多型鏈結中特定類型的歧視性。
recoveryPointExpiryTimeInUTC	string (date-time)	備份複本會在指定的時間之後到期（UTC）。

BackupRequestResource

Object

備份要求的基類。工作負載特定的備份要求衍生自這個類別。

名稱	類型	Description
eTag	string	選擇性 ETag。
id	string	資源的完整資源標識碼。例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	資源位置。
name	string	資源的名稱
properties	BackupRequest: AzureFileShareBackupRequest AzureWorkloadBackupRequest IaasVMBackupRequest	BackupRequestResource 屬性
systemData	systemData	包含 createdBy 和 modifiedBy 資訊的 Azure Resource Manager 元數據。
tags	object	資源標籤。
type	string	資源的類型。例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts”

BackupType

列舉型別

備份類型，viz。 Full、Differential、Log 或 CopyOnlyFull

值	Description
Invalid
Full
Differential
Log
CopyOnlyFull
Incremental
SnapshotFull
SnapshotCopyOnlyFull

createdByType

列舉型別

建立資源的身分識別類型。

值	Description
User
Application
ManagedIdentity
Key

ErrorDetail

Object

Error Detail 類別，其中封裝了程式碼、訊息和建議。

名稱	類型	Description
code	string	錯誤碼。
message	string	與代碼相關的錯誤消息。
recommendations	string[]	建議字串清單。

ErrorResponse

Object

錯誤回應

名稱	類型	Description
error	ErrorDetail	error 物件。

IaasVMBackupRequest

Object

IaaS VM 工作負載特定的備份要求。

名稱	類型	Description
objectType	string: IaasVMBackupRequest	這個屬性將做為決定型別多型鏈結中特定類型的歧視性。
recoveryPointExpiryTimeInUTC	string (date-time)	備份複本會在指定的時間之後到期（UTC）。

systemData

Object

與建立和上次修改資源相關的元數據。

名稱	類型	Description
createdAt	string (date-time)	資源建立的時間戳（UTC）。
createdBy	string	建立資源的身分識別。
createdByType	createdByType	建立資源的身分識別類型。
lastModifiedAt	string (date-time)	上次修改的資源時間戳（UTC）
lastModifiedBy	string	上次修改資源的身分識別。
lastModifiedByType	createdByType	上次修改資源的身分識別類型。

共用方式為

Backups - Trigger

URI 參數

要求本文

回應

安全性

azure_auth

範圍

範例

Trigger Backup

範例要求

範例回覆

定義

AzureFileShareBackupRequest

AzureWorkloadBackupRequest

BackupRequestResource

BackupType

createdByType

ErrorDetail

ErrorResponse

IaasVMBackupRequest

systemData