Interacting with Hardware

hardware bandwidth

Bandwidth data over date range. Bandwidth is listed in GB

Using just a date might get you times off by 1 hour, use T00:01 to get just the specific days data Timezones can also be included with the YYYY-MM-DDTHH:mm:ss.00000-HH:mm format.

Due to some rounding and date alignment details, results here might be slightly different than results in the control portal.

Example:

slcli hw bandwidth 1234 -s 2019-05-01T00:01 -e 2019-05-02T00:00:01.00000-12:00
hardware bandwidth [OPTIONS] IDENTIFIER

Options

-s, --start_date <start_date>

Start Date YYYY-MM-DD, YYYY-MM-DDTHH:mm:ss, [required]

-e, --end_date <end_date>

End Date YYYY-MM-DD, YYYY-MM-DDTHH:mm:ss [required]

-p, --summary_period <summary_period>

300, 600, 1800, 3600, 43200 or 86400 seconds [default: 3600]

-q, --quite_summary

Only show the summary table [default: False]

Arguments

IDENTIFIER

Required argument

hardware cancel-reasons

Display a list of cancellation reasons.

hardware cancel-reasons [OPTIONS]

hardware cancel

Cancel a dedicated server.

hardware cancel [OPTIONS] IDENTIFIER

Options

--immediate

Cancels the server immediately (instead of on the billing anniversary)

--comment <comment>

An optional comment to add to the cancellation ticket

--reason <reason>

An optional cancellation reason. See cancel-reasons for a list of available options

Arguments

IDENTIFIER

Required argument

hardware create-options

Server order options for a given chassis.

hardware create-options [OPTIONS]

hardware create

Order/create a dedicated server.

hardware create [OPTIONS]

Options

-H, --hostname <hostname>

Host portion of the FQDN [required]

-D, --domain <domain>

Domain portion of the FQDN [required]

-s, --size <size>

Hardware size [required]

-o, --os <os>

OS install code [required]

-d, --datacenter <datacenter>

Datacenter shortname [required]

--port-speed <port_speed>

Port speeds [required]

--billing <billing>

Billing rate [default: hourly]

Options:hourly|monthly
-i, --postinstall <postinstall>

Post-install script to download

-k, --key <key>

SSH keys to add to the root user (multiple occurrence permitted)

--no-public

Private network only

-e, --extra <extra>

Extra options (multiple occurrence permitted)

--test

Do not actually create the server

-t, --template <template>

A template file that defaults the command-line options

--export <export>

Exports options to a template file

--wait <wait>

Wait until the server is finished provisioning for up to X seconds before returning

Provides some basic functionality to order a server. slcli order has a more full featured method of ordering servers. This command only supports the FAST_PROVISION type.

hardware credentials

List server credentials.

hardware credentials [OPTIONS] IDENTIFIER

Arguments

IDENTIFIER

Required argument

hardware detail

Get details for a hardware device.

hardware detail [OPTIONS] IDENTIFIER

Options

--passwords

Show passwords (check over your shoulder!)

--price

Show associated prices

Arguments

IDENTIFIER

Required argument

hardware billing

Get billing for a hardware device.

hardware billing [OPTIONS] IDENTIFIER

Arguments

IDENTIFIER

Required argument

hardware edit

Edit hardware details.

hardware edit [OPTIONS] IDENTIFIER

Options

-D, --domain <domain>

Domain portion of the FQDN

-F, --userfile <userfile>

Read userdata from file

-g, --tag <tag>

Tags to set or empty string to remove all

-H, --hostname <hostname>

Host portion of the FQDN

-u, --userdata <userdata>

User defined metadata string

--public-speed <public_speed>

Public port speed. -1 is best speed available

Options:0|10|100|1000|10000|-1
--private-speed <private_speed>

Private port speed. -1 is best speed available

Options:0|10|100|1000|10000|-1
--redundant

The desired state of redundancy for the interface(s)

--degraded

The desired state of degraded for the interface(s)

Arguments

IDENTIFIER

Required argument

Note : Using multiple ‘ : ‘ can cause an error.

