你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Backups - Trigger

参考

服务:: Recovery Services - Backup

API 版本:: 2024-10-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=2024-10-01

URI 参数

名称	在	必需	类型	说明
containerName	path	True	string	与备份项关联的容器名称。
fabricName	path	True	string	与备份项关联的结构名称。
protectedItemName	path	True	string	需要为其触发备份的备份项。
resourceGroupName	path	True	string	恢复服务保管库所在的资源组的名称。
subscriptionId	path	True	string	订阅 ID。
vaultName	path	True	string	恢复服务保管库的名称。
api-version	query	True	string	客户端 API 版本。

请求正文

名称	类型	说明
eTag	string	可选 ETag。
location	string	资源位置。
properties	BackupRequest: AzureFileShareBackupRequest AzureWorkloadBackupRequest IaasVMBackupRequest	BackupRequestResource 属性
tags	object	资源标记。

响应

名称	类型	说明
202 Accepted		接受
Other Status Codes	CloudError	描述操作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
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=2024-10-01

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

示例响应

状态代码:: 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

定义

名称	说明
AzureFileShareBackupRequest	特定于 AzureFileShare 工作负荷的备份请求。
AzureWorkloadBackupRequest	特定于 AzureWorkload 工作负荷的备份请求。
BackupRequestResource	备份请求的基类。特定于工作负荷的备份请求派生自此类。
backupType	备份类型（viz）。 Full、Differential、Log 或 CopyOnlyFull
CloudError	容器实例服务的错误响应。
CloudErrorBody	容器实例服务的错误响应。
ErrorAdditionalInfo	资源管理错误附加信息。
IaasVMBackupRequest	特定于 IaaS VM 工作负荷的备份请求。

AzureFileShareBackupRequest

特定于 AzureFileShare 工作负荷的备份请求。

名称	类型	说明
objectType	string: AzureFileShareBackupRequest	此属性将用作用于确定类型多态链中特定类型的鉴别器。
recoveryPointExpiryTimeInUTC	string	备份副本将在指定的时间（UTC）后过期。

AzureWorkloadBackupRequest

特定于 AzureWorkload 工作负荷的备份请求。

名称	类型	说明
backupType	backupType	备份类型（viz）。 Full、Differential、Log 或 CopyOnlyFull
enableCompression	boolean	用于压缩设置的布尔值
objectType	string: AzureWorkloadBackupRequest	此属性将用作用于确定类型多态链中特定类型的鉴别器。
recoveryPointExpiryTimeInUTC	string	备份副本将在指定的时间（UTC）后过期。

BackupRequestResource

备份请求的基类。特定于工作负荷的备份请求派生自此类。

名称	类型	说明
eTag	string	可选 ETag。
id	string	资源 ID 表示资源的完整路径。
location	string	资源位置。
name	string	与资源关联的资源名称。
properties	BackupRequest: AzureFileShareBackupRequest AzureWorkloadBackupRequest IaasVMBackupRequest	BackupRequestResource 属性
tags	object	资源标记。
type	string	资源类型表示命名空间/ResourceType/ResourceType/...

backupType

备份类型（viz）。 Full、Differential、Log 或 CopyOnlyFull

名称	类型	说明
CopyOnlyFull	string
Differential	string
Full	string
Incremental	string
Invalid	string
Log	string
SnapshotCopyOnlyFull	string
SnapshotFull	string

CloudError

容器实例服务的错误响应。

名称	类型	说明
error	CloudErrorBody	错误对象。

CloudErrorBody