2017-08-25 18:27:32 -05:00
|
|
|
.. -*- rst -*-
|
|
|
|
|
2020-02-04 18:41:30 -05:00
|
|
|
Group replication (groups, action)
|
|
|
|
==================================
|
2017-08-25 18:27:32 -05:00
|
|
|
|
|
|
|
Lists targets, enables, disables, and fails over group replication.
|
|
|
|
|
|
|
|
Available since API microversion 3.38.
|
|
|
|
|
|
|
|
|
|
|
|
List replication targets
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
.. rest_method:: POST /v3/{project_id}/groups/{group_id}/action
|
|
|
|
|
|
|
|
Lists replication targets for a group.
|
|
|
|
|
2018-03-01 09:11:44 -06:00
|
|
|
Response codes
|
2018-03-13 15:57:54 -05:00
|
|
|
--------------
|
2017-08-29 16:07:03 -05:00
|
|
|
|
2018-03-01 09:11:44 -06:00
|
|
|
.. rest_status_code:: success ../status.yaml
|
|
|
|
|
|
|
|
- 202
|
|
|
|
|
|
|
|
.. rest_status_code:: error ../status.yaml
|
|
|
|
|
|
|
|
- 400
|
|
|
|
- 404
|
2017-08-25 18:27:32 -05:00
|
|
|
|
|
|
|
|
|
|
|
Request
|
|
|
|
-------
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
|
|
- project_id: project_id_path
|
2018-10-30 11:03:09 +05:30
|
|
|
- group_id: group_id_path
|
2017-08-25 18:27:32 -05:00
|
|
|
|
|
|
|
Request Example
|
|
|
|
---------------
|
|
|
|
|
|
|
|
.. literalinclude:: ./samples/group-replication-list-targets.json
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
Response Parameters
|
|
|
|
-------------------
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
|
|
- backend_id: backend_id_target
|
|
|
|
- unique_key: replication_targets_unique_key
|
|
|
|
|
|
|
|
|
|
|
|
Response Example
|
|
|
|
----------------
|
|
|
|
|
|
|
|
.. literalinclude:: ./samples/group-replication-target.json
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
|
|
Enable group replication
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
.. rest_method:: POST /v3/{project_id}/groups/{group_id}/action
|
|
|
|
|
|
|
|
Enable replication for a group.
|
|
|
|
|
2018-03-01 09:11:44 -06:00
|
|
|
Response codes
|
2018-03-13 15:57:54 -05:00
|
|
|
--------------
|
2018-03-01 09:11:44 -06:00
|
|
|
|
|
|
|
.. rest_status_code:: success ../status.yaml
|
|
|
|
|
|
|
|
- 202
|
|
|
|
|
|
|
|
.. rest_status_code:: error ../status.yaml
|
2017-08-29 16:07:03 -05:00
|
|
|
|
2018-03-01 09:11:44 -06:00
|
|
|
- 400
|
|
|
|
- 404
|
2017-08-25 18:27:32 -05:00
|
|
|
|
|
|
|
Request
|
|
|
|
-------
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
|
|
- project_id: project_id_path
|
2018-10-30 11:03:09 +05:30
|
|
|
- group_id: group_id_path
|
2017-08-25 18:27:32 -05:00
|
|
|
|
|
|
|
Request Example
|
|
|
|
---------------
|
|
|
|
|
|
|
|
.. literalinclude:: ./samples/group-replication-enable.json
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
Disable group replication
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
.. rest_method:: POST /v3/{project_id}/groups/{group_id}/action
|
|
|
|
|
|
|
|
Disable replication for a group.
|
|
|
|
|
2018-03-01 09:11:44 -06:00
|
|
|
Response codes
|
2018-03-13 15:57:54 -05:00
|
|
|
--------------
|
2017-08-29 16:07:03 -05:00
|
|
|
|
2018-03-01 09:11:44 -06:00
|
|
|
.. rest_status_code:: success ../status.yaml
|
|
|
|
|
|
|
|
- 202
|
|
|
|
|
|
|
|
.. rest_status_code:: error ../status.yaml
|
|
|
|
|
|
|
|
- 400
|
|
|
|
- 404
|
2017-08-25 18:27:32 -05:00
|
|
|
|
|
|
|
Request
|
|
|
|
-------
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
|
|
- project_id: project_id_path
|
2018-10-30 11:03:09 +05:30
|
|
|
- group_id: group_id_path
|
2017-08-25 18:27:32 -05:00
|
|
|
|
|
|
|
Request Example
|
|
|
|
---------------
|
|
|
|
|
|
|
|
.. literalinclude:: ./samples/group-replication-disable.json
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
Failover replication
|
|
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
.. rest_method:: POST /v3/{project_id}/groups/{group_id}/action
|
|
|
|
|
|
|
|
Failover a replicated group.
|
|
|
|
|
2018-03-01 09:11:44 -06:00
|
|
|
Response codes
|
2018-03-13 15:57:54 -05:00
|
|
|
--------------
|
2018-03-01 09:11:44 -06:00
|
|
|
|
|
|
|
.. rest_status_code:: success ../status.yaml
|
|
|
|
|
|
|
|
- 202
|
|
|
|
|
|
|
|
.. rest_status_code:: error ../status.yaml
|
2017-08-29 16:07:03 -05:00
|
|
|
|
2018-03-01 09:11:44 -06:00
|
|
|
- 400
|
|
|
|
- 404
|
2017-08-25 18:27:32 -05:00
|
|
|
|
|
|
|
Request
|
|
|
|
-------
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
|
|
- project_id: project_id_path
|
2018-10-30 11:03:09 +05:30
|
|
|
- group_id: group_id_path
|
2017-08-25 18:27:32 -05:00
|
|
|
- allow_attached_volume: allow_attached_volume
|
|
|
|
- secondary_backend_id: backend_id_target
|
|
|
|
|
|
|
|
Request Example
|
|
|
|
---------------
|
|
|
|
|
|
|
|
.. literalinclude:: ./samples/group-replication-failover.json
|
|
|
|
:language: javascript
|