File Share Backup Policies

The /policies/fileShares resource collection represents file share backup policies configured in Veeam Backup for Microsoft Azure.

Get Collection of File Share Backup Policies

The HTTP GET request to the /policies/fileShares endpoint retrieves a list of file share 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: FileSharePolicyQueryOptions
FileShareId	string or null Returns only backup policies that protect an Azure file share with the specified ID. x-veeam-parameter-group: FileSharePolicyQueryOptions
LastJobStatus	Array of strings or null (JobStatus) Returns only backup policies with the specified status of the latest session. Enum: "Canceled" "Canceling" "Error" "NeverExecuted" "Running" "RunningWithError" "RunningWithWarning" "Success" "Warning" "Pending" "Unknown" x-veeam-parameter-group: FileSharePolicyQueryOptions x-veeam-model-binder: Veeam.Azure.REST.RequestQuery.V2.CsvModelBinder<Veeam.Azure.REST.Latest.JobStatus>
PolicyStatus	Array of strings or null (PolicyStatus) Returns only backup policies with the specified status. Enum: "Enabled" "Disabled" "Unknown" x-veeam-parameter-group: FileSharePolicyQueryOptions x-veeam-model-binder: Veeam.Azure.REST.RequestQuery.V2.CsvModelBinder<Veeam.Azure.REST.Latest.PolicyStatus>
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/fileShares

Request samples

curl

curl -i -X GET \
  'https://123.123.123.123/api/v8/policies/fileShares?PolicyName=string&FileShareId=string&LastJobStatus=Canceled&PolicyStatus=Enabled&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,
"tenantId": "string",
"serviceAccountId": "a814cf67-aaac-43ae-acb4-8d34e82a4b4c",
"snapshotStatus": "Canceled",
"indexingStatus": "Canceled",
"nextExecutionTime": "2019-08-24T14:15:22Z",
"_links": {"property1": {"href": "http://example.com"
},
"property2": {"href": "http://example.com"
}
},
"name": "string",
"description": "string",
"isScheduleConfigured": true,
"retrySettings": {"retryCount": 0
},
"policyNotificationSettings": {"recipient": "string",
"notifyOnSuccess": true,
"notifyOnWarning": true,
"notifyOnFailure": true
},
"isEnabled": true,
"enableIndexing": true,
"backupType": "AllSubscriptions",
"dailySchedule": {"dailyType": "Everyday",
"selectedDays": ["Sunday"
],
"runsPerHour": 0,
"snapshotSchedule": {"hours": [0
],
"snapshotsToKeep": 0
}
},
"weeklySchedule": {"startTime": 0,
"snapshotSchedule": {"selectedDays": ["Sunday"
],
"snapshotsToKeep": 0
}
},
"monthlySchedule": {"startTime": 0,
"type": "First",
"dayOfWeek": "Sunday",
"dayOfMonth": 0,
"monthlyLastDay": true,
"snapshotSchedule": {"selectedMonths": ["January"
],
"snapshotsToKeep": 0
}
}
}
]
}

Create Backup Policy

The HTTP POST request to the /policies/fileShares endpoint creates a new file share backup policy.

SecurityBearer

Request

Request Body schema: application/json
required

backupType required	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
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 Azure regions where the resources that will be backed up reside.
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 file shares.
	object or null (FileSharePolicyBackupItemsFromClient) [Applies if the SelectedItems value is specified for the `backupType` parameter] Specifies information on Azure resources to protect by the backup policy. x-veeam-namespace: Veeam.Azure.REST.Latest.Representation.FileSharePolicies.FromClient
	object or null (FileSharePolicyExcludedItemsFromClient) Specifies Azure file shares to exclude from the backup scope. x-veeam-namespace: Veeam.Azure.REST.Latest.Representation.FileSharePolicies.FromClient
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.
enableIndexing	boolean or null Defines whether to perform indexing of the processed Azure file shares.
	object or null (DailyFileShareSchedule) Specifies daily schedule settings for the backup policy. x-veeam-namespace: Veeam.Azure.REST.Latest.Representation.FileSharePolicies.Schedules
	object or null (WeeklyFileShareSchedule) Specifies weekly schedule settings for the backup policy. x-veeam-namespace: Veeam.Azure.REST.Latest.Representation.FileSharePolicies.Schedules
	object or null (MonthlyFileShareSchedule) Specifies monthly schedule settings for the backup policy. x-veeam-namespace: Veeam.Azure.REST.Latest.Representation.FileSharePolicies.Schedules

Responses

201

Created

400

Bad Request

401

Unauthorized

403

Forbidden

415

Client Error

