Skip to main content

replication_protection_clusters

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

Overview

Namereplication_protection_clusters
TypeResource
Idazure.recovery_services_site_recovery.replication_protection_clusters

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.
activeLocationstringThe Current active location of the Protection cluster.
agentClusterIdstringThe Agent cluster Id.
allowedOperationsarrayThe allowed operations on the Replication protection cluster.
areAllClusterNodesRegisteredbooleanA value indicating whether all nodes of the cluster are registered or not.
clusterFqdnstringThe cluster FQDN.
clusterNodeFqdnsarrayThe List of cluster Node FQDNs.
clusterProtectedItemIdsarrayThe List of Protected Item Id's.
clusterRegisteredNodesarrayThe registered node details.
currentScenarioobjectThe current scenario.
healthErrorsarrayList of health errors.
lastSuccessfulFailoverTimestring (date-time)The last successful failover time.
lastSuccessfulTestFailoverTimestring (date-time)The last successful test failover time.
policyFriendlyNamestringThe name of Policy governing this PE.
policyIdstringThe Policy Id.
primaryFabricFriendlyNamestringThe friendly name of the primary fabric.
primaryFabricProviderstringThe fabric provider of the primary fabric.
primaryProtectionContainerFriendlyNamestringThe name of primary protection container friendly name.
protectionClusterTypestringThe type of protection cluster type.
protectionStatestringThe protection status.
protectionStateDescriptionstringThe protection state description.
providerSpecificDetailsobjectThe Replication cluster provider custom settings.
provisioningStatestringThe provisioning state of the cluster.
recoveryContainerIdstringThe recovery container Id.
recoveryFabricFriendlyNamestringThe friendly name of recovery fabric.
recoveryFabricIdstringThe Arm Id of recovery fabric.
recoveryProtectionContainerFriendlyNamestringThe name of recovery container friendly name.
replicationHealthstringThe consolidated protection health for the VM taking any issues with SRS as well as all the replication units associated with the VM's replication group into account. This is a string representation of the ProtectionHealth enumeration.
sharedDiskPropertiesobjectThe shared disk properties.
systemDataobjectAzure Resource Manager metadata containing createdBy and modifiedBy information.
testFailoverStatestringThe Test failover state.
testFailoverStateDescriptionstringThe Test failover state description.
typestringThe type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts".

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_operation_resultsselectresource_group_name, resource_name, fabric_name, protection_container_name, replication_protection_cluster_name, job_id, subscription_idTracks the Replication protection cluster async operation. Track the results of an asynchronous operation on the replication protection cluster.
getselectresource_group_name, resource_name, fabric_name, protection_container_name, replication_protection_cluster_name, subscription_idGets the details of a Replication protection cluster. Gets the details of an ASR replication protection cluster.
list_by_replication_protection_containersselectresource_group_name, resource_name, fabric_name, protection_container_name, subscription_idGets the list of Replication protection clusters in fabric, container. Gets the list of ASR replication protected clusters in the protection container.
listselectresource_group_name, resource_name, subscription_idskipToken, $filterGets the list of Replication protection clusters in vault. Gets the list of ASR replication protected clusters in the vault.
createinsertresource_group_name, resource_name, fabric_name, protection_container_name, replication_protection_cluster_name, subscription_idCreate Replication protection Cluster. The operation to create an ASR replication protection cluster item.
purgedeleteresource_group_name, resource_name, fabric_name, protection_container_name, replication_protection_cluster_name, subscription_idPurge the replication protection cluster. The operation to purge the replication protection cluster. This operation will force delete the replication protection cluster. Use the remove operation on replication protection cluster to perform a clean disable replication protection cluster.
apply_recovery_pointexecresource_group_name, resource_name, fabric_name, protection_container_name, replication_protection_cluster_name, subscription_id, propertiesExecute the change recovery point operation for cluster. Operation to apply a new cluster recovery point on the Protection cluster.
failover_commitexecresource_group_name, resource_name, fabric_name, protection_container_name, replication_protection_cluster_name, subscription_idExecute commit failover for cluster. Operation to initiate commit failover of the replication protection cluster.
repair_replicationexecresource_group_name, resource_name, fabric_name, protection_container_name, replication_protection_cluster_name, subscription_idResynchronize or repair replication of protection cluster. The operation to repair replication protection cluster.
test_failoverexecresource_group_name, resource_name, fabric_name, protection_container_name, replication_protection_cluster_name, subscription_id, propertiesExecute test failover for cluster. Operation to initiate a failover of the replication protection cluster.
test_failover_cleanupexecresource_group_name, resource_name, fabric_name, protection_container_name, replication_protection_cluster_name, subscription_id, propertiesExecute test failover cleanup for cluster. Operation to clean up the test failover of a replication protected cluster.
unplanned_failoverexecresource_group_name, resource_name, fabric_name, protection_container_name, replication_protection_cluster_name, subscription_id, propertiesExecute unplanned cluster failover. Operation to initiate a failover of the replication protection cluster.

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
fabric_namestringFabric name. Required.
job_idstringjob id to track. Required.
protection_container_namestringProtection container name. Required.
replication_protection_cluster_namestringReplication protection cluster name. Required.
resource_group_namestringThe name of the resource group. The name is case insensitive. Required.
resource_namestringThe name of the recovery services vault. Required.
subscription_idstring
$filterstringOData filter options. Default value is None.
skipTokenstringThe pagination token. Possible values: "FabricId" or "FabricId_CloudId" or null. Default value is None.

