Azure VM Schedule-Based Backup Policies

The /policies/virtualMachines resource collection represents Azure VM schedule-based backup policies configured in Veeam Backup for Microsoft Azure.

Get Collection of Azure VM Schedule-Based Backup Policies

The HTTP GET request to the /policies/virtualMachines endpoint retrieves a list of Azure VM schedule-based backup policies configured in Veeam Backup for Microsoft Azure.

SecurityBearer

Request

query Parameters

PolicyName	string or null Returns a backup policy with the specified name. x-veeam-parameter-group: PolicyQueryOptions
LastJobStatus	Array of strings or null (JobStatus) Returns only backup policies with the specified most recent backup session status. Enum: "Canceled" "Canceling" "Error" "NeverExecuted" "Running" "RunningWithError" "RunningWithWarning" "Success" "Warning" "Pending" "Unknown" x-veeam-parameter-group: PolicyQueryOptions x-veeam-model-binder: Veeam.Azure.REST.RequestQuery.V2.CsvModelBinder<Veeam.Azure.REST.Latest.JobStatus>
PolicyStatus	Array of strings or null (PolicyStatus) Returns only enabled or disabled backup policies. Enum: "Enabled" "Disabled" "Unknown" x-veeam-parameter-group: PolicyQueryOptions x-veeam-model-binder: Veeam.Azure.REST.RequestQuery.V2.CsvModelBinder<Veeam.Azure.REST.Latest.PolicyStatus>
VirtualMachineId	string or null Returns only backup policies that protect an Azure VM with the specified ID. x-veeam-parameter-group: PolicyQueryOptions
RepositoryId	string or null Returns only backup policies that store backup files in a backup repository with the specified ID. x-veeam-parameter-group: PolicyQueryOptions
Offset	integer <int32> >= 0 Specifies the first N items of a resource collection that will be excluded from the response. x-veeam-parameter-group: Veeam.Azure.REST.RequestQuery.V2.PageProperties
Limit	integer <int32> >= -1 Specifies the maximum number of items of a resource collection that will be returned in the response. x-veeam-parameter-group: Veeam.Azure.REST.RequestQuery.V2.PageProperties

Responses

200

400

Bad Request

401

Unauthorized

403

Forbidden

get/api/v8/policies/virtualMachines

Request samples

curl

curl -i -X GET \
  'https://123.123.123.123/api/v8/policies/virtualMachines?PolicyName=string&LastJobStatus=Canceled&PolicyStatus=Enabled&VirtualMachineId=string&RepositoryId=string&Offset=0&Limit=-1' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Response samples

application/json

{"offset": 0,
"limit": 0,
"totalCount": 0,
"_links": {"property1": {"href": "http://example.com"
},
"property2": {"href": "http://example.com"
}
},
"results": [{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"priority": 0,
"excludedItemsCount": 0,
"tenantId": "string",
"snapshotStatus": "Canceled",
"backupStatus": "Canceled",
"archiveStatus": "Canceled",
"healthCheckStatus": "Canceled",
"nextExecutionTime": "2019-08-24T14:15:22Z",
"convertedWithLoss": true,
"isBackupConfigured": true,
"isArchiveBackupConfigured": true,
"isScheduleConfigured": true,
"_links": {"property1": {"href": "http://example.com"
},
"property2": {"href": "http://example.com"
}
},
"serviceAccountId": "a814cf67-aaac-43ae-acb4-8d34e82a4b4c",
"name": "string",
"description": "string",
"retrySettings": {"retryCount": 0
},
"policyNotificationSettings": {"recipient": "string",
"notifyOnSuccess": true,
"notifyOnWarning": true,
"notifyOnFailure": true
},
"isEnabled": true,
"backupType": "AllSubscriptions",
"snapshotSettings": {"additionalTags": [{"name": "string",
"value": "string"
}
],
"copyOriginalTags": true,
"applicationAwareSnapshot": true,
"userScripts": {"windows": {"scriptsEnabled": true,
"preScriptPath": "string",
"preScriptArguments": "string",
"postScriptPath": "string",
"postScriptArguments": "string",
"repositorySnapshotsOnly": true,
"ignoreExitCodes": true,
"ignoreMissingScripts": true
},
"linux": {"scriptsEnabled": true,
"preScriptPath": "string",
"preScriptArguments": "string",
"postScriptPath": "string",
"postScriptArguments": "string",
"repositorySnapshotsOnly": true,
"ignoreExitCodes": true,
"ignoreMissingScripts": true
}
}
},
"dailySchedule": {"dailyType": "Everyday",
"selectedDays": ["Sunday"
],
"runsPerHour": 0,
"snapshotSchedule": {"hours": [0
],
"snapshotsToKeep": 0
},
"backupSchedule": {"hours": [0
],
"retention": {"timeRetentionDuration": 0,
"retentionDurationType": "Days"
},
"targetRepositoryId": "string"
}
},
"weeklySchedule": {"startTime": 0,
"snapshotSchedule": {"selectedDays": ["Sunday"
],
"snapshotsToKeep": 0
},
"backupSchedule": {"selectedDays": ["Sunday"
],
"retention": {"timeRetentionDuration": 0,
"retentionDurationType": "Days"
},
"targetRepositoryId": "string"
}
},
"monthlySchedule": {"startTime": 0,
"type": "First",
"dayOfWeek": "Sunday",
"dayOfMonth": 0,
"monthlyLastDay": true,
"snapshotSchedule": {"selectedMonths": ["January"
],
"snapshotsToKeep": 0
},
"backupSchedule": {"selectedMonths": ["January"
],
"retention": {"timeRetentionDuration": 0,
"retentionDurationType": "Days"
},
"targetRepositoryId": "string"
}
},
"yearlySchedule": {"startTime": 0,
"month": "January",
"type": "First",
"dayOfWeek": "Sunday",
"dayOfMonth": 0,
"yearlyLastDay": true,
"retentionYearsCount": 0,
"targetRepositoryId": "string"
},
"healthCheckSchedule": {"healthCheckEnabled": true,
"localTime": "2019-08-24T14:15:22Z",
"dayNumberInMonth": "First",
"daysOfWeek": ["Sunday"
],
"dayOfMonth": 0,
"months": ["January"
]
},
"cbtResetTimeUtc": "2019-08-24T14:15:22Z"
}
]
}

