View a markdown version of this page

GET List: Get a List of Redundancy Group Members - Conductor Live
HTTP Request and ResponseExample

GET List: Get a List of Redundancy Group Members

Get the list of the nodes that are members of the specified redundancy group.

HTTP Request and Response

Request URL

GET http://<Conductor IP address>/redundancy_groups/<ID of redundancy group>/members

Call Header

  • Accept: Set to application/xml

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

Response

The response is XML content consisting of one redundancy_group_members element with the following.

  • An HREF attribute that specifies the product and version installed on the Conductor Live node.

  • Zero or more redundancy_group_member elements, one for each group found. Each redundancy_group_member element contains several elements:

Element Value Description
id Integer

The member ID for this node.

Note

Within <redundancy_group_members>, <id> is the ID for this node as identified inside the redundancy group, assigned with the node that was added to the redundancy group. Within <node>, <id> is the unique ID for this node as identified in all of Conductor Live, assigned when the node was added to the cluster.
role String The current role of the node in the redundancy group: “active” or “backup.”
node Object The node information for this member of the redundancy group; see Setting up Nodes.

Example

The response shows that the redundancy group with the ID 1 has two members–one backup and one active. 

GET http://198.51.100.0/redundancy_groups/1/members
------------------------------------------
Content-type:application/vnd.elemental+xml;version=3.3.0
------------------------------------------
<?xml version="1.0" encoding="UTF-8"?>
<redundancy_group_members href="/redundancy_groups/1/members" product="AWS Elemental Conductor Live" version="3.3.nnnnn"> 
   <redundancy_group_member>
    <id type="integer">5</id>
    <role>active</role>
    <node>
      <id type="integer">2</id>
      <hostname>live_1</hostname>
      <ip_addr>10.4.138.233</ip_addr>
      <product_name>Live</product_name>
      <status>online</status>
      <version>2.9.2.40404</version>
      <channels type="integer">0</channels>
      <inflight_channels type="integer">0</inflight_channels>
      <mptses type="integer">1</mptses>
      <active_alerts type="integer">0</active_alerts>
      <recent_error_messages type="integer">0</recent_error_messages>
    </node>
  </redundancy_group_member>
  <redundancy_group_member>
    <id type="integer">6</id>
    <role>backup</role>
    <node>
      <id type="integer">3</id>
      <hostname>live_2</hostname>
      <ip_addr>10.4.138.234</ip_addr>
      <product_name>Live</product_name>
      <status>online</status>
      <version>2.9.2.40404</version>
      <channels type="integer">0</channels>
      <inflight_channels type="integer">0</inflight_channels>
      <mptses type="integer">0</mptses>
      <active_alerts type="integer">0</active_alerts>
      <recent_error_messages type="integer">0</recent_error_messages>
    </node>
  </redundancy_group_member>
</redundancy_group_members>