DNS service command-line client

updated: 2019-08-16 16:58

DNS service command-line client

DNS service command-line client¶

The designate client is the command-line interface (CLI) for the DNS service API and its extensions.

This chapter documents designate version 2.0.0.

For help on a specific designate command, enter:

$ designate help COMMAND

designate usage¶

usage: designate [--version] [-v | -q] [--log-file LOG_FILE] [-h] [--debug]
                 [--os-username OS_USERNAME] [--os-user-id OS_USER_ID]
                 [--os-user-domain-id OS_USER_DOMAIN_ID]
                 [--os-user-domain-name OS_USER_DOMAIN_NAME]
                 [--os-password OS_PASSWORD] [--os-tenant-name OS_TENANT_NAME]
                 [--os-tenant-id OS_TENANT_ID]
                 [--os-project-name OS_PROJECT_NAME]
                 [--os-domain-name OS_DOMAIN_NAME]
                 [--os-domain-id OS_DOMAIN_ID] [--os-project-id OS_PROJECT_ID]
                 [--os-project-domain-id OS_PROJECT_DOMAIN_ID]
                 [--os-project-domain-name OS_PROJECT_DOMAIN_NAME]
                 [--os-auth-url OS_AUTH_URL] [--os-region-name OS_REGION_NAME]
                 [--os-token OS_TOKEN] [--os-endpoint OS_ENDPOINT]
                 [--os-endpoint-type OS_ENDPOINT_TYPE]
                 [--os-service-type OS_SERVICE_TYPE] [--os-cacert OS_CACERT]
                 [--insecure] [--all-tenants] [--edit-managed]

designate optional arguments¶

--version: show program’s version number and exit
-v, --verbose: Increase verbosity of output. Can be repeated.
-q, --quiet: Suppress output except warnings and errors.
--log-file LOG_FILE: Specify a file to log output. Disabled by default.
-h, --help: Show this help message and exit.
--debug: Show tracebacks on errors.
--os-username OS_USERNAME: Name used for authentication with the OpenStack Identity service. Defaults to env[OS_USERNAME].
--os-user-id OS_USER_ID: User ID used for authentication with the OpenStack Identity service. Defaults to env[OS_USER_ID].
--os-user-domain-id OS_USER_DOMAIN_ID: Defaults to env[OS_USER_DOMAIN_ID].
--os-user-domain-name OS_USER_DOMAIN_NAME: Defaults to env[OS_USER_DOMAIN_NAME].
--os-password OS_PASSWORD: Password used for authentication with the OpenStack Identity service. Defaults to env[OS_PASSWORD].
--os-tenant-name OS_TENANT_NAME: Tenant to request authorization on. Defaults to env[OS_TENANT_NAME].
--os-tenant-id OS_TENANT_ID: Tenant to request authorization on. Defaults to env[OS_TENANT_ID].
--os-project-name OS_PROJECT_NAME: Project to request authorization on. Defaults to env[OS_PROJECT_NAME].
--os-domain-name OS_DOMAIN_NAME: Project to request authorization on. Defaults to env[OS_DOMAIN_NAME].
--os-domain-id OS_DOMAIN_ID: Defaults to env[OS_DOMAIN_ID].
--os-project-id OS_PROJECT_ID: Project to request authorization on. Defaults to env[OS_PROJECT_ID].
--os-project-domain-id OS_PROJECT_DOMAIN_ID: Defaults to env[OS_PROJECT_DOMAIN_ID].
--os-project-domain-name OS_PROJECT_DOMAIN_NAME: Defaults to env[OS_PROJECT_DOMAIN_NAME].
--os-auth-url OS_AUTH_URL: Specify the Identity endpoint to use for authentication. Defaults to env[OS_AUTH_URL].
--os-region-name OS_REGION_NAME: Specify the region to use. Defaults to env[OS_REGION_NAME].
--os-token OS_TOKEN: Specify an existing token to use instead of retrieving one via authentication (e.g. with username & password). Defaults to env[OS_SERVICE_TOKEN].
--os-endpoint OS_ENDPOINT: Specify an endpoint to use instead of retrieving one from the service catalog (via authentication). Defaults to env[OS_DNS_ENDPOINT].
--os-endpoint-type OS_ENDPOINT_TYPE: Defaults to env[OS_ENDPOINT_TYPE].
--os-service-type OS_SERVICE_TYPE: Defaults to env[OS_DNS_SERVICE_TYPE], or ‘dns’.
--os-cacert OS_CACERT: CA certificate bundle file. Defaults to env[OS_CACERT].
--insecure: Explicitly allow ‘insecure’ SSL requests.
--all-tenants: Allows to list all domains from all tenants.
--edit-managed: Allows to edit records that are marked as managed.

