Dela via

Backups - Trigger

Tjänst:
Recovery Services - Backup
API-version:
2025-08-01

Utlöser säkerhetskopiering för angivet säkerhetskopierat objekt. Det här är en asynkron åtgärd. Om du vill veta status för åtgärden anropar du Api:et GetProtectedItemOperationResult.

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

URI-parametrar

Name I Obligatorisk Typ Description
containerName
 path True

string

Namnet på den container vars information måste hämtas.
fabricName
 path True

string

Namnet på BackupFabricResource
protectedItemName
 path True

string

Säkerhetskopierat objektnamn vars information ska hämtas.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId
 path True

string

minLength: 1

ID för målprenumerationen.
vaultName
 path True

string

Namnet på VaultResource
api-version
 query True

string

minLength: 1

Den API-version som ska användas för den här åtgärden.

Begärandetext

Name Typ Description
eTag

string

Valfri ETag.
location

string

Resursplats.
properties BackupRequest:

Egenskaper för BackupRequestResource
tags

object

Resursetiketter.

Svar

Name Typ Description
202 Accepted

Begäran har godkänts för bearbetning, men bearbetningen har ännu inte slutförts.
Other Status Codes

ErrorResponse

Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

Trigger Backup

Exempelbegäran

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=2025-08-01

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

Exempelsvar

Statuskod:
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

Definitioner

Name Description
AzureFileShareBackupRequest

AzureFileShare arbetsbelastningsspecifik säkerhetskopieringsbegäran.
AzureWorkloadBackupRequest

AzureWorkload arbetsbelastningsspecifik säkerhetskopieringsbegäran.
BackupRequestResource

Basklass för säkerhetskopieringsbegäran. Arbetsbelastningsspecifika säkerhetskopieringsbegäranden härleds från den här klassen.
BackupType

Typ av säkerhetskopiering, viz. Fullständig, Differentiell, Logg eller CopyOnlyFull
createdByType

Den typ av identitet som skapade resursen.
ErrorDetail

Felinformationsklass som kapslar in kod, meddelande och rekommendationer.
ErrorResponse

Felsvar
IaasVMBackupRequest

IaaS VM-arbetsbelastningsspecifik säkerhetskopieringsbegäran.
systemData

Metadata som rör skapande och senaste ändring av resursen.

AzureFileShareBackupRequest

Objekt

AzureFileShare arbetsbelastningsspecifik säkerhetskopieringsbegäran.

Name Typ Description
objectType string:

AzureFileShareBackupRequest

Den här egenskapen används som diskriminerande för att bestämma de specifika typerna i den polymorfa typkedjan.
recoveryPointExpiryTimeInUTC

string (date-time)

Säkerhetskopian upphör att gälla efter den angivna tiden (UTC).

AzureWorkloadBackupRequest

Objekt

AzureWorkload arbetsbelastningsspecifik säkerhetskopieringsbegäran.

Name Typ Description
backupType

BackupType

Typ av säkerhetskopiering, viz. Fullständig, Differentiell, Logg eller CopyOnlyFull
enableCompression

boolean

Bool för komprimeringsinställning
objectType string:

AzureWorkloadBackupRequest

Den här egenskapen används som diskriminerande för att bestämma de specifika typerna i den polymorfa typkedjan.
recoveryPointExpiryTimeInUTC

string (date-time)

Säkerhetskopian upphör att gälla efter den angivna tiden (UTC).

BackupRequestResource

Objekt

Basklass för säkerhetskopieringsbegäran. Arbetsbelastningsspecifika säkerhetskopieringsbegäranden härleds från den här klassen.

Name Typ Description
eTag

string

Valfri ETag.
id

string

Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location

string

Resursplats.
name

string

Namnet på resursen
properties BackupRequest:

Egenskaper för BackupRequestResource
systemData

systemData

Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.
tags

object

Resursetiketter.
type

string

Resurstypen. T.ex. "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

BackupType

Uppräkning

Typ av säkerhetskopiering, viz. Fullständig, Differentiell, Logg eller CopyOnlyFull

Värde Description
Invalid
Full
Differential
Log
CopyOnlyFull
Incremental
SnapshotFull
SnapshotCopyOnlyFull

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde Description
User
Application
ManagedIdentity
Key

ErrorDetail

Objekt

Felinformationsklass som kapslar in kod, meddelande och rekommendationer.

Name Typ Description
code

string

Felkod.
message

string

Felmeddelande som är relaterat till koden.
recommendations

string[]

Lista över rekommendationssträngar.

ErrorResponse

Objekt

Felsvar

Name Typ Description
error

ErrorDetail

Felobjektet.

IaasVMBackupRequest

Objekt

IaaS VM-arbetsbelastningsspecifik säkerhetskopieringsbegäran.

Name Typ Description
objectType string:

IaasVMBackupRequest

Den här egenskapen används som diskriminerande för att bestämma de specifika typerna i den polymorfa typkedjan.
recoveryPointExpiryTimeInUTC

string (date-time)

Säkerhetskopian upphör att gälla efter den angivna tiden (UTC).

systemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Name Typ Description
createdAt

string (date-time)

Tidsstämpeln för resursskapande (UTC).
createdBy

string

Identiteten som skapade resursen.
createdByType

createdByType

Den typ av identitet som skapade resursen.
lastModifiedAt

string (date-time)

Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy

string

Identiteten som senast ändrade resursen.
lastModifiedByType

createdByType

Den typ av identitet som senast ändrade resursen.