post/api/v8/policies/fileShares

Request samples

Payload
curl

application/json

{"tenantId": "string",
"serviceAccountId": "a814cf67-aaac-43ae-acb4-8d34e82a4b4c",
"regions": [{"regionId": "string"
}
],
"selectedItems": {"fileShares": [{"id": "string"
}
],
"storageAccounts": [{"id": "string"
}
],
"resourceGroups": [{"id": "string"
}
]
},
"excludedItems": {"fileShares": [{"id": "string"
}
]
},
"name": "string",
"description": "string",
"retrySettings": {"retryCount": 0
},
"policyNotificationSettings": {"recipient": "string",
"notifyOnSuccess": true,
"notifyOnWarning": true,
"notifyOnFailure": true
},
"isEnabled": true,
"enableIndexing": true,
"backupType": "AllSubscriptions",
"dailySchedule": {"dailyType": "Everyday",
"selectedDays": ["Sunday"
],
"runsPerHour": 0,
"snapshotSchedule": {"hours": [0
],
"snapshotsToKeep": 0
}
},
"weeklySchedule": {"startTime": 0,
"snapshotSchedule": {"selectedDays": ["Sunday"
],
"snapshotsToKeep": 0
}
},
"monthlySchedule": {"startTime": 0,
"type": "First",
"dayOfWeek": "Sunday",
"dayOfMonth": 0,
"monthlyLastDay": true,
"snapshotSchedule": {"selectedMonths": ["January"
],
"snapshotsToKeep": 0
}
}
}

Response samples

application/json

{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"priority": 0,
"tenantId": "string",
"serviceAccountId": "a814cf67-aaac-43ae-acb4-8d34e82a4b4c",
"snapshotStatus": "Canceled",
"indexingStatus": "Canceled",
"nextExecutionTime": "2019-08-24T14:15:22Z",
"_links": {"property1": {"href": "http://example.com"
},
"property2": {"href": "http://example.com"
}
},
"name": "string",
"description": "string",
"isScheduleConfigured": true,
"retrySettings": {"retryCount": 0
},
"policyNotificationSettings": {"recipient": "string",
"notifyOnSuccess": true,
"notifyOnWarning": true,
"notifyOnFailure": true
},
"isEnabled": true,
"enableIndexing": true,
"backupType": "AllSubscriptions",
"dailySchedule": {"dailyType": "Everyday",
"selectedDays": ["Sunday"
],
"runsPerHour": 0,
"snapshotSchedule": {"hours": [0
],
"snapshotsToKeep": 0
}
},
"weeklySchedule": {"startTime": 0,
"snapshotSchedule": {"selectedDays": ["Sunday"
],
"snapshotsToKeep": 0
}
},
"monthlySchedule": {"startTime": 0,
"type": "First",
"dayOfWeek": "Sunday",
"dayOfMonth": 0,
"monthlyLastDay": true,
"snapshotSchedule": {"selectedMonths": ["January"
],
"snapshotsToKeep": 0
}
}
}

Get Backup Policy Data

The HTTP GET request to the /policies/fileShares/{policyId} endpoint retrieves information on a file share 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/fileShares/{policyId}

Request samples

curl

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

Response samples

application/json

{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"priority": 0,
"tenantId": "string",
"serviceAccountId": "a814cf67-aaac-43ae-acb4-8d34e82a4b4c",
"snapshotStatus": "Canceled",
"indexingStatus": "Canceled",
"nextExecutionTime": "2019-08-24T14:15:22Z",
"_links": {"property1": {"href": "http://example.com"
},
"property2": {"href": "http://example.com"
}
},
"name": "string",
"description": "string",
"isScheduleConfigured": true,
"retrySettings": {"retryCount": 0
},
"policyNotificationSettings": {"recipient": "string",
"notifyOnSuccess": true,
"notifyOnWarning": true,
"notifyOnFailure": true
},
"isEnabled": true,
"enableIndexing": true,
"backupType": "AllSubscriptions",
"dailySchedule": {"dailyType": "Everyday",
"selectedDays": ["Sunday"
],
"runsPerHour": 0,
"snapshotSchedule": {"hours": [0
],
"snapshotsToKeep": 0
}
},
"weeklySchedule": {"startTime": 0,
"snapshotSchedule": {"selectedDays": ["Sunday"
],
"snapshotsToKeep": 0
}
},
"monthlySchedule": {"startTime": 0,
"type": "First",
"dayOfWeek": "Sunday",
"dayOfMonth": 0,
"monthlyLastDay": true,
"snapshotSchedule": {"selectedMonths": ["January"
],
"snapshotsToKeep": 0
}
}
}