designate diagnostics-ping¶

usage: designate diagnostics-ping [-h] [-f {json,shell,table,value,yaml}]
                                  [-c COLUMN] [--max-width <integer>]
                                  [--noindent] [--prefix PREFIX] --service
                                  SERVICE --host HOST

Ping a service on a given host

Optional arguments:

-h, --help: show this help message and exit
--service SERVICE: Service name (e.g. central)
--host HOST: Hostname

designate domain-create¶

usage: designate domain-create [-h] [-f {json,shell,table,value,yaml}]
                               [-c COLUMN] [--max-width <integer>]
                               [--noindent] [--prefix PREFIX] --name NAME
                               --email EMAIL [--ttl TTL]
                               [--description DESCRIPTION]

Create Domain

Optional arguments:

-h, --help: show this help message and exit
--name NAME: Domain name.
--email EMAIL: Domain email.
--ttl TTL: Time to live (seconds).
--description DESCRIPTION: Description.

designate domain-delete¶

usage: designate domain-delete [-h] [-f {json,shell,table,value,yaml}]
                               [-c COLUMN] [--max-width <integer>]
                               [--noindent] [--prefix PREFIX]
                               id

Delete Domain

Positional arguments:

id: Domain ID or name.

Optional arguments:

-h, --help: show this help message and exit

designate domain-get¶

usage: designate domain-get [-h] [-f {json,shell,table,value,yaml}]
                            [-c COLUMN] [--max-width <integer>] [--noindent]
                            [--prefix PREFIX]
                            id

Get Domain

Positional arguments:

id: Domain ID or name.

Optional arguments:

-h, --help: show this help message and exit

designate domain-list¶

usage: designate domain-list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]
                             [--max-width <integer>] [--noindent]
                             [--quote {all,minimal,none,nonnumeric}]

List Domains

Optional arguments:

-h, --help: show this help message and exit

designate domain-servers-list¶

usage: designate domain-servers-list [-h] [-f {csv,json,table,value,yaml}]
                                     [-c COLUMN] [--max-width <integer>]
                                     [--noindent]
                                     [--quote {all,minimal,none,nonnumeric}]
                                     id

List Domain Servers

Positional arguments:

id: Domain ID or name.

Optional arguments:

-h, --help: show this help message and exit

designate domain-update¶

usage: designate domain-update [-h] [-f {json,shell,table,value,yaml}]
                               [-c COLUMN] [--max-width <integer>]
                               [--noindent] [--prefix PREFIX] [--name NAME]
                               [--email EMAIL] [--ttl TTL]
                               [--description DESCRIPTION | --no-description]
                               id

Update Domain

Positional arguments:

id: Domain ID or name.

Optional arguments:

-h, --help: show this help message and exit
--name NAME: Domain name.
--email EMAIL: Domain email.
--ttl TTL: Time to live (seconds).
--description DESCRIPTION: Description.

--no-description

designate quota-get¶

usage: designate quota-get [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN]
                           [--max-width <integer>] [--noindent]
                           [--prefix PREFIX]
                           tenant_id

Get Quota

Positional arguments:

tenant_id: Tenant ID

Optional arguments:

-h, --help: show this help message and exit

designate quota-reset¶

usage: designate quota-reset [-h] [-f {json,shell,table,value,yaml}]
                             [-c COLUMN] [--max-width <integer>] [--noindent]
                             [--prefix PREFIX]
                             tenant_id

Reset Quota

Positional arguments:

tenant_id: Tenant ID.

Optional arguments:

-h, --help: show this help message and exit

designate quota-update¶