Create Backup Policy

The HTTP POST request to the /policies/virtualMachines endpoint creates a new Azure VM schedule-based backup policy.

SecurityBearer

Request

Request Body schema: application/json
required

isEnabled required	boolean or null Defines whether the policy is enabled.
name required	string [ 1 .. 255 ] characters Specifies a name for the backup policy.
required	Array of objects (PolicyRegionFromClient) non-empty Specifies Azure regions where the resources that will be backed up reside.
required	object (SnapshotSettings) Specifies cloud-native snapshot settings for the backup policy. x-veeam-namespace: Veeam.Azure.REST.Representation.V2
tenantId required	string Specifies a Microsoft Azure ID assigned to a tenant with which the service account used to protect Azure resources is associated.
serviceAccountId required	string <uuid> Specifies the system ID assigned in the Veeam Backup for Microsoft Azure REST API to the service account whose permissions will be used to perform backups of Azure VMs.
	object or null (PolicyBackupItemsFromClient) [Applies if the SelectedItems value is specified for the `backupType` parameter] Specifies Azure resources to protect by the backup policy.
	object or null (PolicyExcludedItemsFromClient) Specifies Azure tags to identify the resources that should be excluded from the backup scope.
description	string or null Specifies a description for the backup policy.
	object or null (RetrySettings) Specifies the retry settings for the backup policy.
	object or null (PolicyNotificationSettings) Specifies the notification settings for the backup policy.
backupType	string or null (BackupTypeNullable) Defines whether you want to include to the backup scope all resources residing in the specified Azure regions and to which the specified service account has access. Enum: "AllSubscriptions" "SelectedItems" "Unknown" x-external-type: Veeam.Azure.REST.Latest.BackupType
	object or null (DailySchedule) Specifies the daily schedule settings for the backup policy.
	object or null (WeeklySchedule) Specifies the weekly schedule settings for the backup policy.
	object or null (MonthlySchedule) Specifies the monthly schedule settings for the backup policy.
	object or null (YearlySchedule) Specifies the yearly schedule settings for the backup policy.
	object or null (HealthCheckSchedule) [Applies if backup creation is enabled for the backup policy] Specifies the health check schedule settings.

Responses

201

Created

400

Bad Request

401

Unauthorized

403

Forbidden

415

Client Error

post/api/v8/policies/virtualMachines

Request samples

Payload
curl

application/json

{"tenantId": "string",
"serviceAccountId": "a814cf67-aaac-43ae-acb4-8d34e82a4b4c",
"regions": [{"regionId": "string"
}
],
"selectedItems": {"subscriptions": [{"subscriptionId": "string"
}
],
"tags": [{"name": "string",
"value": "string"
}
],
"resourceGroups": [{"id": "string"
}
],
"virtualMachines": [{"id": "string"
}
],
"tagGroups": [{"name": "string",
"subscription": {"subscriptionId": "string"
},
"resourceGroup": {"id": "string"
},
"tags": [{"name": "string",
"value": "string"
}
]
}
]
},
"excludedItems": {"virtualMachines": [{"id": "string"
}
],
"tags": [{"name": "string",
"value": "string"
}
]
},
"name": "string",
"description": "string",
"retrySettings": {"retryCount": 0
},
"policyNotificationSettings": {"recipient": "string",
"notifyOnSuccess": true,
"notifyOnWarning": true,
"notifyOnFailure": true
},
"isEnabled": true,
"backupType": "AllSubscriptions",
"snapshotSettings": {"additionalTags": [{"name": "string",
"value": "string"
}
],
"copyOriginalTags": true,
"applicationAwareSnapshot": true,
"userScripts": {"windows": {"scriptsEnabled": true,
"preScriptPath": "string",
"preScriptArguments": "string",
"postScriptPath": "string",
"postScriptArguments": "string",
"repositorySnapshotsOnly": true,
"ignoreExitCodes": true,
"ignoreMissingScripts": true
},
"linux": {"scriptsEnabled": true,
"preScriptPath": "string",
"preScriptArguments": "string",
"postScriptPath": "string",
"postScriptArguments": "string",
"repositorySnapshotsOnly": true,
"ignoreExitCodes": true,
"ignoreMissingScripts": true
}
}
},
"dailySchedule": {"dailyType": "Everyday",
"selectedDays": ["Sunday"
],
"runsPerHour": 0,
"snapshotSchedule": {"hours": [0
],
"snapshotsToKeep": 0
},
"backupSchedule": {"hours": [0
],
"retention": {"timeRetentionDuration": 0,
"retentionDurationType": "Days"
},
"targetRepositoryId": "string"
}
},
"weeklySchedule": {"startTime": 0,
"snapshotSchedule": {"selectedDays": ["Sunday"
],
"snapshotsToKeep": 0
},
"backupSchedule": {"selectedDays": ["Sunday"
],
"retention": {"timeRetentionDuration": 0,
"retentionDurationType": "Days"
},
"targetRepositoryId": "string"
}
},
"monthlySchedule": {"startTime": 0,
"type": "First",
"dayOfWeek": "Sunday",
"dayOfMonth": 0,
"monthlyLastDay": true,
"snapshotSchedule": {"selectedMonths": ["January"
],
"snapshotsToKeep": 0
},
"backupSchedule": {"selectedMonths": ["January"
],
"retention": {"timeRetentionDuration": 0,
"retentionDurationType": "Days"
},
"targetRepositoryId": "string"
}
},
"yearlySchedule": {"startTime": 0,
"month": "January",
"type": "First",
"dayOfWeek": "Sunday",
"dayOfMonth": 0,
"yearlyLastDay": true,
"retentionYearsCount": 0,
"targetRepositoryId": "string"
},
"healthCheckSchedule": {"healthCheckEnabled": true,
"localTime": "2019-08-24T14:15:22Z",
"dayNumberInMonth": "First",
"daysOfWeek": ["Sunday"
],
"dayOfMonth": 0,
"months": ["January"
]
}
}

