Backup Instances - Adhoc Backup

Service:

Data Protection

API-versie:

2025-07-01

Ad-hocback-up activeren

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupInstances/{backupInstanceName}/backup?api-version=2025-07-01

URI-parameters

Name	In	Vereist	Type	Description
backupInstanceName	path	True	string	De naam van het back-upexemplaren.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
subscriptionId	path	True	string (uuid)	De id van het doelabonnement. De waarde moet een UUID zijn.
vaultName	path	True	string	De naam van de back-upkluis.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Vereist	Type	Description
backupRuleOptions	True	AdHocBackupRuleOptions	AdHocBackupRuleOpties Naam voor de regel van het beleid die moet worden toegepast voor deze back-up

Antwoorden

Name	Type	Description
200 OK	OperationJobExtendedInfo	Bevat aanvullende informatie, zoals taak-id
202 Accepted		De bewerking wordt asynchroon voltooid. Kopteksten Location: string Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	CloudError	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Imitatie van uw gebruikersaccount.

Voorbeelden

Trigger Adhoc Backup

Voorbeeldaanvraag

HTTP

POST https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/testInstance1/backup?api-version=2025-07-01

{
  "backupRuleOptions": {
    "ruleName": "BackupWeekly",
    "triggerOption": {
      "retentionTagOverride": "yearly"
    }
  }
}

Voorbeeldrespons

Statuscode:

202

Location: https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupInstances/harshitbi1/operationResults/ZTA4YjQ0ZGYtYmNkNS00YTk1LWFjZTMtOTc1MjNmZWIxYWZlO2Y1ODg1MzA3LWJkNjItNDQ2OC05ZjZlLTJkMGM2NjNiNmJmNg==?api-version=2025-07-01
Azure-AsyncOperation: https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/operationStatus/ZTA4YjQ0ZGYtYmNkNS00YTk1LWFjZTMtOTc1MjNmZWIxYWZlO2Y1ODg1MzA3LWJkNjItNDQ2OC05ZjZlLTJkMGM2NjNiNmJmNg==?api-version=2025-07-01
Retry-After: 60

Statuscode:

200

{
  "jobId": "c60cb49-63e8-4b21-b9bd-26277b3fdfae",
  "objectType": "OperationJobExtendedInfo"
}

Definities

Name	Description
AdHocBackupRuleOptions	AdHocBackupRuleOpties
AdhocBackupTriggerOption	AdhocBackupTriggerOption
CloudError	CloudError
Error	Het antwoord van het resourcebeheerfout.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
OperationJobExtendedInfo	OperationJobExtendedInfo
TriggerBackupRequest	TriggerBackupVerzoek

AdHocBackupRuleOptions

Object

AdHocBackupRuleOpties

Name	Type	Description
ruleName	string
triggerOption	AdhocBackupTriggerOption	AdhocBackupTriggerOption Optie back-uptrigger addhoc

AdhocBackupTriggerOption

Object

AdhocBackupTriggerOption

Name	Type	Description
retentionTagOverride	string

CloudError

Object

CloudError

Name	Type	Description
error	Error	Het antwoord van het resourcebeheerfout.

Error

Object

Het antwoord van het resourcebeheerfout.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	Error[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

OperationJobExtendedInfo

Object

OperationJobExtendedInfo

Name	Type	Description
jobId	string	Naam of Arm-id van de taak die voor deze bewerking is gemaakt.
objectType	string: OperationJobExtendedInfo	Deze eigenschap wordt gebruikt als de discriminator voor het bepalen van de specifieke typen in de polymorfische keten van typen.

TriggerBackupRequest

Object

TriggerBackupVerzoek

Name	Type	Description
backupRuleOptions	AdHocBackupRuleOptions	AdHocBackupRuleOpties Naam voor de regel van het beleid die moet worden toegepast voor deze back-up