Modify Backup Policy

The HTTP PUT request to the /policies/fileShares/{policyId} endpoint updates settings of a file share 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

backupType required	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
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 file shares reside.
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 file shares.
	object or null (FileSharePolicyBackupItemsFromClient) [Applies if the SelectedItems value is specified for the `backupType` parameter] Specifies information on Azure resources to protect by the backup policy. x-veeam-namespace: Veeam.Azure.REST.Latest.Representation.FileSharePolicies.FromClient
	object or null (FileSharePolicyExcludedItemsFromClient) Specifies Azure file shares to exclude from the backup scope. x-veeam-namespace: Veeam.Azure.REST.Latest.Representation.FileSharePolicies.FromClient
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.
enableIndexing	boolean or null Defines whether to perform indexing of the processed Azure file shares.
	object or null (DailyFileShareSchedule) Specifies daily schedule settings for the backup policy. x-veeam-namespace: Veeam.Azure.REST.Latest.Representation.FileSharePolicies.Schedules
	object or null (WeeklyFileShareSchedule) Specifies weekly schedule settings for the backup policy. x-veeam-namespace: Veeam.Azure.REST.Latest.Representation.FileSharePolicies.Schedules
	object or null (MonthlyFileShareSchedule) Specifies monthly schedule settings for the backup policy. x-veeam-namespace: Veeam.Azure.REST.Latest.Representation.FileSharePolicies.Schedules

Responses

200

204

No Content

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

415

Client Error

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

Request samples

Payload
curl

application/json

{"tenantId": "string",
"serviceAccountId": "a814cf67-aaac-43ae-acb4-8d34e82a4b4c",
"regions": [{"regionId": "string"
}
],
"selectedItems": {"fileShares": [{"id": "string"
}
],
"storageAccounts": [{"id": "string"
}
],
"resourceGroups": [{"id": "string"
}
]
},
"excludedItems": {"fileShares": [{"id": "string"
}
]
},
"name": "string",
"description": "string",
"retrySettings": {"retryCount": 0
},
"policyNotificationSettings": {"recipient": "string",
"notifyOnSuccess": true,
"notifyOnWarning": true,
"notifyOnFailure": true
},
"isEnabled": true,
"enableIndexing": true,
"backupType": "AllSubscriptions",
"dailySchedule": {"dailyType": "Everyday",
"selectedDays": ["Sunday"
],
"runsPerHour": 0,
"snapshotSchedule": {"hours": [0
],
"snapshotsToKeep": 0
}
},
"weeklySchedule": {"startTime": 0,
"snapshotSchedule": {"selectedDays": ["Sunday"
],
"snapshotsToKeep": 0
}
},
"monthlySchedule": {"startTime": 0,
"type": "First",
"dayOfWeek": "Sunday",
"dayOfMonth": 0,
"monthlyLastDay": true,
"snapshotSchedule": {"selectedMonths": ["January"
],
"snapshotsToKeep": 0
}
}
}

Response samples

application/json

{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"priority": 0,
"tenantId": "string",
"serviceAccountId": "a814cf67-aaac-43ae-acb4-8d34e82a4b4c",
"snapshotStatus": "Canceled",
"indexingStatus": "Canceled",
"nextExecutionTime": "2019-08-24T14:15:22Z",
"_links": {"property1": {"href": "http://example.com"
},
"property2": {"href": "http://example.com"
}
},
"name": "string",
"description": "string",
"isScheduleConfigured": true,
"retrySettings": {"retryCount": 0
},
"policyNotificationSettings": {"recipient": "string",
"notifyOnSuccess": true,
"notifyOnWarning": true,
"notifyOnFailure": true
},
"isEnabled": true,
"enableIndexing": true,
"backupType": "AllSubscriptions",
"dailySchedule": {"dailyType": "Everyday",
"selectedDays": ["Sunday"
],
"runsPerHour": 0,
"snapshotSchedule": {"hours": [0
],
"snapshotsToKeep": 0
}
},
"weeklySchedule": {"startTime": 0,
"snapshotSchedule": {"selectedDays": ["Sunday"
],
"snapshotsToKeep": 0
}
},
"monthlySchedule": {"startTime": 0,
"type": "First",
"dayOfWeek": "Sunday",
"dayOfMonth": 0,
"monthlyLastDay": true,
"snapshotSchedule": {"selectedMonths": ["January"
],
"snapshotsToKeep": 0
}
}
}

Remove Backup Policy

The HTTP DELETE request to the /policies/fileShares/{policyId} endpoint deletes a specific file share backup policy from the Veeam Backup for Microsoft Azure configuration database.

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