Response samples

application/json

{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"priority": 0,
"excludedItemsCount": 0,
"tenantId": "string",
"snapshotStatus": "Canceled",
"backupStatus": "Canceled",
"archiveStatus": "Canceled",
"healthCheckStatus": "Canceled",
"nextExecutionTime": "2019-08-24T14:15:22Z",
"convertedWithLoss": true,
"isBackupConfigured": true,
"isArchiveBackupConfigured": true,
"isScheduleConfigured": true,
"_links": {"property1": {"href": "http://example.com"
},
"property2": {"href": "http://example.com"
}
},
"serviceAccountId": "a814cf67-aaac-43ae-acb4-8d34e82a4b4c",
"name": "string",
"description": "string",
"retrySettings": {"retryCount": 0
},
"policyNotificationSettings": {"recipient": "string",
"notifyOnSuccess": true,
"notifyOnWarning": true,
"notifyOnFailure": true
},
"isEnabled": true,
"backupType": "AllSubscriptions",
"snapshotSettings": {"additionalTags": [{"name": "string",
"value": "string"
}
],
"copyOriginalTags": true,
"applicationAwareSnapshot": true,
"userScripts": {"windows": {"scriptsEnabled": true,
"preScriptPath": "string",
"preScriptArguments": "string",
"postScriptPath": "string",
"postScriptArguments": "string",
"repositorySnapshotsOnly": true,
"ignoreExitCodes": true,
"ignoreMissingScripts": true
},
"linux": {"scriptsEnabled": true,
"preScriptPath": "string",
"preScriptArguments": "string",
"postScriptPath": "string",
"postScriptArguments": "string",
"repositorySnapshotsOnly": true,
"ignoreExitCodes": true,
"ignoreMissingScripts": true
}
}
},
"dailySchedule": {"dailyType": "Everyday",
"selectedDays": ["Sunday"
],
"runsPerHour": 0,
"snapshotSchedule": {"hours": [0
],
"snapshotsToKeep": 0
},
"backupSchedule": {"hours": [0
],
"retention": {"timeRetentionDuration": 0,
"retentionDurationType": "Days"
},
"targetRepositoryId": "string"
}
},
"weeklySchedule": {"startTime": 0,
"snapshotSchedule": {"selectedDays": ["Sunday"
],
"snapshotsToKeep": 0
},
"backupSchedule": {"selectedDays": ["Sunday"
],
"retention": {"timeRetentionDuration": 0,
"retentionDurationType": "Days"
},
"targetRepositoryId": "string"
}
},
"monthlySchedule": {"startTime": 0,
"type": "First",
"dayOfWeek": "Sunday",
"dayOfMonth": 0,
"monthlyLastDay": true,
"snapshotSchedule": {"selectedMonths": ["January"
],
"snapshotsToKeep": 0
},
"backupSchedule": {"selectedMonths": ["January"
],
"retention": {"timeRetentionDuration": 0,
"retentionDurationType": "Days"
},
"targetRepositoryId": "string"
}
},
"yearlySchedule": {"startTime": 0,
"month": "January",
"type": "First",
"dayOfWeek": "Sunday",
"dayOfMonth": 0,
"yearlyLastDay": true,
"retentionYearsCount": 0,
"targetRepositoryId": "string"
},
"healthCheckSchedule": {"healthCheckEnabled": true,
"localTime": "2019-08-24T14:15:22Z",
"dayNumberInMonth": "First",
"daysOfWeek": ["Sunday"
],
"dayOfMonth": 0,
"months": ["January"
]
},
"cbtResetTimeUtc": "2019-08-24T14:15:22Z"
}

Get Backup Policy Data

The HTTP GET request to the /policies/virtualMachines/{policyId} endpoint retrieves settings of an Azure VM schedule-based backup policy with the specified ID.

SecurityBearer

Request

path Parameters

policyId

required

string <uuid>

Specifies the system ID assigned to a backup policy in the Veeam Backup for Microsoft Azure REST API.

Responses

200

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

get/api/v8/policies/virtualMachines/{policyId}

Request samples

curl

curl -i -X GET \
  'https://123.123.123.123/api/v8/policies/virtualMachines/{policyId}' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Response samples

application/json

