通过

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

Item Level Recovery Connections - Provision

服务:
Recovery Services - Backup
API 版本:
2025-08-01

预配一个脚本，该脚本调用与备份数据的 iSCSI 连接。 执行此脚本将打开一个文件资源管理器，其中显示所有可恢复的文件和文件夹。 这是一个异步操作。 若要了解预配状态，请调用 GetProtectedItemOperationResult API。

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

URI 参数

名称 在 必需 类型 说明
containerName
 path True

string

需要获取其详细信息的容器的名称。
fabricName
 path True

string

BackupFabricResource 的名称
protectedItemName
 path True

string

要获取其详细信息的备份项名称。
recoveryPointId
 path True

string

RecoveryPointID 表示要提取的备份数据。
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 ILRRequest:

ILRRequestResource 属性
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 模拟用户帐户

示例

Provision Instant Item Level Recovery for Azure Vm

示例请求

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/PythonSDKBackupTestRg/providers/Microsoft.RecoveryServices/vaults/PySDKBackupTestRsVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;pysdktestrg;pysdktestv2vm1/protectedItems/vm;iaasvmcontainerv2;pysdktestrg;pysdktestv2vm1/recoveryPoints/1/provisionInstantItemRecovery?api-version=2025-08-01

{
  "properties": {
    "initiatorName": "Hello World",
    "objectType": "IaasVMILRRegistrationRequest",
    "recoveryPointId": "38823086363464",
    "renewExistingRegistration": true,
    "virtualMachineId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/pysdktestrg/providers/Microsoft.Compute/virtualMachines/pysdktestv2vm1"
  }
}

示例响应

状态代码:
202 
Azure-AsyncOperation: https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/PythonSDKBackupTestRg/providers/Microsoft.RecoveryServices/vaults/PySDKBackupTestRsVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;pysdktestrg;pysdktestv2vm1/protectedItems/vm;iaasvmcontainerv2;pysdktestrg;pysdktestv2vm1/operationsStatus/00000000-0000-0000-0000-000000000000?api-version=2016-12-01
Location: https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/PythonSDKBackupTestRg/providers/Microsoft.RecoveryServices/vaults/PySDKBackupTestRsVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;pysdktestrg;pysdktestv2vm1/protectedItems/vm;iaasvmcontainerv2;pysdktestrg;pysdktestv2vm1/operationResults/00000000-0000-0000-0000-000000000000?api-version=2016-12-01
Retry-After: 60

定义

名称 说明
AzureFileShareProvisionILRRequest

使用源 Azure 文件共享的正确友好名称更新快照 URI。
createdByType

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

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

错误响应
IaasVMILRRegistrationRequest

从 IaaS VM 的备份副本还原文件/文件夹。
ILRRequestResource

预配 ILR API 的参数。
systemData

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

AzureFileShareProvisionILRRequest

Object

使用源 Azure 文件共享的正确友好名称更新快照 URI。

名称 类型 说明
objectType string:

AzureFileShareProvisionILRRequest

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

string

恢复点 ID。
sourceResourceId

string

源存储帐户 ARM ID

createdByType

枚举

创建资源的标识的类型。

值 说明
User
Application
ManagedIdentity
Key

ErrorDetail

Object

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

名称 类型 说明
code

string

错误代码。
message

string

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

string[]

建议字符串列表。

ErrorResponse

Object

错误响应

名称 类型 说明
error

ErrorDetail

错误对象。

IaasVMILRRegistrationRequest

Object

从 IaaS VM 的备份副本还原文件/文件夹。

名称 类型 说明
initiatorName

string

iSCSI 发起程序名称。
objectType string:

IaasVMILRRegistrationRequest

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

string

必须从中还原文件/文件夹的 IaaS VM 备份副本的 ID。
renewExistingRegistration

boolean

是否续订 iSCSI 服务器的现有注册。
virtualMachineId

string

必须还原其文件/文件夹的虚拟机的完全限定 ARM ID。

ILRRequestResource

Object

预配 ILR API 的参数。

名称 类型 说明
eTag

string

可选 ETag。
id

string

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

string

资源位置。
name

string

资源的名称
properties ILRRequest:

ILRRequestResource 属性
systemData

systemData

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

object

资源标记。
type

string

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

systemData

Object

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

名称 类型 说明
createdAt

string (date-time)

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

string

创建资源的标识。
createdByType

createdByType

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

string (date-time)

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

string

上次修改资源的标识。
lastModifiedByType

createdByType

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