通过

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

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 参数

名称 在 必需 类型 说明
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

目标订阅的 ID。
vaultName
 path True

string

VaultResource 的名称
api-version
 query True

string

minLength: 1

要用于此操作的 API 版本。

请求正文

名称 类型 说明
eTag

string

可选 ETag。
location

string

资源位置。
properties BackupRequest:

BackupRequestResource 属性
tags

object

资源标记。

响应

名称 类型 说明
202 Accepted

已接受请求进行处理，但尚未完成处理。
Other Status Codes

ErrorResponse

意外的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

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

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

Trigger Backup

示例请求

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

定义

名称 说明
AzureFileShareBackupRequest

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

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

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

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

创建资源的标识的类型。
ErrorDetail

Error Detail 类，用于封装 Code、Message 和 Recommendations。
ErrorResponse

错误响应
IaasVMBackupRequest

特定于 IaaS VM 工作负荷的备份请求。
systemData

与创建和上次修改资源相关的元数据。

AzureFileShareBackupRequest

Object

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

名称 类型 说明
objectType string:

AzureFileShareBackupRequest

此属性将用作用于确定类型多态链中特定类型的鉴别器。
recoveryPointExpiryTimeInUTC

string (date-time)

备份副本将在指定的时间（UTC）后过期。

AzureWorkloadBackupRequest

Object

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

名称 类型 说明
backupType

BackupType

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

boolean

用于压缩设置的布尔值
objectType string:

AzureWorkloadBackupRequest

此属性将用作用于确定类型多态链中特定类型的鉴别器。
recoveryPointExpiryTimeInUTC

string (date-time)

备份副本将在指定的时间（UTC）后过期。

BackupRequestResource

Object

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

名称 类型 说明
eTag

string

可选 ETag。
id

string

资源的完全限定资源 ID。 示例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location

string

资源位置。
name

string

资源的名称
properties BackupRequest:

BackupRequestResource 属性
systemData

systemData

包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
tags

object

资源标记。
type

string

资源类型。 例如，“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

BackupType

枚举

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

值 说明
Invalid
Full
Differential
Log
CopyOnlyFull
Incremental
SnapshotFull
SnapshotCopyOnlyFull

createdByType

枚举

创建资源的标识的类型。

值 说明
User
Application
ManagedIdentity
Key

ErrorDetail

Object

Error Detail 类，用于封装 Code、Message 和 Recommendations。

名称 类型 说明
code

string

错误代码。
message

string

与代码相关的错误消息。
recommendations

string[]

建议字符串列表。

ErrorResponse

Object

错误响应

名称 类型 说明
error

ErrorDetail

错误对象。

IaasVMBackupRequest

Object

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

名称 类型 说明
objectType string:

IaasVMBackupRequest

此属性将用作用于确定类型多态链中特定类型的鉴别器。
recoveryPointExpiryTimeInUTC

string (date-time)

备份副本将在指定的时间（UTC）后过期。

systemData

Object

与创建和上次修改资源相关的元数据。

名称 类型 说明
createdAt

string (date-time)

资源创建时间戳（UTC）。
createdBy

string

创建资源的标识。
createdByType

createdByType

创建资源的标识的类型。
lastModifiedAt

string (date-time)

上次修改的资源时间戳（UTC）
lastModifiedBy

string

上次修改资源的标识。
lastModifiedByType

createdByType

上次修改资源的标识的类型。