{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"priority": 0,
"excludedItemsCount": 0,
"tenantId": "string",
"snapshotStatus": "Canceled",
"backupStatus": "Canceled",
"archiveStatus": "Canceled",
"healthCheckStatus": "Canceled",
"nextExecutionTime": "2019-08-24T14:15:22Z",
"convertedWithLoss": true,
"isBackupConfigured": true,
"isArchiveBackupConfigured": true,
"isScheduleConfigured": true,
"_links": {"property1": {"href": "http://example.com"
},
"property2": {"href": "http://example.com"
}
},
"serviceAccountId": "a814cf67-aaac-43ae-acb4-8d34e82a4b4c",
"name": "string",
"description": "string",
"retrySettings": {"retryCount": 0
},
"policyNotificationSettings": {"recipient": "string",
"notifyOnSuccess": true,
"notifyOnWarning": true,
"notifyOnFailure": true
},
"isEnabled": true,
"backupType": "AllSubscriptions",
"snapshotSettings": {"additionalTags": [{"name": "string",
"value": "string"
}
],
"copyOriginalTags": true,
"applicationAwareSnapshot": true,
"userScripts": {"windows": {"scriptsEnabled": true,
"preScriptPath": "string",
"preScriptArguments": "string",
"postScriptPath": "string",
"postScriptArguments": "string",
"repositorySnapshotsOnly": true,
"ignoreExitCodes": true,
"ignoreMissingScripts": true
},
"linux": {"scriptsEnabled": true,
"preScriptPath": "string",
"preScriptArguments": "string",
"postScriptPath": "string",
"postScriptArguments": "string",
"repositorySnapshotsOnly": true,
"ignoreExitCodes": true,
"ignoreMissingScripts": true
}
}
},
"dailySchedule": {"dailyType": "Everyday",
"selectedDays": ["Sunday"
],
"runsPerHour": 0,
"snapshotSchedule": {"hours": [0
],
"snapshotsToKeep": 0
},
"backupSchedule": {"hours": [0
],
"retention": {"timeRetentionDuration": 0,
"retentionDurationType": "Days"
},
"targetRepositoryId": "string"
}
},
"weeklySchedule": {"startTime": 0,
"snapshotSchedule": {"selectedDays": ["Sunday"
],
"snapshotsToKeep": 0
},
"backupSchedule": {"selectedDays": ["Sunday"
],
"retention": {"timeRetentionDuration": 0,
"retentionDurationType": "Days"
},
"targetRepositoryId": "string"
}
},
"monthlySchedule": {"startTime": 0,
"type": "First",
"dayOfWeek": "Sunday",
"dayOfMonth": 0,
"monthlyLastDay": true,
"snapshotSchedule": {"selectedMonths": ["January"
],
"snapshotsToKeep": 0
},
"backupSchedule": {"selectedMonths": ["January"
],
"retention": {"timeRetentionDuration": 0,
"retentionDurationType": "Days"
},
"targetRepositoryId": "string"
}
},
"yearlySchedule": {"startTime": 0,
"month": "January",
"type": "First",
"dayOfWeek": "Sunday",
"dayOfMonth": 0,
"yearlyLastDay": true,
"retentionYearsCount": 0,
"targetRepositoryId": "string"
},
"healthCheckSchedule": {"healthCheckEnabled": true,
"localTime": "2019-08-24T14:15:22Z",
"dayNumberInMonth": "First",
"daysOfWeek": ["Sunday"
],
"dayOfMonth": 0,
"months": ["January"
]
},
"cbtResetTimeUtc": "2019-08-24T14:15:22Z"
}

Modify Backup Policy

The HTTP PUT request to the /policies/virtualMachines/{policyId} endpoint updates settings of an Azure VM schedule-based backup policy with the specified ID.

SecurityBearer

Request

path Parameters

policyId

required

string <uuid>

Specifies the system ID assigned to a backup policy in the Veeam Backup for Microsoft Azure REST API.

Request Body schema: application/json
required

isEnabled required	boolean or null Defines whether to enable the policy.
name required	string [ 1 .. 255 ] characters Specifies a name for the backup policy.
required	Array of objects (PolicyRegionFromClient) non-empty Specifies a list of regions where the backed-up Azure VM reside.
required	object (SnapshotSettings) Specifies cloud-native snapshot settings for the backup policy. x-veeam-namespace: Veeam.Azure.REST.Representation.V2
tenantId	string or null Specifies a Microsoft Azure ID assigned to a tenant with which the service account used to protect Azure resources is associated.
serviceAccountId	string or null <uuid> Specifies the system ID assigned in the Veeam Backup for Microsoft Azure REST API to the service account whose permissions will be used to perform backups of Azure VMs.
	object or null (PolicyBackupItemsFromClient) [Applies if the SelectedItems value is specified for the `backupType` parameter] Specifies Azure resources to protect by the backup policy.
	object or null (PolicyExcludedItemsFromClient) Specifies Azure tags to identify the resources that should be excluded from the backup scope.
description	string or null Specifies a description for the policy.
	object or null (RetrySettings) Specifies the retry settings for the backup policy.
	object or null (PolicyNotificationSettings) Specifies the notification settings for the backup policy.
backupType	string or null (BackupTypeNullable) Defines whether you want to include to the backup scope all resources residing in the specified Azure regions and to which the specified service account has access. Enum: "AllSubscriptions" "SelectedItems" "Unknown" x-external-type: Veeam.Azure.REST.Latest.BackupType
	object or null (DailySchedule) Specifies the daily schedule settings for the backup policy.
	object or null (WeeklySchedule) Specifies the weekly schedule settings for the backup policy.
	object or null (MonthlySchedule) Specifies the monthly schedule settings for the backup policy.
	object or null (YearlySchedule) Specifies the yearly schedule settings for the backup policy.
	object or null (HealthCheckSchedule) [Applies if backup creation is enabled for the backup policy] Specifies the health check schedule settings.

Responses

204

No Content

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

415

Client Error

put/api/v8/policies/virtualMachines/{policyId}

Request samples

Payload
curl

application/json

