Backups - Trigger

Hizmet:

Recovery Services - Backup

API Sürümü:

2026-02-01

Belirtilen yedeklenen öğe için yedeklemeyi tetikler. Bu zaman uyumsuz bir işlemdir. İşlemin durumunu öğrenmek için GetProtectedItemOperationResult API'sini çağırın.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}/backup?api-version=2026-02-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
containerName	path	True	string	Ayrıntılarının getirilmesi gereken kapsayıcının adı.
fabricName	path	True	string	BackupFabricResource'un adı
protectedItemName	path	True	string	Ayrıntıları getirilecek yedeklenmiş öğe adı.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Kaynak grubunun adı. İsim büyük/küçük harfe duyarsızdır.
subscriptionId	path	True	string minLength: 1	Hedef aboneliğin kimliği.
vaultName	path	True	string	VaultResource'un adı
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

İstek Gövdesi

Name	Tür	Description
eTag	string	İsteğe bağlı ETag.
location	string	Kaynak konumu.
properties	BackupRequest: AzureFileShareBackupRequest AzureWorkloadBackupRequest IaasVMBackupRequest	BackupRequestResource özellikleri
tags	object	Kaynak etiketleri.

Yanıtlar

Name	Tür	Description
202 Accepted		İstek işleme için kabul edildi, ancak işleme henüz tamamlanmadı.
Other Status Codes	ErrorResponse	Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

Trigger Backup

Örnek isteği

HTTP

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-02-01

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

Örnek yanıt

Durum kodu:

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

Tanımlar

Name	Description
AzureFileShareBackupRequest	AzureFileShare iş yüküne özgü yedekleme isteği.
AzureWorkloadBackupRequest	Azureworkload iş yüküne özgü yedekleme isteği.
BackupRequestResource	Yedekleme isteği için temel sınıf. İş yüküne özgü yedekleme istekleri bu sınıftan türetilir.
BackupType	Yedekleme türü, viz. Tam, Fark, Günlük veya CopyOnlyFull
createdByType	Kaynağı oluşturan kimliğin türü.
ErrorDetail	Hata Ayrıntısı Kod, Mesaj ve Önerileri kapsülleyen sınıf.
ErrorResponse	Hata yanıtı
IaasVMBackupRequest	IaaS VM iş yüküne özgü yedekleme isteği.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

AzureFileShareBackupRequest

Nesne

AzureFileShare iş yüküne özgü yedekleme isteği.

Name	Tür	Description
objectType	string: AzureFileShareBackupRequest	Bu özellik, türlerin polimorfik zincirinde belirli türlerin karar vermek için ayrımcı olarak kullanılır.
recoveryPointExpiryTimeInUTC	string (date-time)	Yedekleme kopyasının süresi belirtilen süreden (UTC) sonra dolacak.

AzureWorkloadBackupRequest

Nesne

Azureworkload iş yüküne özgü yedekleme isteği.

Name	Tür	Description
backupType	BackupType	Yedekleme türü, viz. Tam, Fark, Günlük veya CopyOnlyFull
enableCompression	boolean	Sıkıştırma için Bool ayarı
objectType	string: AzureWorkloadBackupRequest	Bu özellik, türlerin polimorfik zincirinde belirli türlerin karar vermek için ayrımcı olarak kullanılır.
recoveryPointExpiryTimeInUTC	string (date-time)	Yedekleme kopyasının süresi belirtilen süreden (UTC) sonra dolacak.

BackupRequestResource

Nesne

Yedekleme isteği için temel sınıf. İş yüküne özgü yedekleme istekleri bu sınıftan türetilir.

Name	Tür	Description
eTag	string	İsteğe bağlı ETag.
id	string	Kaynağın tam kaynak kimliği. Örn - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Kaynak konumu.
name	string	Kaynağın adı
properties	BackupRequest: AzureFileShareBackupRequest AzureWorkloadBackupRequest IaasVMBackupRequest	BackupRequestResource özellikleri
systemData	systemData	createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
tags	object	Kaynak etiketleri.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

BackupType

Numaralandırma

Yedekleme türü, viz. Tam, Fark, Günlük veya CopyOnlyFull

Değer	Description
Invalid
Full
Differential
Log
CopyOnlyFull
Incremental
SnapshotFull
SnapshotCopyOnlyFull

createdByType

Numaralandırma

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key

ErrorDetail

Nesne

Hata Ayrıntısı Kod, Mesaj ve Önerileri kapsülleyen sınıf.

Name	Tür	Description
code	string	Hata kodu.
message	string	Kodla ilgili Hata Mesajı.
recommendations	string[]	Öneri dizelerinin listesi.

ErrorResponse

Nesne

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

IaasVMBackupRequest

Nesne

IaaS VM iş yüküne özgü yedekleme isteği.

Name	Tür	Description
objectType	string: IaasVMBackupRequest	Bu özellik, türlerin polimorfik zincirinde belirli türlerin karar vermek için ayrımcı olarak kullanılır.
recoveryPointExpiryTimeInUTC	string (date-time)	Yedekleme kopyasının süresi belirtilen süreden (UTC) sonra dolacak.

systemData

Nesne

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimlik türü.