Backups - Trigger

Usługa:
Recovery Services - Backup
Wersja interfejsu API:
2026-11-01

Wyzwala tworzenie kopii zapasowej dla określonego elementu kopii zapasowej. Jest to operacja asynchroniczna. Aby poznać stan operacji, 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}/backup?api-version=2026-11-01

Parametry identyfikatora URI

Nazwisko 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

Kopia zapasowa nazwy elementu, którego szczegóły 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

Nazwisko Typ Opis
eTag

string

Opcjonalny element ETag.
location

string

Lokalizacja zasobu.
properties BackupRequest:

Właściwości BackupRequestResource
tags

object

Tagi zasobów.

Odpowiedzi

Nazwisko 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 OAuth2 w usłudze Azure Active Directory.

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

Zakresy

Nazwisko Opis
user_impersonation podszywaj się pod konto użytkownika

Przykłady

Trigger Backup

Przykładowe żądanie

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=2026-11-01

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

Przykładowa odpowiedź

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

Definicje

Nazwisko Opis
AzureFileShareBackupRequest

Żądanie kopii zapasowej specyficzne dla obciążenia AzureFileShare.
AzureWorkloadBackupRequest

Żądanie kopii zapasowej specyficzne dla obciążenia AzureWorkload.
BackupRequestResource

Klasa bazowa na potrzeby żądania kopii zapasowej. Żądania kopii zapasowych specyficzne dla obciążenia pochodzą z tej klasy.
BackupType

Typ kopii zapasowej, viz. Pełny, różnicowy, dziennik lub kopiujOnlyFull
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
IaasVMBackupRequest

Żądanie kopii zapasowej maszyny wirtualnej IaaS specyficzne dla obciążenia.
systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

AzureFileShareBackupRequest

Objekt

Żądanie kopii zapasowej specyficzne dla obciążenia AzureFileShare.

Nazwisko Typ Opis
objectType string:

AzureFileShareBackupRequest

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

string (date-time)

Kopia zapasowa wygaśnie po określonym czasie (UTC).

AzureWorkloadBackupRequest

Objekt

Żądanie kopii zapasowej specyficzne dla obciążenia AzureWorkload.

Nazwisko Typ Opis
backupType

BackupType

Typ kopii zapasowej, viz. Pełny, różnicowy, dziennik lub kopiujOnlyFull
enableCompression

boolean

Wartość logiczna dla ustawienia kompresji
objectType string:

AzureWorkloadBackupRequest

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

string (date-time)

Kopia zapasowa wygaśnie po określonym czasie (UTC).

BackupRequestResource

Objekt

Klasa bazowa na potrzeby żądania kopii zapasowej. Żądania kopii zapasowych specyficzne dla obciążenia pochodzą z tej klasy.

Nazwisko Typ Opis
eTag

string

Opcjonalny element ETag.
id

string

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

string

Lokalizacja zasobu.
name

string

Nazwa zasobu
properties BackupRequest:

Właściwości BackupRequestResource
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"

BackupType

Wyliczenie

Typ kopii zapasowej, viz. Pełny, różnicowy, dziennik lub kopiujOnlyFull

Wartość Opis
Invalid
Full
Differential
Log
CopyOnlyFull
Incremental
SnapshotFull
SnapshotCopyOnlyFull

createdByType

Wyliczenie

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.

Nazwisko 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

Nazwisko Typ Opis
error

ErrorDetail

Obiekt błędu.

IaasVMBackupRequest

Objekt

Żądanie kopii zapasowej maszyny wirtualnej IaaS specyficzne dla obciążenia.

Nazwisko Typ Opis
objectType string:

IaasVMBackupRequest

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

string (date-time)

Kopia zapasowa wygaśnie po określonym czasie (UTC).

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwisko 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.