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>¶ Required Start Date YYYY-MM-DD, YYYY-MM-DDTHH:mm:ss,
-
-e,--end_date<end_date>¶ Required End Date YYYY-MM-DD, YYYY-MM-DDTHH:mm:ss
-
-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¶
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>¶ Required Host portion of the FQDN
-
-D,--domain<domain>¶ Required Domain portion of the FQDN
-
-s,--size<size>¶ Required Hardware size
-
-o,--os<os>¶ Required OS Key value
-
-d,--datacenter<datacenter>¶ Required Datacenter shortname
-
--port-speed<port_speed>¶ Port speeds. DEPRECATED, use –network
-
--no-public¶ Private network only. DEPRECATED, use –network.
-
--network<network>¶ Network Option Key. Use instead of port-speed option
-
--billing<billing>¶ Billing rate
Default: hourly Options: hourly|monthly
-
-i,--postinstall<postinstall>¶ Post-install script. Should be a HTTPS URL.
-
--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
-
-k,--key<key>¶ SSH keys to add to the root user (multiple occurrence permitted)
-
-e,--extra<extra>¶ Extra option Key Names (multiple occurrence permitted)
See ‘slcli server create-options’ for valid options.
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.
As of v5.9.0 please use the –network option for specifying port speed, as that allows a bit more granularity for choosing your networking 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)
-
-l,--lvm¶ A flag indicating that the provision should use LVM for all logical drives.
Default: False
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
If you don’t specify any arguments, it will attempt to update both the A and PTR records. If you don’t want to update both records, you may use the -a or –ptr arguments to limit the records updated.