d4a5555e52
* Improve index page to explain the difference between v1 and v2 CLI support. * Add a v2 examples page * Add all supported commands to v2 shell page * Add a tox task to build the docs * Fix a bug building the docs with an invalid html_static_path config Change-Id: Ie1e65c2d0cc8ad1b8b258e03114e19a943d1d19c Closes-Bug: 1572217
2.9 KiB
2.9 KiB
Designate Command Line Tool Examples
Using the client against your dev environment
Typically the designate client talks to Keystone (or a Keystone like
service) via the OS_AUTH_URL setting & retrives the designate
endpoint from the returned service catalog. Using
--os-endpoint or OS_ENDPOINT you can specify
the end point directly, this is useful if you want to point the client
at a test environment that's running without a full Keystone
service.
$ designate --os-endpoint http://127.0.0.1:9001/v1 server-create --name ns.foo.com.
+------------+--------------------------------------+
| Field | Value |
+------------+--------------------------------------+
| id | 3dee78df-c6b8-4fbd-8e89-3186c1a4734f |
| created_at | 2015-11-04T08:47:12.000000 |
| updated_at | None |
| name | ns.foo.com. |
+------------+--------------------------------------+
$ designate --os-endpoint http://127.0.0.1:9001/v1 domain-create --name testing123.net. --email me@mydomain.com
+-------------+--------------------------------------+
| Field | Value |
+-------------+--------------------------------------+
| description | None |
| created_at | 2015-11-04T08:49:53.000000 |
| updated_at | None |
| email | me@mydomain.com |
| ttl | 3600 |
| serial | 1446626993 |
| id | f98c3d91-f514-4956-a955-20eefb413a64 |
| name | testing123.net. |
+-------------+--------------------------------------+
$ designate --os-endpoint http://127.0.0.1:9001/v1 record-create --name myhost.testing123.net. --type A --data 1.2.3.4 f98c3d91-f514-4956-a955-20eefb413a64
+-------------+--------------------------------------+
| Field | Value |
+-------------+--------------------------------------+
| description | None |
| type | A |
| created_at | 2015-11-04T08:52:41.000000 |
| updated_at | None |
| domain_id | f98c3d91-f514-4956-a955-20eefb413a64 |
| priority | None |
| ttl | None |
| data | 1.2.3.4 |
| id | b5a74471-8062-4395-be70-968805a0d832 |
| name | myhost.testing123.net. |
+-------------+--------------------------------------+