usage: designate quota-update [-h] [-f {json,shell,table,value,yaml}]
                              [-c COLUMN] [--max-width <integer>] [--noindent]
                              [--prefix PREFIX] [--domains DOMAINS]
                              [--domain-recordsets DOMAIN_RECORDSETS]
                              [--recordset-records RECORDSET_RECORDS]
                              [--domain-records DOMAIN_RECORDS]
                              [--api-export-size API_EXPORT_SIZE]
                              tenant_id

Update Quota

Positional arguments:

tenant_id: Tenant ID.

Optional arguments:

-h, --help: show this help message and exit
--domains DOMAINS: Allowed domains.
--domain-recordsets DOMAIN_RECORDSETS: Allowed domain records.
--recordset-records RECORDSET_RECORDS: Allowed recordset records.
--domain-records DOMAIN_RECORDS: Allowed domain records.
--api-export-size API_EXPORT_SIZE: Allowed zone export recordsets.

designate record-create¶

usage: designate record-create [-h] [-f {json,shell,table,value,yaml}]
                               [-c COLUMN] [--max-width <integer>]
                               [--noindent] [--prefix PREFIX] --name NAME
                               --type TYPE --data DATA [--ttl TTL]
                               [--priority PRIORITY]
                               [--description DESCRIPTION]
                               domain_id

Create Record

Positional arguments:

domain_id: Domain ID or name.

Optional arguments:

-h, --help: show this help message and exit
--name NAME: Record (relative|absolute) name.
--type TYPE: Record type.
--data DATA: Record data.
--ttl TTL: Record TTL.
--priority PRIORITY: Record priority.
--description DESCRIPTION: Description.

designate record-delete¶

usage: designate record-delete [-h] [-f {json,shell,table,value,yaml}]
                               [-c COLUMN] [--max-width <integer>]
                               [--noindent] [--prefix PREFIX]
                               domain_id id

Delete Record

Positional arguments:

domain_id: Domain ID or name.
id: Record ID.

Optional arguments:

-h, --help: show this help message and exit

designate record-get¶

usage: designate record-get [-h] [-f {json,shell,table,value,yaml}]
                            [-c COLUMN] [--max-width <integer>] [--noindent]
                            [--prefix PREFIX]
                            domain_id id

Get Record

Positional arguments:

domain_id: Domain ID or name.
id: Record ID.

Optional arguments:

-h, --help: show this help message and exit

designate record-list¶

usage: designate record-list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]
                             [--max-width <integer>] [--noindent]
                             [--quote {all,minimal,none,nonnumeric}]
                             domain_id

List Records

Positional arguments:

domain_id: Domain ID or name.

Optional arguments:

-h, --help: show this help message and exit

designate record-update¶

usage: designate record-update [-h] [-f {json,shell,table,value,yaml}]
                               [-c COLUMN] [--max-width <integer>]
                               [--noindent] [--prefix PREFIX] [--name NAME]
                               [--type TYPE] [--data DATA]
                               [--description DESCRIPTION | --no-description]
                               [--ttl TTL | --no-ttl]
                               [--priority PRIORITY | --no-priority]
                               domain_id id

Update Record

Positional arguments:

domain_id: Domain ID or name.
id: Record ID.

Optional arguments:

-h, --help: show this help message and exit
--name NAME: Record name.
--type TYPE: Record type.
--data DATA: Record data.
--description DESCRIPTION: Description.

--no-description

--ttl TTL: Record time to live (seconds).

--no-ttl

--priority PRIORITY: Record priority.

--no-priority

designate report-count-all¶

usage: designate report-count-all [-h] [-f {json,shell,table,value,yaml}]
                                  [-c COLUMN] [--max-width <integer>]
                                  [--noindent] [--prefix PREFIX]

Get count totals for all tenants, domains and records

Optional arguments:

-h, --help: show this help message and exit

designate report-count-domains¶

usage: designate report-count-domains [-h] [-f {json,shell,table,value,yaml}]
                                      [-c COLUMN] [--max-width <integer>]
                                      [--noindent] [--prefix PREFIX]

Get counts for total domains

Optional arguments:

-h, --help: show this help message and exit

designate report-count-records¶

usage: designate report-count-records [-h] [-f {json,shell,table,value,yaml}]
                                      [-c COLUMN] [--max-width <integer>]
                                      [--noindent] [--prefix PREFIX]

