POST: Create a Redundancy Group - AWS Elemental Conductor Live 3

This is version 3.17 of the AWS Elemental Conductor Live 3 documentation. This is the latest version. For prior versions, see the Previous Versions section of AWS Elemental Conductor Live 3 Documentation.

POST: Create a Redundancy Group

Create a new redundancy group for AWS Elemental Live or AWS Elemental Statmux redundancy group with the specified attributes.

HTTP Request and Response

Request URL

POST http://<Conductor IP address>/redundancy_groups

Call Header

  • Accept: Set to application/xml

  • Content-Type: Set to application/xml

If you are implementing user authentication, you must also include three authorization headers; see Header Content for User Authentication.

Request Body

The request contains XML content consisting of one redundancy_group element with the following elements.

Element Value Description
name String A name you assign. This must be unique in the cluster.
product_name String

A name which must specify “live” if nodes in this group are running AWS Elemental Live; specify “statmux” for nodes running AWS Elemental Statmux.

This value is case-sensitive and requires all letters to be in lower case.

All the nodes that you add to the redundancy group must have the same product_name.

Response

The response repeats back the data that you posted with the addition of:

  • id: The newly assigned ID for the redundancy group.

The response is identical to the response to a GET Redundancy Group. For an example, see GET List: Get a List of Redundancy Groups.

Example

Request

This request creates one redundancy group named “backup” with its product set as “live” and its product version set at “2.7.0.12345.”

POST http://198.51.100.0/redundancy_groups ------------------------------------------ Content-type:application/vnd.elemental+xml;version=3.3.0 Accept:application/xml ------------------------------------------ <?xml version="1.0" encoding="UTF-8"?> <redundancy_group> <name>backup</name> <product_name>live</product_name> </redundancy_group>