Cloud Enterprise Object Storage REST API
Search (SHIFT+S)
ECS Management API
ECS Object Service API
ECS API Changes

Get Nodes For Specific Vdc

GET /vdc/{vdcName}/nodes

Gets the data nodes that are currently configured for the specified vdc.

vdcNamename of the vdc for which this request is made.

Query Parameters

lockdown{locked|unlocked|all} if set will also return the nodes status

Required Roles

Requires one of the following roles:

  • SYSTEM_ADMIN

  • SYSTEM_MONITOR

  • NAMESPACE_ADMIN

  • SECURITY_ADMIN

Response Body

List of data nodes in the cluster.

Field Description Type Notes
nodes
node     0-* Elements
nodename Node name String
ip Public Node IP address String
mgmt_ip Management IP address String
geo_ip Geo IP address String
data_ip Public IP address String
data2_ip String
private_ip Private IP address String
nodeid Node Id String
rackId Node rack Id String
version Node version String
isLocal Node is local Boolean
status Node locked/unlocked status. Optional the status is only returned if the query parameter lockdown with an action of {locked|unlocked|all} is provided String

Examples

Request
GET https://192.168.0.0:4443/vdc/vdcscarlet/nodes HTTP/1.1

Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>
Response
HTTP/1.1 200 OK
Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<nodes>
    <node>
        <ip>10.249.249.151</ip>
        <isLocal>true</isLocal>
        <nodeid>10.249.249.151</nodeid>
        <nodename>provo-scarlet.sea.lab.emc.com</nodename>
        <rackId>scarlet</rackId>
        <status>unlocked</status>
        <version>2.2.1.0.76497.b81b36d</version>
    </node>
    <node>
        <ip>10.249.249.152</ip>
        <isLocal>false</isLocal>
        <nodeid>10.249.249.152</nodeid>
        <nodename>sandy-scarlet.sea.lab.emc.com</nodename>
        <rackId>scarlet</rackId>
        <status>unlocked</status>
        <version>2.2.1.0.76497.b81b36d</version>
    </node>
    <node>
        <ip>10.249.249.153</ip>
        <isLocal>false</isLocal>
        <nodeid>10.249.249.153</nodeid>
        <nodename>orem-scarlet.sea.lab.emc.com</nodename>
        <rackId>scarlet</rackId>
        <status>locked</status>
        <version>2.2.1.0.76497.b81b36d</version>
    </node>
    <node>
        <ip>10.249.249.154</ip>
        <isLocal>false</isLocal>
        <nodeid>10.249.249.154</nodeid>
        <nodename>ogden-scarlet.sea.lab.emc.com</nodename>
        <rackId>scarlet</rackId>
        <status>unlocked</status>
        <version>2.2.1.0.76497.b81b36d</version>
    </node>
    <node>
        <ip>10.249.249.155</ip>
        <isLocal>false</isLocal>
        <nodeid>10.249.249.155</nodeid>
        <nodename>layton-scarlet.sea.lab.emc.com</nodename>
        <rackId>scarlet</rackId>
        <status>unlocked</status>
        <version>2.2.1.0.76497.b81b36d</version>
    </node>
    <node>
        <ip>10.249.249.156</ip>
        <isLocal>false</isLocal>
        <nodeid>10.249.249.156</nodeid>
        <nodename>logan-scarlet.sea.lab.emc.com</nodename>
        <rackId>scarlet</rackId>
        <status>unlocked</status>
        <version>2.2.1.0.76497.b81b36d</version>
    </node>
    <node>
        <ip>10.249.249.157</ip>
        <isLocal>false</isLocal>
        <nodeid>10.249.249.157</nodeid>
        <nodename>lehi-scarlet.sea.lab.emc.com</nodename>
        <rackId>scarlet</rackId>
        <status>unlocked</status>
        <version>2.2.1.0.76497.b81b36d</version>
    </node>
    <node>
        <ip>10.249.249.158</ip>
        <isLocal>false</isLocal>
        <nodeid>10.249.249.158</nodeid>
        <nodename>murray-scarlet.sea.lab.emc.com</nodename>
        <rackId>scarlet</rackId>
        <status>unlocked</status>
        <version>2.2.1.0.76497.b81b36d</version>
    </node>
</nodes>
Cloud Enterprise Object Storage REST API v3.6.0.0.126369.160d4eb