Get counts for total records

Optional arguments:

-h, --help: show this help message and exit

designate report-count-tenants¶

usage: designate report-count-tenants [-h] [-f {json,shell,table,value,yaml}]
                                      [-c COLUMN] [--max-width <integer>]
                                      [--noindent] [--prefix PREFIX]

Get counts for total tenants

Optional arguments:

-h, --help: show this help message and exit

designate report-tenant-domains¶

usage: designate report-tenant-domains [-h] [-f {csv,json,table,value,yaml}]
                                       [-c COLUMN] [--max-width <integer>]
                                       [--noindent]
                                       [--quote {all,minimal,none,nonnumeric}]
                                       --report-tenant-id REPORT_TENANT_ID

Get a list of domains for given tenant

Optional arguments:

-h, --help: show this help message and exit
--report-tenant-id REPORT_TENANT_ID: The tenant_id being reported on.

designate report-tenants-all¶

usage: designate report-tenants-all [-h] [-f {csv,json,table,value,yaml}]
                                    [-c COLUMN] [--max-width <integer>]
                                    [--noindent]
                                    [--quote {all,minimal,none,nonnumeric}]

Get list of tenants and domain count for each

Optional arguments:

-h, --help: show this help message and exit

designate server-create¶

usage: designate server-create [-h] [-f {json,shell,table,value,yaml}]
                               [-c COLUMN] [--max-width <integer>]
                               [--noindent] [--prefix PREFIX] --name NAME

Create Server

Optional arguments:

-h, --help: show this help message and exit
--name NAME: Server name.

designate server-delete¶

usage: designate server-delete [-h] [-f {json,shell,table,value,yaml}]
                               [-c COLUMN] [--max-width <integer>]
                               [--noindent] [--prefix PREFIX]
                               id

Delete Server

Positional arguments:

id: Server ID.

Optional arguments:

-h, --help: show this help message and exit

designate server-get¶

usage: designate server-get [-h] [-f {json,shell,table,value,yaml}]
                            [-c COLUMN] [--max-width <integer>] [--noindent]
                            [--prefix PREFIX]
                            id

Get Server

Positional arguments:

id: Server ID.

Optional arguments:

-h, --help: show this help message and exit

designate server-list¶

usage: designate server-list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]
                             [--max-width <integer>] [--noindent]
                             [--quote {all,minimal,none,nonnumeric}]

List Servers

Optional arguments:

-h, --help: show this help message and exit

designate server-update¶

usage: designate server-update [-h] [-f {json,shell,table,value,yaml}]
                               [-c COLUMN] [--max-width <integer>]
                               [--noindent] [--prefix PREFIX] [--name NAME]
                               id

Update Server

Positional arguments:

id: Server ID.

Optional arguments:

-h, --help: show this help message and exit
--name NAME: Server name.

designate sync-all¶

usage: designate sync-all [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN]
                          [--max-width <integer>] [--noindent]
                          [--prefix PREFIX]

Sync Everything

Optional arguments:

-h, --help: show this help message and exit

designate sync-domain¶

usage: designate sync-domain [-h] [-f {json,shell,table,value,yaml}]
                             [-c COLUMN] [--max-width <integer>] [--noindent]
                             [--prefix PREFIX]
                             domain_id

Sync a single Domain

Positional arguments:

domain_id: Domain ID

Optional arguments:

-h, --help: show this help message and exit

designate sync-record¶

usage: designate sync-record [-h] [-f {json,shell,table,value,yaml}]
                             [-c COLUMN] [--max-width <integer>] [--noindent]
                             [--prefix PREFIX]
                             domain_id record_id

Sync a single Record

Positional arguments:

domain_id: Domain ID
record_id: Record ID

Optional arguments:

-h, --help: show this help message and exit

designate touch-domain¶

usage: designate touch-domain [-h] [-f {json,shell,table,value,yaml}]
                              [-c COLUMN] [--max-width <integer>] [--noindent]
                              [--prefix PREFIX]
                              domain_id

Touch a single Domain

Positional arguments:

domain_id: Domain ID

Optional arguments:

-h, --help: show this help message and exit

updated: 2019-08-16 16:58

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.