Subcommands

ServerCreate

Create a Server

Usage

ionosctl server create [flags]

Aliases

For server command:

[s svr]

For create command:

[c]

Description

Use this command to create a Server in a specified Virtual Data Center. It is required that the number of cores and the amount of memory for the Server to be set.

The amount of memory for the Server must be specified in multiples of 256. The default unit is MB. Minimum: 256MB. Maximum: it depends on your contract limit. You can set the RAM size in the following ways:

  • providing only the value, e.g.--ram 256 equals 256MB.

  • providing both the value and the unit, e.g.--ram 1GB.

You can wait for the Request to be executed using --wait-for-request option. You can also wait for Server to be in AVAILABLE state using --wait-for-state option. It is recommended to use both options together for this command.

Required values to run command:

  • Data Center Id

  • Cores

  • RAM

Options

-u, --api-url string Override default host url (default "https://api.ionos.com")
-z, --availability-zone string Availability zone of the Server (default "AUTO")
--cols strings Set of columns to be printed on output
Available columns: [ServerId Name AvailabilityZone Cores Ram CpuFamily VmState State] (default [ServerId,Name,AvailabilityZone,Cores,Ram,CpuFamily,VmState,State])
-c, --config string Configuration file used for authentication (default "$XDG_CONFIG_HOME/ionosctl/config.json")
--cores int The total number of cores for the Server, e.g. 4. Maximum: depends on contract resource limits (required) (default 2)
--cpu-family string CPU Family for the Server (default "AMD_OPTERON")
--datacenter-id string The unique Data Center Id (required)
-f, --force Force command to execute without user input
-h, --help Print usage
-n, --name string Name of the Server (default "Unnamed Server")
-o, --output string Desired output format [text|json] (default "text")
-q, --quiet Quiet output
--ram string The amount of memory for the Server. Size must be specified in multiples of 256. e.g. --ram 256 or --ram 256MB (required)
-t, --timeout int Timeout option for Request for Server creation/for Server to be in AVAILABLE state [seconds] (default 60)
-v, --verbose Print step-by-step process when running command
-w, --wait-for-request Wait for the Request for Server creation to be executed
-W, --wait-for-state Wait for new Server to be in AVAILABLE state

Examples

ionosctl server create --datacenter-id DATACENTER_ID --name NAME --cores 2 --ram 512MB -w -W