Mgmt Server Names Accept List:Update List Of Accepted Server Names

Search (SHIFT+S)

ECS Management API

ECS Object Service API

ECS API Changes

New in this release

Update List Of Accepted Server Names

PUT /acceptedservernames/

Updates the list of accepted management server names.

Required Roles

SECURITY_ADMIN

Request Payload

<update_accepted_server_names>
   <add_server_names>
      <server_name></server_name>
   </add_server_names>
   <remove_server_names>
      <server_name></server_name>
   </remove_server_names>
</update_accepted_server_names>

{
  "add_server_names": [
    ""
  ],
  "remove_server_names": [
    ""
  ]
}

All parameters are required unless otherwise stated.

Field	Description	Type	Notes
update_accepted_server_names
add_server_names	A list of accepted server names to add
server_name		String	0-* Elements
remove_server_names	A list of accepted server names to remove
server_name		String	0-* Elements

Response Body

Field	Description	Type	Notes
accepted_server_names
server_name	A list of accepted management server names	String	0-* Elements

Examples

Request

PUT https://192.168.0.0:4443/acceptedservernames/ HTTP/1.1

Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

<update_accepted_server_names>
	<add_server_names>
		<server_name>192.168.0.10</server_name>
		<server_name>192.168.0.11</server_name>
	</add_server_names>
	<remove_server_names>
		<server_name>192.168.0.12</server_name>
		<server_name>192.168.0.13</server_name>
	</remove_server_names>
</update_accepted_server_names>

Response

HTTP/1.1 200 OK
Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<accepted_server_names>
    <server_name>192.168.0.14</server_name>
    <server_name>192.168.0.15</server_name>
    <server_name>192.168.0.10</server_name>
    <server_name>192.168.0.11</server_name>
</accepted_server_names>

Request

PUT https://192.168.0.0:4443/acceptedservernames.json HTTP/1.1

Content-Type: application/json
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

{
	"add_server_names": ["192.168.0.14", "192.168.0.15"],
	"remove_server_names": ["192.168.0.10", "192.168.0.11"]
}

Response

HTTP/1.1 200 OK
Content-Type: application/json

{
    "server_name": [
        "192.168.0.12",
        "192.168.0.13",
        "192.168.0.14",
        "192.168.0.15"
    ]
}

Request

cat body.txt

<update_accepted_server_names>
	<add_server_names>
        <server_name>192.168.0.10</server_name>
        <server_name>192.168.0.11</server_name>
	</add_server_names>
	<remove_server_names>
		<server_name>192.168.0.12</server_name>
        <server_name>192.168.0.13</server_name>
	</remove_server_names>
</update_accepted_server_names>

curl -H $token -H "Content-Type: application/xml" -X PUT --data @body.txt https://$nodeIp:4443/acceptedservernames/

Response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<accepted_server_names>
	<server_name>192.168.0.10</server_name>
	<server_name>192.168.0.11</server_name>
	<server_name>192.168.0.15</server_name>
	<server_name>192.168.0.14</server_name>
</accepted_server_names>