{"tenantId": "string",
"serviceAccountId": "a814cf67-aaac-43ae-acb4-8d34e82a4b4c",
"regions": [{"regionId": "string"
}
],
"selectedItems": {"subscriptions": [{"subscriptionId": "string"
}
],
"tags": [{"name": "string",
"value": "string"
}
],
"resourceGroups": [{"id": "string"
}
],
"virtualMachines": [{"id": "string"
}
],
"tagGroups": [{"name": "string",
"subscription": {"subscriptionId": "string"
},
"resourceGroup": {"id": "string"
},
"tags": [{"name": "string",
"value": "string"
}
]
}
]
},
"excludedItems": {"virtualMachines": [{"id": "string"
}
],
"tags": [{"name": "string",
"value": "string"
}
]
},
"name": "string",
"description": "string",
"retrySettings": {"retryCount": 0
},
"policyNotificationSettings": {"recipient": "string",
"notifyOnSuccess": true,
"notifyOnWarning": true,
"notifyOnFailure": true
},
"isEnabled": true,
"backupType": "AllSubscriptions",
"snapshotSettings": {"additionalTags": [{"name": "string",
"value": "string"
}
],
"copyOriginalTags": true,
"applicationAwareSnapshot": true,
"userScripts": {"windows": {"scriptsEnabled": true,
"preScriptPath": "string",
"preScriptArguments": "string",
"postScriptPath": "string",
"postScriptArguments": "string",
"repositorySnapshotsOnly": true,
"ignoreExitCodes": true,
"ignoreMissingScripts": true
},
"linux": {"scriptsEnabled": true,
"preScriptPath": "string",
"preScriptArguments": "string",
"postScriptPath": "string",
"postScriptArguments": "string",
"repositorySnapshotsOnly": true,
"ignoreExitCodes": true,
"ignoreMissingScripts": true
}
}
},
"dailySchedule": {"dailyType": "Everyday",
"selectedDays": ["Sunday"
],
"runsPerHour": 0,
"snapshotSchedule": {"hours": [0
],
"snapshotsToKeep": 0
},
"backupSchedule": {"hours": [0
],
"retention": {"timeRetentionDuration": 0,
"retentionDurationType": "Days"
},
"targetRepositoryId": "string"
}
},
"weeklySchedule": {"startTime": 0,
"snapshotSchedule": {"selectedDays": ["Sunday"
],
"snapshotsToKeep": 0
},
"backupSchedule": {"selectedDays": ["Sunday"
],
"retention": {"timeRetentionDuration": 0,
"retentionDurationType": "Days"
},
"targetRepositoryId": "string"
}
},
"monthlySchedule": {"startTime": 0,
"type": "First",
"dayOfWeek": "Sunday",
"dayOfMonth": 0,
"monthlyLastDay": true,
"snapshotSchedule": {"selectedMonths": ["January"
],
"snapshotsToKeep": 0
},
"backupSchedule": {"selectedMonths": ["January"
],
"retention": {"timeRetentionDuration": 0,
"retentionDurationType": "Days"
},
"targetRepositoryId": "string"
}
},
"yearlySchedule": {"startTime": 0,
"month": "January",
"type": "First",
"dayOfWeek": "Sunday",
"dayOfMonth": 0,
"yearlyLastDay": true,
"retentionYearsCount": 0,
"targetRepositoryId": "string"
},
"healthCheckSchedule": {"healthCheckEnabled": true,
"localTime": "2019-08-24T14:15:22Z",
"dayNumberInMonth": "First",
"daysOfWeek": ["Sunday"
],
"dayOfMonth": 0,
"months": ["January"
]
}
}

Response samples

application/problem+json

{"extensions": { },
"status": 0,
"title": "string",
"detail": "string",
"type": "string"
}

Remove Backup Policy

The HTTP DELETE request to the /policies/virtualMachines/{policyId}endpoint removes a specific Azure VM schedule-based backup policy from the Veeam Backup for Microsoft Azure configuration database.

SecurityBearer

Request

path Parameters

policyId

required

string <uuid>

Specifies the system ID assigned in the Veeam Backup for Microsoft Azure REST API to a backup policy.

Responses

204

No Content

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

409

Conflict

delete/api/v8/policies/virtualMachines/{policyId}

Request samples

curl

curl -i -X DELETE \
  'https://123.123.123.123/api/v8/policies/virtualMachines/{policyId}' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Response samples

application/problem+json

{"detail": "string",
"errors": {"property1": ["string"
],
"property2": ["string"
]
},
"status": 0,
"title": "string",
"traceId": "string",
"type": "string"
}

Get Resources Selected for Backup Policy

The HTTP GET request to the /policies/virtualMachines/{policyId}/selectedItems endpoint retrieves information on resources protected by an Azure VM schedule-based backup policy with the specified ID.

SecurityBearer

Request

path Parameters

policyId

required

string <uuid>

Specifies the system ID assigned in the Veeam Backup for Microsoft Azure REST API to a backup policy.

query Parameters

Offset	integer <int32> >= 0 Specifies the first N items of a resource collection that will be excluded from the response. x-veeam-parameter-group: Veeam.Azure.REST.RequestQuery.V2.PageProperties
Limit	integer <int32> >= -1 Specifies the maximum number of items of a resource collection that will be returned in the response. x-veeam-parameter-group: Veeam.Azure.REST.RequestQuery.V2.PageProperties

Responses

200

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

get/api/v8/policies/virtualMachines/{policyId}/selectedItems

Request samples

curl

curl -i -X GET \
  'https://123.123.123.123/api/v8/policies/virtualMachines/{policyId}/selectedItems?Offset=0&Limit=-1' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Response samples

application/json

{"offset": 0,
"limit": 0,
"totalCount": 0,
"_links": {"property1": {"href": "http://example.com"
},
"property2": {"href": "http://example.com"
}
},
"results": [{"subscription": {"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"environment": "Global",
"tenantId": "string",
"tenantName": "string",
"name": "string",
"status": "Active",
"availability": "Available",
"workerResourceGroupName": "string",
"_links": {"property1": {"href": "http://example.com"
},
"property2": {"href": "http://example.com"
}
}
},
"tag": {"id": "string",
"name": "string",
"value": "string"
},
"resourceGroup": {"id": "string",
"resourceId": "string",
"name": "string",
"azureEnvironment": "Global",
"subscriptionId": "d079718b-ff63-45dd-947b-4950c023750f",
"tenantId": "string",
"regionId": "string",
"_links": {"property1": {"href": "http://example.com"
},
"property2": {"href": "http://example.com"
}
}
},
"virtualMachine": {"id": "string",
"azureId": "string",
"name": "string",
"azureEnvironment": "Global",
"osType": "Windows",
"regionDisplayName": "string",
"regionName": "string",
"totalSizeInGB": 0,
"vmSize": "string",
"dnsName": "string",
"virtualNetwork": "string",
"subnet": "string",
"publicIP": "string",
"privateIP": "string",
"hasEphemeralOsDisk": true,
"availabilityZone": "string",
"isController": true,
"isDeleted": true,
"subscriptionId": "d079718b-ff63-45dd-947b-4950c023750f",
"subscriptionName": "string",
"tenantId": "string",
"resourceGroupName": "string",
"_links": {"property1": {"href": "http://example.com"
},
"property2": {"href": "http://example.com"
}
}
},
"deletedItem": {"type": "Subscription",
"name": "string",
"id": "string",
"tagValue": "string",
"tagName": "string"
},
"tagGroup": {"name": "string",
"subscription": {"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"environment": "Global",
"tenantId": "string",
"tenantName": "string",
"name": "string",
"status": "Active",
"availability": "Available",
"workerResourceGroupName": "string",
"_links": {"property1": {"href": "http://example.com"
},
"property2": {"href": "http://example.com"
}
}
},
"resourceGroup": {"id": "string",
"resourceId": "string",
"name": "string",
"azureEnvironment": "Global",
"subscriptionId": "d079718b-ff63-45dd-947b-4950c023750f",
"tenantId": "string",
"regionId": "string",
"_links": {"property1": {"href": "http://example.com"
},
"property2": {"href": "http://example.com"
}
}
},
"tags": [{"id": "string",
"name": "string",
"value": "string"
}
]
}
}
]
}

