Administrator's Guide

8.3 Aquiring a region UID
The region ID is required for updating, refreshing, or deleting a region. The cURL command to use
for acquiring a region is:
Syntax
curl --noproxy <controller-ip> --header
"X-Auth-Token:<auth_token>" --header
"Content-Type:application/json" --fail -ksS --request GET
--url https://<controller-ip>:8443/sdn/v2.0/regions/
For example, the following command acquires the region ID (uid) for the controller team in the
region created in “Creating a region” (page 89).
curl --noproxy 15.146.194.80 --header "X-Auth-Token:54a6f80a9ae243db89bfa05de4ced51d" --header
"Content-Type:application/json" --fail -ksS
--request GET --url https://15.146.194.80:8443/sdn/v2.0/regions/
{"regions":
[
{"uid":"f305338b-1253-401b-9ac3-a10b92666b45","master":
{"ip":"15.146.194.80","name":"controller_1"},
"slaves":
[{"ip":"15.146.194.38","name":"controller_3"},
{"ip":"15.146.194.103","name":"controller_2"}],
"devices":[{"ip":"172.16.21.23"},{"ip":"172.16.21.24"}]
8.4 Updating a region
You can update an existing region with more slave controllers or more devices. The cURL command
for updating a region is:
curl --noproxy controller-ip --header "X-Auth-Token:auth_token" --header "Content-Type:application/json" --fail
-ksS
--request PUT --url https://controller-ip:8443/sdn/v2.0/regions/region-id --data-binary "{
For example, to update the region created in “Creating a region” (page 89), with a new switch
(10.250.100.22), you would insert the master controller authentication token and the region ID
(uid) returned in the above example.
curl --noproxy 15.146.194.80
--header "X-Auth-Token:54a6f80a9ae243db89bfa05de4ced51d"
--header "Content-Type:application/json" --fail -ksS --request PUT
--url https://15.146.194.80:8443/sdn/v2.0/regions/f305338b-1253-401b-9ac3-a10b92666b45
--data-binary '{
\"region\": {
\"master\": {
\"ip\": \"15.146.194.80\",
\"name\": \"Controller_1\"
},
\"slaves\": [
{
\"ip\": \"15.146.194.103\",
\"name\": \"Controller_2\"
},
{
\"ip\": \"15.146.194.38\",
\"name\": \"Controller_3\"
}
],
{
\"devices\": [
\"ip\": \"10.250.100.20\"
},
{
\"ip\": \"10.250.100.21\"
},
{
\"ip\": \"10.250.100.22\"
}
]
}}'
90 Regional configuration