Udostępnij przez

Item Level Recovery Connections - Provision

Usługa:
Recovery Services - Backup
Wersja interfejsu API:
2025-08-01

Aprowizuje skrypt, który wywołuje połączenie iSCSI z danymi kopii zapasowej. Wykonanie tego skryptu powoduje otwarcie Eksploratora plików z wyświetlonymi wszystkimi plikami i folderami, które można odzyskać. Jest to operacja asynchroniczna. Aby poznać stan aprowizacji, wywołaj interfejs 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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
containerName
 path True

string

Nazwa kontenera, którego szczegóły należy pobrać.
fabricName
 path True

string

Nazwa zasobu BackupFabricResource
protectedItemName
 path True

string

Utworzono kopię zapasową nazwy elementu, którego szczegóły mają zostać pobrane.
recoveryPointId
 path True

string

RecoveryPointID reprezentuje dane z kopii zapasowej, które mają zostać pobrane.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId
 path True

string

minLength: 1

Identyfikator subskrypcji docelowej.
vaultName
 path True

string

Nazwa zasobu VaultResource
api-version
 query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa Typ Opis
eTag

string

Opcjonalny element ETag.
location

string

Lokalizacja zasobu.
properties ILRRequest:

Właściwości ILRRequestResource
tags

object

Tagi zasobów.

Odpowiedzi

Nazwa Typ Opis
202 Accepted

Żądanie zostało zaakceptowane do przetwarzania, ale przetwarzanie nie zostało jeszcze ukończone.
Other Status Codes

ErrorResponse

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

Provision Instant Item Level Recovery for Azure Vm

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:
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

Definicje

Nazwa Opis
AzureFileShareProvisionILRRequest

Zaktualizuj identyfikator URI migawki przy użyciu poprawnej przyjaznej nazwy źródłowego udziału plików platformy Azure.
createdByType

Typ tożsamości, która utworzyła zasób.
ErrorDetail

Klasa Szczegóły błędu, która hermetyzuje kod, komunikat i zalecenia.
ErrorResponse

Odpowiedź na błąd
IaasVMILRRegistrationRequest

Przywracanie plików/folderów z kopii zapasowej maszyny wirtualnej IaaS.
ILRRequestResource

Parametry aprowizowania interfejsu API ILR.
systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

AzureFileShareProvisionILRRequest

Objekt

Zaktualizuj identyfikator URI migawki przy użyciu poprawnej przyjaznej nazwy źródłowego udziału plików platformy Azure.

Nazwa Typ Opis
objectType string:

AzureFileShareProvisionILRRequest

Ta właściwość będzie używana jako dyskryminująca do decydowania o określonych typach w łańcuchu polimorficznych typów.
recoveryPointId

string

Identyfikator punktu odzyskiwania.
sourceResourceId

string

Identyfikator arm źródłowego konta magazynu

createdByType

Wyliczanie

Typ tożsamości, która utworzyła zasób.

Wartość Opis
User
Application
ManagedIdentity
Key

ErrorDetail

Objekt

Klasa Szczegóły błędu, która hermetyzuje kod, komunikat i zalecenia.

Nazwa Typ Opis
code

string

Kod błędu.
message

string

Komunikat o błędzie związany z kodem.
recommendations

string[]

Lista ciągów rekomendacji.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt błędu.

IaasVMILRRegistrationRequest

Objekt

Przywracanie plików/folderów z kopii zapasowej maszyny wirtualnej IaaS.

Nazwa Typ Opis
initiatorName

string

Nazwa inicjatora iSCSI.
objectType string:

IaasVMILRRegistrationRequest

Ta właściwość będzie używana jako dyskryminująca do decydowania o określonych typach w łańcuchu polimorficznych typów.
recoveryPointId

string

Identyfikator kopii zapasowej maszyny wirtualnej IaaS, z której należy przywrócić pliki/foldery.
renewExistingRegistration

boolean

Czy odnowić istniejącą rejestrację na serwerze iSCSI.
virtualMachineId

string

W pełni kwalifikowany identyfikator ARM maszyny wirtualnej, której pliki/foldery muszą zostać przywrócone.

ILRRequestResource

Objekt

Parametry aprowizowania interfejsu API ILR.

Nazwa Typ Opis
eTag

string

Opcjonalny element ETag.
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Przykład - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location

string

Lokalizacja zasobu.
name

string

Nazwa zasobu
properties ILRRequest:

Właściwości ILRRequestResource
systemData

systemData

Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.
tags

object

Tagi zasobów.
type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa Typ Opis
createdAt

string (date-time)

Sygnatura czasowa tworzenia zasobu (UTC).
createdBy

string

Tożsamość, która utworzyła zasób.
createdByType

createdByType

Typ tożsamości, która utworzyła zasób.
lastModifiedAt

string (date-time)

Znacznik czasu ostatniej modyfikacji zasobu (UTC)
lastModifiedBy

string

Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType

createdByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.