disaster_recovery_configs

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

Overview

Name	disaster_recovery_configs
Type	Resource
Id	azure.service_bus.disaster_recovery_configs

Fields

The following fields are returned by SELECT queries:

get

Successfully retrieved the Alias(Disaster Recovery configurations)

Name	Datatype	Description
properties		Properties required to the Create Or Update Alias(Disaster Recovery configurations)
systemData	object	The system meta data relating to this resource.

list

Successfully retrieved the list of Alias(Disaster Recovery configurations) for servicebus namespace

Name	Datatype	Description
properties		Properties required to the Create Or Update Alias(Disaster Recovery configurations)
systemData	object	The system meta data relating to this resource.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	resourceGroupName, namespaceName, alias, subscriptionId		Retrieves Alias(Disaster Recovery configuration) for primary or secondary namespace
list	select	resourceGroupName, namespaceName, subscriptionId		Gets all Alias(Disaster Recovery configurations)
create_or_update	insert	resourceGroupName, namespaceName, alias, subscriptionId		Creates or updates a new Alias(Disaster Recovery configuration)
delete	delete	resourceGroupName, namespaceName, alias, subscriptionId		Deletes an Alias(Disaster Recovery configuration)
check_name_availability	exec	resourceGroupName, namespaceName, subscriptionId, name		Check the give namespace name availability.
break_pairing	exec	resourceGroupName, namespaceName, alias, subscriptionId		This operation disables the Disaster Recovery and stops replicating changes from primary to secondary namespaces
fail_over	exec	resourceGroupName, namespaceName, alias, subscriptionId		Invokes GEO DR failover and reconfigure the alias to point to the secondary namespace

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.

Name	Datatype	Description
alias	string	The Disaster Recovery configuration name
namespaceName	string	The namespace name
resourceGroupName	string	The name of the resource group. The name is case insensitive.
subscriptionId	string (uuid)	The ID of the target subscription. The value must be an UUID.

SELECT examples

get

Retrieves Alias(Disaster Recovery configuration) for primary or secondary namespace

SELECT
properties,
systemData
FROM azure.service_bus.disaster_recovery_configs
WHERE resourceGroupName = '{{ resourceGroupName }}' -- required
AND namespaceName = '{{ namespaceName }}' -- required
AND alias = '{{ alias }}' -- required
AND subscriptionId = '{{ subscriptionId }}' -- required
;

list

Gets all Alias(Disaster Recovery configurations)

SELECT
properties,
systemData
FROM azure.service_bus.disaster_recovery_configs
WHERE resourceGroupName = '{{ resourceGroupName }}' -- required
AND namespaceName = '{{ namespaceName }}' -- required
AND subscriptionId = '{{ subscriptionId }}' -- required
;

INSERT examples

create_or_update

Creates or updates a new Alias(Disaster Recovery configuration)

INSERT INTO azure.service_bus.disaster_recovery_configs (
data__properties,
resourceGroupName,
namespaceName,
alias,
subscriptionId
)
SELECT 
'{{ properties }}',
'{{ resourceGroupName }}',
'{{ namespaceName }}',
'{{ alias }}',
'{{ subscriptionId }}'
RETURNING
properties,
systemData
;

Manifest

# Description fields are for documentation purposes
- name: disaster_recovery_configs
  props:
    - name: resourceGroupName
      value: string
      description: Required parameter for the disaster_recovery_configs resource.
    - name: namespaceName
      value: string
      description: Required parameter for the disaster_recovery_configs resource.
    - name: alias
      value: string
      description: Required parameter for the disaster_recovery_configs resource.
    - name: subscriptionId
      value: string (uuid)
      description: Required parameter for the disaster_recovery_configs resource.
    - name: properties
      value: string
      description: |
        Properties required to the Create Or Update Alias(Disaster Recovery configurations)

DELETE examples

delete

Deletes an Alias(Disaster Recovery configuration)

DELETE FROM azure.service_bus.disaster_recovery_configs
WHERE resourceGroupName = '{{ resourceGroupName }}' --required
AND namespaceName = '{{ namespaceName }}' --required
AND alias = '{{ alias }}' --required
AND subscriptionId = '{{ subscriptionId }}' --required
;

Lifecycle Methods

check_name_availability

Check the give namespace name availability.

EXEC azure.service_bus.disaster_recovery_configs.check_name_availability 
@resourceGroupName='{{ resourceGroupName }}' --required, 
@namespaceName='{{ namespaceName }}' --required, 
@subscriptionId='{{ subscriptionId }}' --required 
@@json=
'{
"name": "{{ name }}"
}'
;

break_pairing

This operation disables the Disaster Recovery and stops replicating changes from primary to secondary namespaces

EXEC azure.service_bus.disaster_recovery_configs.break_pairing 
@resourceGroupName='{{ resourceGroupName }}' --required, 
@namespaceName='{{ namespaceName }}' --required, 
@alias='{{ alias }}' --required, 
@subscriptionId='{{ subscriptionId }}' --required
;

fail_over

Invokes GEO DR failover and reconfigure the alias to point to the secondary namespace

EXEC azure.service_bus.disaster_recovery_configs.fail_over 
@resourceGroupName='{{ resourceGroupName }}' --required, 
@namespaceName='{{ namespaceName }}' --required, 
@alias='{{ alias }}' --required, 
@subscriptionId='{{ subscriptionId }}' --required 
@@json=
'{
"properties": "{{ properties }}"
}'
;