Table Of Contents


User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . lightsail ]



Creates one or more Amazon Lightsail virtual private servers, or instances .

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.


--instance-names <value>
--availability-zone <value>
[--custom-image-name <value>]
--blueprint-id <value>
--bundle-id <value>
[--user-data <value>]
[--key-pair-name <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]


--instance-names (list)

The names to use for your new Lightsail instances. Separate multiple values using quotation marks and commas, for example: ["MyFirstInstance","MySecondInstance"]


"string" "string" ...

--availability-zone (string)

The Availability Zone in which to create your instance. Use the following format: us-east-2a (case sensitive). You can get a list of availability zones by using the get regions operation. Be sure to add the include availability zones parameter to your request.

--custom-image-name (string)

(Deprecated) The name for your custom image.


In releases prior to June 12, 2017, this parameter was ignored by the API. It is now deprecated.

--blueprint-id (string)

The ID for a virtual private server image (e.g., app_wordpress_4_4 or app_lamp_7_0 ). Use the get blueprints operation to return a list of available images (or blueprints ).

--bundle-id (string)

The bundle of specification information for your virtual private server (or instance ), including the pricing plan (e.g., micro_1_0 ).

--user-data (string)

A launch script you can create that configures a server with additional user data. For example, you might want to run apt-get -y update .


Depending on the machine image you choose, the command to get software on your instance varies. Amazon Linux and CentOS use yum , Debian and Ubuntu use apt-get , and FreeBSD uses pkg . For a complete list, see the Dev Guide .

--key-pair-name (string)

The name of your key pair.

--cli-input-json (string) Performs service operation based on the JSON availability-zone provided. The JSON availability-zone follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.


operations -> (list)

An array of key-value pairs containing information about the results of your create instances request.


Describes the API operation.

id -> (string)

The ID of the operation.

resourceName -> (string)

The resource name.

resourceType -> (string)

The resource type.

createdAt -> (timestamp)

The timestamp when the operation was initialized (e.g., 1479816991.349 ).

location -> (structure)

The region and Availability Zone.

availabilityZone -> (string)

The Availability Zone. Follows the format us-east-2a (case-sensitive).

regionName -> (string)

The AWS Region name.

isTerminal -> (boolean)

A Boolean value indicating whether the operation is terminal.

operationDetails -> (string)

Details about the operation (e.g., Debian-1GB-Ohio-1 ).

operationType -> (string)

The type of operation.

status -> (string)

The status of the operation.

statusChangedAt -> (timestamp)

The timestamp when the status was changed (e.g., 1479816991.349 ).

errorCode -> (string)

The error code.

errorDetails -> (string)

The error details.