$ slcli hw edit 123456 –tag “cloud:service:db2whoc, cloud:svcplan:flex, cloud:svcenv:prod, cloud:bmixenv:fra”

TransportError(0): (‘Connection aborted.’,

RemoteDisconnected(‘Remote end closed connection without response’,))

When setting port speed, use “-1” to indicate best possible configuration. Using 10/100/1000/10000 on a server with a redundant interface may result the interface entering a degraded state. See setPublicNetworkInterfaceSpeed for more information.

hardware list

List hardware servers.

hardware list [OPTIONS]

Options

-c, --cpu <cpu>

Filter by number of CPU cores

-D, --domain <domain>

Filter by domain

-d, --datacenter <datacenter>

Filter by datacenter

-H, --hostname <hostname>

Filter by hostname

-m, --memory <memory>

Filter by memory in gigabytes

-n, --network <network>

Filter by network port speed in Mbps

--tag <tag>

Filter by tags (multiple occurrence permitted)

--sortby <sortby>

Column to sort by [default: hostname]

--columns <columns>

Columns to display. [options: guid, primary_ip, backend_ip, datacenter, action, created_by, tags] [default: id,hostname,primary_ip,backend_ip,datacenter,action]

-l, --limit <limit>

How many results to get in one api call, default is 100 [default: 100]

hardware power-cycle

Power cycle a server.

hardware power-cycle [OPTIONS] IDENTIFIER

Arguments

IDENTIFIER

Required argument

hardware power-off

Power off an active server.

hardware power-off [OPTIONS] IDENTIFIER

Arguments

IDENTIFIER

Required argument

hardware power-on

Power on a server.

hardware power-on [OPTIONS] IDENTIFIER

Arguments

IDENTIFIER

Required argument

hardware reboot

Reboot an active server.

hardware reboot [OPTIONS] IDENTIFIER

Options

--hard, --soft

Perform a hard or soft reboot

Arguments

IDENTIFIER

Required argument

hardware reload

Reload operating system on a server.

hardware reload [OPTIONS] IDENTIFIER

Options

-i, --postinstall <postinstall>

Post-install script to download (Only HTTPS executes, HTTP leaves file in /root

-k, --key <key>

SSH keys to add to the root user (multiple occurrence permitted)

Arguments

IDENTIFIER

Required argument

hardware rescue

Reboot server into a rescue image.

hardware rescue [OPTIONS] IDENTIFIER

Arguments

IDENTIFIER

Required argument

hardware reflash-firmware

Reflash server firmware.

hardware reflash-firmware [OPTIONS] IDENTIFIER

Arguments

IDENTIFIER

Required argument

Reflash here means the current version of the firmware running on your server will be re-flashed onto the selected hardware. This does require a reboot. See slcli hw update-firmware if you want the newest version.

hardware update-firmware

Update server firmware.

hardware update-firmware [OPTIONS] IDENTIFIER

Arguments

IDENTIFIER

Required argument

This function updates the firmware of a server. If already at the latest version, no software is installed.

hardware toggle-ipmi

Toggle the IPMI interface on and off

hardware toggle-ipmi [OPTIONS] IDENTIFIER

Options

--enable, --disable

Whether enable (DEFAULT) or disable the interface.

Arguments

IDENTIFIER

Required argument

hardware ready

Check if a server is ready.

hardware ready [OPTIONS] IDENTIFIER

Options

--wait <wait>

Seconds to wait [default: 0]

Arguments

IDENTIFIER

Required argument

hardware dns-sync

Sync DNS records.

hardware dns-sync [OPTIONS] IDENTIFIER

Options

-a, --a-record

Sync the A record for the host

--aaaa-record

Sync the AAAA record for the host

--ptr

Sync the PTR record for the host

--ttl <ttl>

Sets the TTL for the A and/or PTR records [default: 7200]

Arguments

IDENTIFIER

Required argument

hardware storage

Get storage details for a hardware server.

hardware storage [OPTIONS] IDENTIFIER

Arguments

IDENTIFIER

Required argument