az netappfiles volume replication

Manage Azure NetApp Files (ANF) Volume replication operations.

Commands

Name	Description	Type	Status
az netappfiles volume replication approve	Authorize a volume as a replication destination for a specified source.	Core	GA
az netappfiles volume replication list	List replication for ANF volume.	Core	GA
az netappfiles volume replication re-initialize	Re-initialise a volume replication for the specified destination volume. The replication process is resumed from source to destination.	Core	GA
az netappfiles volume replication remove	Delete a volume replication for the specified destination volume. The data replication objects of source and destination volumes will be removed.	Core	GA
az netappfiles volume replication resume	Resync a volume replication for the specified destination volume. The replication process is resumed from source to destination. If any quota rules exists on destination volume they will be overwritten with source volume's quota rules.	Core	GA
az netappfiles volume replication status	Get the replication status for the specified replication volume.	Core	GA
az netappfiles volume replication suspend	Suspend/break a volume replication for the specified destination volume. The replication process is suspended until resumed or deleted.	Core	GA
az netappfiles volume replication wait	Wait for a volume replication operation.	Core	GA

az netappfiles volume replication approve

Authorize a volume as a replication destination for a specified source.

az netappfiles volume replication approve --account-name
                                          --name
                                          --pool-name
                                          --resource-group
                                          [--no-wait]
                                          [--remote-volume-resource-id]

Examples

Authorize the volume as the replication destination for the source

az netappfiles volume replication approve -g mygroup --account-name myaccname --pool-name mypoolname --name mysourcevolname --remote-volume-resource-id /subscriptions/69a75bda-882e-44d5-8431-63421204131c/resourceGroups/mygroup1/providers/Microsoft.NetApp/netAppAccounts/myaccount1/capacityPools/mypool1/volumes/mydestinationvolume

Required Parameters

--account-name -a

The name of the ANF account.

--name --volume-name -n -v

The name of the replication source volume.

--pool-name -p

The name of the ANF pool.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--no-wait

Do not wait for the long-running operation to finish.

default value: False

--remote-volume-resource-id -d

The resource id of the destination replication volume.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az netappfiles volume replication list

List replication for ANF volume.

az netappfiles volume replication list --account-name
                                       --name
                                       --pool-name
                                       --resource-group

Examples

List all replications for a specified volume

az netappfiles volume replication list -g mygroup --account-name myaccname --pool-name mypoolname --name mydestinationvolname

Required Parameters

--account-name -a

Name of the ANF account.

--name --volume-name -n -v

Name of the ANF volume.

--pool-name -p

Name of the ANF pool.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az netappfiles volume replication re-initialize

Re-initialise a volume replication for the specified destination volume. The replication process is resumed from source to destination.

az netappfiles volume replication re-initialize [--account-name]
                                                [--ids]
                                                [--name]
                                                [--no-wait]
                                                [--pool-name]
                                                [--resource-group]
                                                [--subscription]

Examples

Re-initialises the replication process

az netappfiles volume replication re-initialize -g mygroup --account-name myaccname --pool-name mypoolname --name mydestinationvolname

Optional Parameters

--account-name -a

The name of the ANF account.

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--name --volume-name -n -v

The name of the replication destination volume.

--no-wait

Do not wait for the long-running operation to finish.

default value: False

--pool-name -p

The name of the ANF pool.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az netappfiles volume replication remove

Delete a volume replication for the specified destination volume. The data replication objects of source and destination volumes will be removed.

az netappfiles volume replication remove [--account-name]
                                         [--ids]
                                         [--name]
                                         [--no-wait]
                                         [--pool-name]
                                         [--resource-group]
                                         [--subscription]

Examples

Delete the replication objects of the paired volumes

az netappfiles volume replication remove -g mygroup --account-name myaccname --pool-name mypoolname --name mydestinationvolname

Optional Parameters

--account-name -a

The name of the ANF account.

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--name --volume-name -n -v

The name of the replication destination volume.

--no-wait

Do not wait for the long-running operation to finish.

default value: False

--pool-name -p

The name of the ANF pool.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az netappfiles volume replication resume

Resync a volume replication for the specified destination volume. The replication process is resumed from source to destination. If any quota rules exists on destination volume they will be overwritten with source volume's quota rules.

az netappfiles volume replication resume [--account-name]
                                         [--ids]
                                         [--name]
                                         [--no-wait]
                                         [--pool-name]
                                         [--resource-group]
                                         [--subscription]

Examples

Resume the replication process

az netappfiles volume replication resume -g mygroup --account-name myaccname --pool-name mypoolname --name mydestinationvolname

Optional Parameters

--account-name -a

The name of the ANF account.

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--name --volume-name -n -v

The name of the replication destination volume.

--no-wait

Do not wait for the long-running operation to finish.

default value: False

--pool-name -p

The name of the ANF pool.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az netappfiles volume replication status

Get the replication status for the specified replication volume.

az netappfiles volume replication status [--account-name]
                                         [--ids]
                                         [--name]
                                         [--pool-name]
                                         [--resource-group]
                                         [--subscription]

Examples

Get the replication status for the volume. Returns whether the replication is healthy, the replication schedule and the mirror state (whether replication is suspened/broken or synced/mirrored)

az netappfiles volume replication status -g mygroup --account-name myaccname --pool-name mypoolname --name mydestinationvolname

Optional Parameters

--account-name -a

The name of the ANF account.

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--name --volume-name -n -v

The name of the replication destination volume.

--pool-name -p

The name of the ANF pool.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az netappfiles volume replication suspend

Suspend/break a volume replication for the specified destination volume. The replication process is suspended until resumed or deleted.

az netappfiles volume replication suspend [--account-name]
                                          [--force {false, true}]
                                          [--ids]
                                          [--name]
                                          [--no-wait]
                                          [--pool-name]
                                          [--resource-group]
                                          [--subscription]

Examples

Suspend the replication process

az netappfiles volume replication suspend -g mygroup --account-name myaccname --pool-name mypoolname --name mydestinationvolname

Optional Parameters

--account-name -a

The name of the ANF account.

--force --force-break-replication -f

Force break the replication.

accepted values: false, true

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--name --volume-name -n -v

The name of the replication destination volume.

--no-wait

Do not wait for the long-running operation to finish.

default value: False

--pool-name -p

The name of the ANF pool.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az netappfiles volume replication wait

Wait for a volume replication operation.

az netappfiles volume replication wait [--account-name]
                                       [--created]
                                       [--custom]
                                       [--deleted]
                                       [--exists]
                                       [--ids]
                                       [--interval]
                                       [--name]
                                       [--pool-name]
                                       [--resource-group]
                                       [--subscription]
                                       [--timeout]
                                       [--updated]

Optional Parameters

--account-name -a

Name of the ANF account.

--created

Wait until created with 'provisioningState' at 'Succeeded'.

default value: False

--custom

Wait until the condition satisfies a custom JMESPath query. E.g. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Wait until deleted.

default value: False

--exists

Wait until the resource exists.

default value: False

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--interval

Polling interval in seconds.

default value: 30

--name --volume-name -n -v

Name of the ANF volume.

--pool-name -p

Name of the ANF pool.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--timeout

Maximum wait in seconds.

default value: 3600

--updated

Wait until updated with provisioningState at 'Succeeded'.

default value: False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.