SELECT examples

Tracks the Replication protection cluster async operation. Track the results of an asynchronous operation on the replication protection cluster.

SELECT
id,
name,
activeLocation,
agentClusterId,
allowedOperations,
areAllClusterNodesRegistered,
clusterFqdn,
clusterNodeFqdns,
clusterProtectedItemIds,
clusterRegisteredNodes,
currentScenario,
healthErrors,
lastSuccessfulFailoverTime,
lastSuccessfulTestFailoverTime,
policyFriendlyName,
policyId,
primaryFabricFriendlyName,
primaryFabricProvider,
primaryProtectionContainerFriendlyName,
protectionClusterType,
protectionState,
protectionStateDescription,
providerSpecificDetails,
provisioningState,
recoveryContainerId,
recoveryFabricFriendlyName,
recoveryFabricId,
recoveryProtectionContainerFriendlyName,
replicationHealth,
sharedDiskProperties,
systemData,
testFailoverState,
testFailoverStateDescription,
type
FROM azure.recovery_services_site_recovery.replication_protection_clusters
WHERE resource_group_name = '{{ resource_group_name }}' -- required
AND resource_name = '{{ resource_name }}' -- required
AND fabric_name = '{{ fabric_name }}' -- required
AND protection_container_name = '{{ protection_container_name }}' -- required
AND replication_protection_cluster_name = '{{ replication_protection_cluster_name }}' -- required
AND job_id = '{{ job_id }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
;

INSERT examples

Create Replication protection Cluster. The operation to create an ASR replication protection cluster item.

INSERT INTO azure.recovery_services_site_recovery.replication_protection_clusters (
properties,
resource_group_name,
resource_name,
fabric_name,
protection_container_name,
replication_protection_cluster_name,
subscription_id
)
SELECT
'{{ properties }}',
'{{ resource_group_name }}',
'{{ resource_name }}',
'{{ fabric_name }}',
'{{ protection_container_name }}',
'{{ replication_protection_cluster_name }}',
'{{ subscription_id }}'
RETURNING
id,
name,
properties,
systemData,
type
;

DELETE examples

Purge the replication protection cluster. The operation to purge the replication protection cluster. This operation will force delete the replication protection cluster. Use the remove operation on replication protection cluster to perform a clean disable replication protection cluster.

DELETE FROM azure.recovery_services_site_recovery.replication_protection_clusters
WHERE resource_group_name = '{{ resource_group_name }}' --required
AND resource_name = '{{ resource_name }}' --required
AND fabric_name = '{{ fabric_name }}' --required
AND protection_container_name = '{{ protection_container_name }}' --required
AND replication_protection_cluster_name = '{{ replication_protection_cluster_name }}' --required
AND subscription_id = '{{ subscription_id }}' --required
;

Lifecycle Methods

Execute the change recovery point operation for cluster. Operation to apply a new cluster recovery point on the Protection cluster.

EXEC azure.recovery_services_site_recovery.replication_protection_clusters.apply_recovery_point 
@resource_group_name='{{ resource_group_name }}' --required,
@resource_name='{{ resource_name }}' --required,
@fabric_name='{{ fabric_name }}' --required,
@protection_container_name='{{ protection_container_name }}' --required,
@replication_protection_cluster_name='{{ replication_protection_cluster_name }}' --required,
@subscription_id='{{ subscription_id }}' --required
@@json=
'{
"properties": "{{ properties }}"
}'
;