Get Azure Regions Specified in Policy Settings

The HTTP GET request to the /policies/virtualMachines/{policyId}/regions retrieves a list of Azure regions added to an Azure VM schedule-based backup policy with the specified ID.

SecurityBearer

Request

path Parameters

policyId

required

string <uuid>

Specifies the system ID assigned in the Veeam Backup for Microsoft Azure REST API to a backup policy.

query Parameters

Offset	integer <int32> >= 0 Specifies the first N items of a resource collection that will be excluded from the response. x-veeam-parameter-group: Veeam.Azure.REST.RequestQuery.V2.PageProperties
Limit	integer <int32> >= -1 Specifies the maximum number of items of a resource collection that will be returned in the response. x-veeam-parameter-group: Veeam.Azure.REST.RequestQuery.V2.PageProperties

Responses

200

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

get/api/v8/policies/virtualMachines/{policyId}/regions

Request samples

curl

curl -i -X GET \
  'https://123.123.123.123/api/v8/policies/virtualMachines/{policyId}/regions?Offset=0&Limit=-1' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Response samples

application/json

{"offset": 0,
"limit": 0,
"totalCount": 0,
"_links": {"property1": {"href": "http://example.com"
},
"property2": {"href": "http://example.com"
}
},
"results": [{"id": "string",
"name": "string",
"resourceId": "string"
}
]
}

Get Resources Excluded from Backup Policy

The HTTP GET request to the /policies/virtualMachines/{policyId}/excludedItems endpoint retrieves a list of Azure VMs excluded from an Azure VM schedule-based backup policy with the specified ID.

SecurityBearer

Request

path Parameters

policyId

required

string <uuid>

Specifies the system ID assigned to a backup policy in the Veeam Backup for Microsoft Azure REST API.

query Parameters

Offset	integer <int32> >= 0 Specifies the first N items of a resource collection that will be excluded from the response. x-veeam-parameter-group: Veeam.Azure.REST.RequestQuery.V2.PageProperties
Limit	integer <int32> >= -1 Specifies the maximum number of items of a resource collection that will be returned in the response. x-veeam-parameter-group: Veeam.Azure.REST.RequestQuery.V2.PageProperties
NameSearchPattern	string or null Returns only those items of a resource collection whose names match the specified search pattern in the parameter value. x-veeam-parameter-group: PolicyExcludedItemOptions

Responses

200

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

get/api/v8/policies/virtualMachines/{policyId}/excludedItems

Request samples

curl

curl -i -X GET \
  'https://123.123.123.123/api/v8/policies/virtualMachines/{policyId}/excludedItems?Offset=0&Limit=-1&NameSearchPattern=string' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Response samples

application/json

{"offset": 0,
"limit": 0,
"totalCount": 0,
"_links": {"property1": {"href": "http://example.com"
},
"property2": {"href": "http://example.com"
}
},
"results": [{"virtualMachine": {"id": "string",
"azureId": "string",
"name": "string",
"azureEnvironment": "Global",
"osType": "Windows",
"regionDisplayName": "string",
"regionName": "string",
"totalSizeInGB": 0,
"vmSize": "string",
"dnsName": "string",
"virtualNetwork": "string",
"subnet": "string",
"publicIP": "string",
"privateIP": "string",
"hasEphemeralOsDisk": true,
"availabilityZone": "string",
"isController": true,
"isDeleted": true,
"subscriptionId": "d079718b-ff63-45dd-947b-4950c023750f",
"subscriptionName": "string",
"tenantId": "string",
"resourceGroupName": "string",
"_links": {"property1": {"href": "http://example.com"
},
"property2": {"href": "http://example.com"
}
}
},
"deletedItem": {"type": "Subscription",
"name": "string",
"id": "string",
"tagValue": "string",
"tagName": "string"
},
"tag": {"id": "string",
"name": "string",
"value": "string"
}
}
]
}

Set Backup Policy Priority

The HTTP POST request to the /policies/virtualMachines/orderPriorities endpoint sets the priority order for Azure VM schedule-based backup policies.

SecurityBearer

Request

Request Body schema: application/json

Array

string <uuid>

Specifies system IDs assigned in the Veeam Backup for Microsoft Azure REST API to backup policies in the specified order.

Responses

204

No Content

400

Bad Request

401

Unauthorized

403

Forbidden

415

Client Error

post/api/v8/policies/virtualMachines/orderPriorities

Request samples

Payload
curl

application/json

["497f6eca-6276-4993-bfeb-53cbbbba6f08"
]

Response samples

application/problem+json

{"extensions": { },
"status": 0,
"title": "string",
"detail": "string",
"type": "string"
}

Enable Backup Policy

