Skip to main content

backup_instances

Creates, updates, deletes, gets or lists a backup_instances resource.

Overview

Namebackup_instances
TypeResource
Idazure.data_protection.backup_instances

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringFully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}.
namestringThe name of the resource.
currentProtectionStatestringSpecifies the current protection state of the resource. Known values are: "Invalid", "NotProtected", "ConfiguringProtection", "ProtectionConfigured", "BackupSchedulesSuspended", "RetentionSchedulesSuspended", "ProtectionStopped", "ProtectionError", "ConfiguringProtectionFailed", "SoftDeleting", "SoftDeleted", and "UpdatingProtection". (Invalid, NotProtected, ConfiguringProtection, ProtectionConfigured, BackupSchedulesSuspended, RetentionSchedulesSuspended, ProtectionStopped, ProtectionError, ConfiguringProtectionFailed, SoftDeleting, SoftDeleted, UpdatingProtection)
dataSourceInfoobjectGets or sets the data source information. Required.
dataSourceSetInfoobjectGets or sets the data source set information.
datasourceAuthCredentialsobjectCredentials to use to authenticate with data source provider.
friendlyNamestringGets or sets the Backup Instance friendly name.
identityDetailsobjectContains information of the Identity Details for the BI. If it is null, default will be considered as System Assigned.
objectTypestringRequired.
policyInfoobjectGets or sets the policy information. Required.
protectionErrorDetailsobjectSpecifies the protection error of the resource.
protectionStatusobjectSpecifies the protection status of the resource.
provisioningStatestringSpecifies the provisioning state of the resource i.e. provisioning/updating/Succeeded/Failed.
resourceGuardOperationRequestsarrayResourceGuardOperationRequests on which LAC check will be performed.
systemDataobjectAzure Resource Manager metadata containing createdBy and modifiedBy information.
tagsobjectProxy Resource tags.
typestringThe type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts".
validationTypestringSpecifies the type of validation. In case of DeepValidation, all validations from /validateForBackup API will run again. Known values are: "ShallowValidation" and "DeepValidation". (ShallowValidation, DeepValidation)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_backup_instance_operation_resultselectresource_group_name, vault_name, backup_instance_name, operation_id, subscription_idGet result of backup instance creation operation.
getselectresource_group_name, vault_name, backup_instance_name, subscription_idGets a backup instance with name in a backup vault.
listselectresource_group_name, vault_name, subscription_idGets a backup instances belonging to a backup vault.
create_or_updateinsertresource_group_name, vault_name, backup_instance_name, subscription_idx-ms-authorization-auxiliaryCreate or update a backup instance in a backup vault.
create_or_updatereplaceresource_group_name, vault_name, backup_instance_name, subscription_idx-ms-authorization-auxiliaryCreate or update a backup instance in a backup vault.
deletedeleteresource_group_name, vault_name, backup_instance_name, subscription_idx-ms-authorization-auxiliaryDelete a backup instance in a backup vault.
validate_for_backupexecresource_group_name, vault_name, subscription_id, backupInstanceValidate whether adhoc backup will be successful or not.
adhoc_backupexecresource_group_name, vault_name, backup_instance_name, subscription_id, backupRuleOptionsTrigger adhoc backup.
validate_for_modify_backupexecresource_group_name, vault_name, backup_instance_name, subscription_id, backupInstanceValidate whether update for backup instance will be successful or not.
trigger_rehydrateexecresource_group_name, vault_name, backup_instance_name, subscription_id, recoveryPointId, rehydrationRetentionDurationrehydrate recovery point for restore for a BackupInstance.
trigger_restoreexecresource_group_name, vault_name, backup_instance_name, subscription_id, objectType, restoreTargetInfo, sourceDataStoreTypex-ms-authorization-auxiliaryTriggers restore for a BackupInstance.
resume_backupsexecresource_group_name, vault_name, backup_instance_name, subscription_idThis operation will resume backups for backup instance.
resume_protectionexecresource_group_name, vault_name, backup_instance_name, subscription_idThis operation will resume protection for a stopped backup instance.
stop_protectionexecresource_group_name, vault_name, backup_instance_name, subscription_idx-ms-authorization-auxiliaryThis operation will stop protection of a backup instance and data will be held forever.
suspend_backupsexecresource_group_name, vault_name, backup_instance_name, subscription_idx-ms-authorization-auxiliaryThis operation will stop backup for a backup instance and retains the backup data as per the policy (except latest Recovery point, which will be retained forever).
sync_backup_instanceexecresource_group_name, vault_name, backup_instance_name, subscription_idSync backup instance again in case of failure This action will retry last failed operation and will bring backup instance to valid state.
validate_for_restoreexecresource_group_name, vault_name, backup_instance_name, subscription_id, restoreRequestObjectValidates if Restore can be triggered for a DataSource.
trigger_cross_region_restoreexecresource_group_name, location, subscription_id, restoreRequestObject, crossRegionRestoreDetailsTriggers Cross Region Restore for BackupInstance.
validate_cross_region_restoreexecresource_group_name, location, subscription_id, restoreRequestObject, crossRegionRestoreDetailsValidates whether Cross Region Restore can be triggered for DataSource.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
backup_instance_namestringThe name of the BackupInstanceResource. Required.
locationstringThe name of the Azure region. Required.
operation_idstringThe name of the BackupInstanceResource. Required.
resource_group_namestringThe name of the resource group. The name is case insensitive. Required.
subscription_idstring
vault_namestringThe name of the backup vault. Required.
x-ms-authorization-auxiliarystringDefault value is None.