409

Conflict

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

Request samples

curl

curl -i -X DELETE \
  'https://123.123.123.123/api/v8/policies/fileShares/{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/fileShares/{policyId}/selectedItems endpoint retrieves information on resources protected by a file share 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

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

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

Request samples

curl

curl -i -X GET \
  'https://123.123.123.123/api/v8/policies/fileShares/{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": [{"fileShare": {"id": "string",
"azureId": "string",
"name": "string",
"accessTier": "string",
"regionId": "string",
"regionName": "string",
"storageAccountName": "string",
"resourceGroupName": "string",
"size": 0,
"subscriptionId": "d079718b-ff63-45dd-947b-4950c023750f",
"tenantId": "string",
"_links": {"property1": {"href": "http://example.com"
},
"property2": {"href": "http://example.com"
}
}
},
"storageAccount": {"id": "string",
"resourceId": "string",
"name": "string",
"skuName": "string",
"performance": "Standard",
"redundancy": "Unknown",
"accessTier": "string",
"regionId": "string",
"regionName": "string",
"resourceGroupName": "string",
"removedFromAzure": true,
"supportsTiering": true,
"isImmutableStorage": true,
"isImmutableStoragePolicyLocked": true,
"subscriptionId": "d079718b-ff63-45dd-947b-4950c023750f",
"tenantId": "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"
}
}
},
"deletedItem": {"type": "FileShare",
"name": "string",
"id": "string"
}
}
]
}

Get Azure Regions Specified in Policy Settings

The HTTP GET request to the /policies/fileShares/{policyId}/regions retrieves a list of Azure regions added to a file share 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

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

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

Request samples

curl

curl -i -X GET \
  'https://123.123.123.123/api/v8/policies/fileShares/{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/fileShares/{policyId}/excludedItems endpoint retrieves a list of Azure file shares excluded from a file share 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/fileShares/{policyId}/excludedItems

Request samples

curl

curl -i -X GET \
  'https://123.123.123.123/api/v8/policies/fileShares/{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": [{"fileShare": {"id": "string",
"azureId": "string",
"name": "string",
"accessTier": "string",
"regionId": "string",
"regionName": "string",
"storageAccountName": "string",
"resourceGroupName": "string",
"size": 0,
"subscriptionId": "d079718b-ff63-45dd-947b-4950c023750f",
"tenantId": "string",
"_links": {"property1": {"href": "http://example.com"
},
"property2": {"href": "http://example.com"
}
}
},
"deletedItem": {"type": "FileShare",
"name": "string",
"id": "string"
}
}
]
}

Set Backup Policy Priority

The HTTP POST request to the /policies/fileShares/orderPriorities endpoint sets the priority order for file share 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/fileShares/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/fileShares/{policyId}/enable endpoint enables a disabled file share 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/fileShares/{policyId}/enable

Request samples

curl

curl -i -X POST \
  'https://123.123.123.123/api/v8/policies/fileShares/{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/fileShares/{policyId}/disable endpoint disables an enabled file share 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/fileShares/{policyId}/disable

Request samples

curl

curl -i -X POST \
  'https://123.123.123.123/api/v8/policies/fileShares/{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/fileShares/{policyId}/start endpoint launches a file share 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/fileShares/{policyId}/start

Request samples

curl

curl -i -X POST \
  'https://123.123.123.123/api/v8/policies/fileShares/{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/fileShares/{policyId}/stop endpoint stops execution of a file share 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/fileShares/{policyId}/stop

Request samples

curl

curl -i -X POST \
  'https://123.123.123.123/api/v8/policies/fileShares/{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"
}

Export Backup Policies

The HTTP POST request to the /policies/fileShares/export endpoint exports a list of file share 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 the system IDs assigned in the Veeam Backup for Microsoft Azure REST API to the file share backup policies whose data will be exported.
policyName	string or null Exports only data on the backup policy with the specified name.
lastJobStatus	Array of strings or null (JobStatus) Exports only data on backup policies with the specified status of the latest session. 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 the 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/fileShares/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/fileShares/protectedItems endpoint retrieves a list of file shares 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/fileShares/protectedItems

Request samples

curl

curl -i -X GET \
  'https://123.123.123.123/api/v8/policies/fileShares/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/fileShares/{policyId}/protectedItems endpoint retrieves a list of Azure file shares 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/fileShares/{policyId}/protectedItems

Request samples

curl

curl -i -X GET \
  'https://123.123.123.123/api/v8/policies/fileShares/{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"
}
]
}

File Share Backup Policies

Get Collection of File Share 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

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