Compartilhar via

Item Level Recovery Connections - Provision

Serviço:
Recovery Services - Backup
Versão da API:
2025-08-01

Provisiona um script que invoca uma conexão iSCSI para os dados de backup. A execução desse script abre um explorador de arquivos exibindo todos os arquivos e pastas recuperáveis. Esta é uma operação assíncrona. Para saber o status do provisionamento, chame a API GetProtectedItemOperationResult.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
containerName
 path True

string

Nome do contêiner cujos detalhes precisam ser buscados.
fabricName
 path True

string

O nome do BackupFabricResource
protectedItemName
 path True

string

Nome do item de backup cujos detalhes devem ser buscados.
recoveryPointId
 path True

string

RecoveryPointID representa os dados de backup a serem buscados.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId
 path True

string

minLength: 1

A ID da assinatura de destino.
vaultName
 path True

string

O nome do VaultResource
api-version
 query True

string

minLength: 1

A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome Tipo Description
eTag

string

ETag opcional.
___location

string

Local do recurso.
properties ILRRequest:

Propriedades ILRRequestResource
tags

object

Tags de recursos.

Respostas

Nome Tipo Description
202 Accepted

A solicitação foi aceita para processamento, mas o processamento ainda não foi concluído.
Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Provision Instant Item Level Recovery for Azure Vm

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
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

Definições

Nome Description
AzureFileShareProvisionILRRequest

Atualize o Uri do instantâneo com o nome amigável correto do compartilhamento de arquivos do Azure de origem.
createdByType

O tipo de identidade que criou o recurso.
ErrorDetail

Classe Error Detail que encapsula Código, Mensagem e Recomendações.
ErrorResponse

Resposta de erro
IaasVMILRRegistrationRequest

Restaurar arquivos/pastas de uma cópia de backup da VM IaaS.
ILRRequestResource

Parâmetros para provisionar a API ilr.
systemData

Metadados relativos à criação e última modificação do recurso.

AzureFileShareProvisionILRRequest

Objeto

Atualize o Uri do instantâneo com o nome amigável correto do compartilhamento de arquivos do Azure de origem.

Nome Tipo Description
objectType string:

AzureFileShareProvisionILRRequest

Essa propriedade será usada como discriminatória para decidir os tipos específicos na cadeia polimórfica de tipos.
recoveryPointId

string

ID do ponto de recuperação.
sourceResourceId

string

ID do ARM da conta de armazenamento de origem

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor Description
User
Application
ManagedIdentity
Key

ErrorDetail

Objeto

Classe Error Detail que encapsula Código, Mensagem e Recomendações.

Nome Tipo Description
code

string

Código de erro.
message

string

Mensagem de erro relacionada ao código.
recommendations

string[]

Lista de cadeias de caracteres de recomendação.

ErrorResponse

Objeto

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

IaasVMILRRegistrationRequest

Objeto

Restaurar arquivos/pastas de uma cópia de backup da VM IaaS.

Nome Tipo Description
initiatorName

string

Nome do iniciador iSCSI.
objectType string:

IaasVMILRRegistrationRequest

Essa propriedade será usada como discriminatória para decidir os tipos específicos na cadeia polimórfica de tipos.
recoveryPointId

string

ID da cópia de backup da VM iaaS de onde os arquivos/pastas precisam ser restaurados.
renewExistingRegistration

boolean

Se deseja renovar o registro existente com o servidor iSCSI.
virtualMachineId

string

ID do ARM totalmente qualificada da máquina virtual cujos arquivos/pastas precisam ser restaurados.

ILRRequestResource

Objeto

Parâmetros para provisionar a API ilr.

Nome Tipo Description
eTag

string

ETag opcional.
id

string

ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
___location

string

Local do recurso.
name

string

O nome do recurso
properties ILRRequest:

Propriedades ILRRequestResource
systemData

systemData

Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.
tags

object

Tags de recursos.
type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

systemData

Objeto

Metadados relativos à criação e última modificação do recurso.

Nome Tipo Description
createdAt

string (date-time)

O carimbo de data/hora da criação de recursos (UTC).
createdBy

string

A identidade que criou o recurso.
createdByType

createdByType

O tipo de identidade que criou o recurso.
lastModifiedAt

string (date-time)

O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy

string

A identidade que modificou o recurso pela última vez.
lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.