SELECT examples

Get result of backup instance creation operation.

SELECT
id,
name,
currentProtectionState,
dataSourceInfo,
dataSourceSetInfo,
datasourceAuthCredentials,
friendlyName,
identityDetails,
objectType,
policyInfo,
protectionErrorDetails,
protectionStatus,
provisioningState,
resourceGuardOperationRequests,
systemData,
tags,
type,
validationType
FROM azure.data_protection.backup_instances
WHERE resource_group_name = '{{ resource_group_name }}' -- required
AND vault_name = '{{ vault_name }}' -- required
AND backup_instance_name = '{{ backup_instance_name }}' -- required
AND operation_id = '{{ operation_id }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
;

INSERT examples

Create or update a backup instance in a backup vault.

INSERT INTO azure.data_protection.backup_instances (
properties,
tags,
resource_group_name,
vault_name,
backup_instance_name,
subscription_id,
x-ms-authorization-auxiliary
)
SELECT
'{{ properties }}',
'{{ tags }}',
'{{ resource_group_name }}',
'{{ vault_name }}',
'{{ backup_instance_name }}',
'{{ subscription_id }}',
'{{ x-ms-authorization-auxiliary }}'
RETURNING
id,
name,
properties,
systemData,
tags,
type
;

REPLACE examples

Create or update a backup instance in a backup vault.

REPLACE azure.data_protection.backup_instances
SET
properties = '{{ properties }}',
tags = '{{ tags }}'
WHERE
resource_group_name = '{{ resource_group_name }}' --required
AND vault_name = '{{ vault_name }}' --required
AND backup_instance_name = '{{ backup_instance_name }}' --required
AND subscription_id = '{{ subscription_id }}' --required
AND x-ms-authorization-auxiliary = '{{ x-ms-authorization-auxiliary}}'
RETURNING
id,
name,
properties,
systemData,
tags,
type;

DELETE examples

Delete a backup instance in a backup vault.

DELETE FROM azure.data_protection.backup_instances
WHERE resource_group_name = '{{ resource_group_name }}' --required
AND vault_name = '{{ vault_name }}' --required
AND backup_instance_name = '{{ backup_instance_name }}' --required
AND subscription_id = '{{ subscription_id }}' --required
AND x-ms-authorization-auxiliary = '{{ x-ms-authorization-auxiliary }}'
;

Lifecycle Methods

Validate whether adhoc backup will be successful or not.

EXEC azure.data_protection.backup_instances.validate_for_backup 
@resource_group_name='{{ resource_group_name }}' --required,
@vault_name='{{ vault_name }}' --required,
@subscription_id='{{ subscription_id }}' --required
@@json=
'{
"backupInstance": "{{ backupInstance }}"
}'
;