Dedicated Host Service (DeH)¶

The DeH client is the command-line interface (CLI) for the Dedicated Host Service (DeH) API and its extensions.

For help on a specific deh command, enter:

$ openstack deh help SUBCOMMAND

Host operations¶

deh host create¶

Create/allocate host

openstack deh host create
    --name <name>
    [--auto_placement]
    [--no-auto_placement]
    --availability_zone <az>
    [--host_type <type>]
    [--quantity [0..]]

--name <name>¶: DNS Name for the host.

--auto_placement¶

--no-auto_placement¶

--availability_zone <az>¶: The AZ the host belongs to.

--host_type <type>¶: DeH type.

--quantity [0..]¶: Number of DeHs to allocate.

This command is provided by the otcextensions plugin.

deh host delete¶

Delete host

openstack deh host delete <host> [<host> ...]

host¶: UUID or name of the host.

This command is provided by the otcextensions plugin.

deh host list¶

List DeH hosts

openstack deh host list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    [--id <id>]
    [--name <name>]
    [--host_type <host_type>]
    [--host_type_name <host_type_name>]
    [--flavor <flavor>]
    [--status {available,fault,released}]
    [--tenant <tenant>]
    [--availability_zone <availability_zone>]
    [--limit <limit>]
    [--marker <marker>]
    [--changes_since <changes_since>]

--sort-column SORT_COLUMN¶: specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending¶: sort the column(s) in ascending order

--sort-descending¶: sort the column(s) in descending order

--id <id>¶: Host id.

--name <name>¶: Host name.

--host_type <host_type>¶: Host type.

--host_type_name <host_type_name>¶: Host type name.

--flavor <flavor>¶: Flavor ID.

--status {available,fault,released}¶: Host status filter.

--tenant <tenant>¶: Tenant ID or “all”.

--availability_zone <availability_zone>¶: Availability zone.

--limit <limit>¶: Number of entries to display.

--marker <marker>¶: ID of the last record on the previous page.

--changes_since <changes_since>¶: Filters the response by a date and time stamp when the DeH last changed status. Format: CCYY-MM-DDThh:mm:ss+hh:mm

This command is provided by the otcextensions plugin.

deh host set¶

Update Host attributes

openstack deh host set
    [--name <name>]
    [--auto_placement]
    [--no-auto_placement]
    [--tag <key=value>]
    <host>

--name <name>¶: DNS Name for the host.

--auto_placement¶

--no-auto_placement¶

--tag <key=value>¶: Tag to add for this host (repeat option to set multiple tags)

host¶: UUID or name of the host.

This command is provided by the otcextensions plugin.

deh host show¶

Show the DeH Host details

openstack deh host show <host>

host¶: UUID of the host.

This command is provided by the otcextensions plugin.

deh host type list¶

List DeH host types

openstack deh host type list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    <az>

--sort-column SORT_COLUMN¶: specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending¶: sort the column(s) in ascending order

--sort-descending¶: sort the column(s) in descending order

az¶: Availability zone.

This command is provided by the otcextensions plugin.

deh host unset¶

Remove Host attributes

openstack deh host unset [--tag <key>] <host>

--tag <key>¶: Tag key to remove from this host (repeat option to remove multiple tags)

host¶: UUID or name of the host.

This command is provided by the otcextensions plugin.

Server operations¶

deh server list¶

List Servers on a DeH

openstack deh server list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    <host>

--sort-column SORT_COLUMN¶: specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending¶: sort the column(s) in ascending order

--sort-descending¶: sort the column(s) in descending order

host¶: UUID of the DeH host.

This command is provided by the otcextensions plugin.

last updated: 2023-06-12 09:35