The HTTP POST request to the /policies/virtualMachines/{policyId}/enable endpoint enables a disabled Azure VM schedule-based backup policy with the specified ID.

SecurityBearer

Request

path Parameters

policyId

required

string <uuid>

Specifies the system ID assigned to a backup policy in the Veeam Backup for Microsoft Azure REST API.

Responses

204

No Content

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

post/api/v8/policies/virtualMachines/{policyId}/enable

Request samples

curl

curl -i -X POST \
  'https://123.123.123.123/api/v8/policies/virtualMachines/{policyId}/enable' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Response samples

application/problem+json

{"detail": "string",
"errors": {"property1": ["string"
],
"property2": ["string"
]
},
"status": 0,
"title": "string",
"traceId": "string",
"type": "string"
}

Disable Backup Policy

The HTTP POST request to the /policies/virtualMachines/{policyId}/disable endpoint disables an enabled Azure VM schedule-based backup policy with the specified ID.

SecurityBearer

Request

path Parameters

policyId

required

string <uuid>

Specifies the system ID assigned to a backup policy in the Veeam Backup for Microsoft Azure REST API.

Responses

204

No Content

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

post/api/v8/policies/virtualMachines/{policyId}/disable

Request samples

curl

curl -i -X POST \
  'https://123.123.123.123/api/v8/policies/virtualMachines/{policyId}/disable' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Response samples

application/problem+json

{"detail": "string",
"errors": {"property1": ["string"
],
"property2": ["string"
]
},
"status": 0,
"title": "string",
"traceId": "string",
"type": "string"
}

Start Backup Policy

The HTTP POST request to the /policies/virtualMachines/{policyId}/start endpoint launches an Azure VM schedule-based backup policy with the specified ID.

SecurityBearer

Request

path Parameters

policyId

required

string <uuid>

Specifies the system ID assigned to a backup policy in the Veeam Backup for Microsoft Azure REST API.

Responses

202

Accepted

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

409

Conflict

post/api/v8/policies/virtualMachines/{policyId}/start

Request samples

curl

curl -i -X POST \
  'https://123.123.123.123/api/v8/policies/virtualMachines/{policyId}/start' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Response samples

application/json

[{"id": "string",
"type": "BackupRetention",
"localizedType": "string",
"executionStartTime": "2019-08-24T14:15:22Z",
"executionStopTime": "2019-08-24T14:15:22Z",
"executionDuration": "string",
"status": "Canceled",
"backupJobInfo": {"policyId": "2f5573e6-5ba4-48f2-a75d-df99c936463b",
"policyName": "string",
"policyType": "VirtualMachines",
"protectedInstancesCount": 0,
"policyRemoved": true
},
"healthCheckJobInfo": {"policyId": "2f5573e6-5ba4-48f2-a75d-df99c936463b",
"policyName": "string",
"checkedInstancesCount": 0,
"policyRemoved": true
},
"restoreJobInfo": {"reason": "string",
"backupPolicyDisplayName": "string"
},
"fileLevelRestoreJobInfo": {"initiator": "string",
"reason": "string",
"flrLink": {"url": "string",
"thumbprint": "string"
},
"vmId": "string",
"vmName": "string",
"backupPolicyDisplayName": "string",
"restorePointCreatedDateUtc": "2019-08-24T14:15:22Z",
"isFlrSessionReady": true
},
"fileShareFileLevelRestoreJobInfo": {"initiator": "string",
"reason": "string",
"flrLink": {"url": "string",
"thumbprint": "string"
},
"fileShareId": "string",
"fileShareName": "string",
"backupPolicyDisplayName": "string",
"restorePointCreatedDateUtc": "2019-08-24T14:15:22Z"
},
"repositoryJobInfo": {"repositoryId": "string",
"repositoryName": "string",
"repositoryRemoved": true
},
"restorePointDataRetrievalJobInfo": {"restorePointId": "8c843d10-6d0f-4abe-b898-e1ba18b94f68",
"sqlRestorePointId": "859c4224-81c0-43b0-8c6a-f09eb203fa33",
"cosmosDbRestorePointId": "10233446-f8f4-4379-8a69-f08231b4f7b6",
"initiator": "string",
"instanceName": "string",
"daysToKeep": 0,
"dataRetrievalPriority": "Normal"
},
"retentionJobInfo": {"deletedRestorePointsCount": 0
},
"_links": {"property1": {"href": "http://example.com"
},
"property2": {"href": "http://example.com"
}
}
}
]

Stop Backup Policy

The HTTP POST request to the /policies/virtualMachines/{policyId}/stop endpoint stops execution of an Azure VM schedule-based backup policy with the specified ID.

SecurityBearer

Request

path Parameters

policyId

required

string <uuid>

Specifies the system ID assigned to a backup policy in the Veeam Backup for Microsoft Azure REST API.

Responses

204

No Content

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

post/api/v8/policies/virtualMachines/{policyId}/stop

Request samples

curl

curl -i -X POST \
  'https://123.123.123.123/api/v8/policies/virtualMachines/{policyId}/stop' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Response samples

application/problem+json

{"detail": "string",
"errors": {"property1": ["string"
],
"property2": ["string"
]
},
"status": 0,
"title": "string",
"traceId": "string",
"type": "string"
}

Resets Backup Policy CBT

The HTTP POST request to the /policies/virtualMachines/{policyId}/resetCbt endpoint resets the changed block tracking (CBT) mechanism for the Azure VM schedule-based backup policy with the specified ID.

SecurityBearer

Request

path Parameters

policyId

required

string <uuid>

Specifies the system ID assigned to a backup policy in the Veeam Backup for Microsoft Azure REST API.

Responses

204

No Content

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

post/api/v8/policies/virtualMachines/{policyId}/resetCbt

Request samples

curl

curl -i -X POST \
  'https://123.123.123.123/api/v8/policies/virtualMachines/{policyId}/resetCbt' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Response samples

application/problem+json

