2.6. Managing node location¶
2.6.1. vinfra location list¶
List locations of the specified failure domain:
usage: vinfra location list --fd <fd>
--fd <fd>- Failure domain ID
Example:
# vinfra location list --fd 4
+----+--------------+----------+
| id | name | children |
+----+--------------+----------+
| 0 | Default room | - 0 |
+----+--------------+----------+
This command lists the locations.
Note
The children column lists the ID of children, not their quantity.
2.6.2. vinfra location create¶
Create a new child location of the specified failure domain within the parent location identified by ID:
usage: vinfra location create --fd <fd> --name <location-name>
[--parent-id <parent-id>]
--fd <fd>- Failure domain ID
--name <location-name>- Name of the location to be created.
--parent-id <parent-id>- ID of the parent location where the child location should be created in.
Example:
# vinfra location create --fd 3 --name row2 --parent-id 0
+----------+-------+
| Field | Value |
+----------+-------+
| children | [] |
| id | 1 |
| name | row2 |
| parent | 0 |
+----------+-------+
This command creates the location row2.
Note
To create a location of level 4 (room), do not use the --parent-id argument.
2.6.3. vinfra location rename¶
Change the name of the location of the specified failure domain and identified by ID:
usage: vinfra location rename --fd <fd> --id <location-id>
--name <location-name>
--fd <fd>- Failure domain ID.
--id <location-id>- ID of the location to rename.
--name <location-name>- The new location name.
Example:
# vinfra location rename --fd 3 --id 2 --name row_renamed
Operation successful.
This command renames the location 2 to row_renamed.
Task outcome:
# vinfra location list --fd 3
+----+-------------+--------+----------+
| id | name | parent | children |
+----+-------------+--------+----------+
| 0 | Default row | 0 | - 0 |
| 2 | row_renamed | 1 | [] |
+----+-------------+--------+----------+
2.6.4. vinfra location show¶
Show the location of the specified failure domain and identified by ID:
usage: vinfra location show --fd <fd> --id <location-id>
--fd <fd>- Failure domain ID.
--id <location-id>- ID of the location to show.
Example:
# vinfra location show --fd 3 --id 2
+----------+-------------+
| Field | Value |
+----------+-------------+
| children | [] |
| id | 2 |
| name | row_renamed |
| parent | 1 |
+----------+-------------+
This command shows the location 2.
2.6.5. vinfra location move¶
Move locations identified by IDs to the parent location of the specified failure domain and identified by ID:
usage: vinfra location move --children <children> [<children> ...]
--parent-fd <parent-fd> --parent-id <parent-id>
--children <children> [<children> ...]- IDs of locations to be moved to the parent location.
--parent-fd <parent-fd>- The failure domain of the parent location.
--parent-id <parent-id>- ID of the parent location.
Example:
# vinfra location move --children 2 --parent-fd 4 --parent-id 1
Operation successful.
This command moves the location (row) 2 to the failure domain 4 (room) with ID 1.
2.6.6. vinfra location delete¶
Delete the location of specified failure domain and identified by ID.
usage: vinfra location delete --fd <fd> --id <location-id>
--fd <fd>- Failure domain ID.
--id <location-id>- ID of the location to delete.
Example:
# vinfra location delete --fd 3 --id 1
Operation successful.
This command deletes the location 1.