{"detail": "string",
"errors": {"property1": ["string"
],
"property2": ["string"
]
},
"status": 0,
"title": "string",
"traceId": "string",
"type": "string"
}

Export Backup Policies

The HTTP POST request to the /policies/virtualMachines/export endpoint exports a list of Azure VM schedule-based backup policies created in Veeam Backup for Microsoft Azure to a .CSV or an .XML file.

x-veeam-custom-response: true

SecurityBearer

Request

header Parameters

string or null

Specifies a media type of representation of the exported data. The default value is text/csv media type.

Request Body schema: application/json

policyIds	Array of strings or null <uuid> Specifies system IDs assigned in the Veeam Backup for Microsoft Azure REST API to Azure VM schedule-based backup policies whose data will be exported.
policyName	string or null Exports only data on a backup policy with the specified name.
lastJobStatus	Array of strings or null (JobStatus) Exports only data on backup policies with the specified latest backup session statuses. Enum: "Canceled" "Canceling" "Error" "NeverExecuted" "Running" "RunningWithError" "RunningWithWarning" "Success" "Warning" "Pending" "Unknown" x-veeam-model-binder: Veeam.Azure.REST.RequestQuery.V2.CsvModelBinder<Veeam.Azure.REST.Latest.JobStatus>
policyStatus	Array of strings or null (PolicyStatus) Exports only data on backup policies with the specified statuses. Enum: "Enabled" "Disabled" "Unknown" x-veeam-model-binder: Veeam.Azure.REST.RequestQuery.V2.CsvModelBinder<Veeam.Azure.REST.Latest.PolicyStatus>

Responses

200

401

Unauthorized

403

Forbidden

post/api/v8/policies/virtualMachines/export

Request samples

Payload
curl

application/json

{"policyIds": ["497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"policyName": "string",
"lastJobStatus": ["Canceled"
],
"policyStatus": ["Enabled"
]
}

Response samples

application/problem+json

{"extensions": { },
"status": 0,
"title": "string",
"type": "string",
"licenseAgreementAcceptanceRequired": true
}

Get Collection of Protected Items

The HTTP GET request to the /policies/virtualMachines/protectedItems endpoint retrieves a list of Azure VMs that are protected by backup policies configured in Veeam Backup for Microsoft Azure.

SecurityBearer

Request

query Parameters

Offset	integer <int32> >= 0 Specifies the first N items of a resource collection that will be excluded from the response. x-veeam-parameter-group: Veeam.Azure.REST.RequestQuery.V2.PageProperties
Limit	integer <int32> >= -1 Specifies the maximum number of items of a resource collection that will be returned in the response. x-veeam-parameter-group: Veeam.Azure.REST.RequestQuery.V2.PageProperties

Responses

200

401

Unauthorized

403

Forbidden

get/api/v8/policies/virtualMachines/protectedItems

Request samples

curl

curl -i -X GET \
  'https://123.123.123.123/api/v8/policies/virtualMachines/protectedItems?Offset=0&Limit=-1' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Response samples

application/json

{"offset": 0,
"limit": 0,
"totalCount": 0,
"_links": {"property1": {"href": "http://example.com"
},
"property2": {"href": "http://example.com"
}
},
"results": [{"resourceId": "string",
"policyId": "2f5573e6-5ba4-48f2-a75d-df99c936463b",
"subscriptionId": "d079718b-ff63-45dd-947b-4950c023750f"
}
]
}

Get Resources Protected by Backup Policy

The HTTP GET request to the /policies/virtualMachines/{policyId}/protectedItems endpoint retrieves a list of Azure VMs protected by a backup policy with the specified ID.

SecurityBearer

Request

path Parameters

policyId

required

string <uuid>

Specifies the system ID assigned to a backup policy in the Veeam Backup for Microsoft Azure REST API.

query Parameters

Offset	integer <int32> >= 0 Specifies the first N items of a resource collection that will be excluded from the response. x-veeam-parameter-group: Veeam.Azure.REST.RequestQuery.V2.PageProperties
Limit	integer <int32> >= -1 Specifies the maximum number of items of a resource collection that will be returned in the response. x-veeam-parameter-group: Veeam.Azure.REST.RequestQuery.V2.PageProperties

Responses

200

401

Unauthorized

403

Forbidden

get/api/v8/policies/virtualMachines/{policyId}/protectedItems

Request samples

curl

curl -i -X GET \
  'https://123.123.123.123/api/v8/policies/virtualMachines/{policyId}/protectedItems?Offset=0&Limit=-1' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Response samples

application/json

{"offset": 0,
"limit": 0,
"totalCount": 0,
"_links": {"property1": {"href": "http://example.com"
},
"property2": {"href": "http://example.com"
}
},
"results": [{"resourceId": "string",
"policyId": "2f5573e6-5ba4-48f2-a75d-df99c936463b",
"subscriptionId": "d079718b-ff63-45dd-947b-4950c023750f"
}
]
}

Azure VM Schedule-Based Backup Policies

Get Collection of Azure VM Schedule-Based Backup Policies

query Parameters

Create Backup Policy

Request Body schema: application/jsonrequired

Get Backup Policy Data

path Parameters

Modify Backup Policy

path Parameters

Request Body schema: application/jsonrequired

Remove Backup Policy

path Parameters

Get Resources Selected for Backup Policy

path Parameters

query Parameters

Get Azure Regions Specified in Policy Settings

path Parameters

query Parameters

Get Resources Excluded from Backup Policy

path Parameters

query Parameters

Set Backup Policy Priority

Request Body schema: application/json

Enable Backup Policy

path Parameters

Disable Backup Policy

path Parameters

Start Backup Policy

path Parameters

Stop Backup Policy

path Parameters

Resets Backup Policy CBT

path Parameters

Export Backup Policies

header Parameters

Request Body schema: application/json

Get Collection of Protected Items

query Parameters

Get Resources Protected by Backup Policy

path Parameters

query Parameters

Request Body schema: application/json
required

Request Body schema: application/json
required