dcloud ec2 instances run

Launch an instance

IAM ec2:RunInstancesChanges state

Synopsis

dcloud ec2 instances run --region-id regionId [flags]

Flags

  • --server-typeOptional

    string

    An instance type, e.g. performance-2 (ec2 instance-types list). Give this or sizeClass. The provider’s own type names are still accepted, deprecated.

    Constraints: min 1 chars

  • --size-classOptional

    enum

    A size class instead of a provider type: s-2 (2 vCPU / 4 GiB), s-4 (4 / 8), s-8 (8 / 16), s-16 (16 / 32), m-4 (4 / 32), d-2 (2 dedicated / 8), d-8 (8 dedicated / 32), a-2, a-4, a-8, a-16 (ARM, as s-*); it becomes the smallest type of your provider that fits

    One of: s-2, s-4, s-8, s-16, m-4, d-2, d-8, a-2, a-4, a-8, a-16

  • --image-idOptional

    number

    An OS image from the catalog. Give this or machineImageId, not both.

    Constraints: integer, min 1

  • --machine-image-idOptional

    string

    One of your machine images (ewi-…), to launch a copy of a snapshot.

    Constraints: /^ewi-[0-9a-f]{6,32}$/

  • --region-idRequired

    string

    The region to launch in, e.g. de1

    Constraints: min 1 chars

  • --availability-zone-idOptional

    string

    Zone to run in (de1a = Falkenstein, de1b = Nuremberg); default the subnet’s, else de1a

    Constraints: /^[a-z]+[0-9]+[a-z]$/

  • --vpc-idOptional

    string

    The VPC to join; omitted: the region’s default VPC, created the first time it is needed

    Constraints: uuid

  • --nameOptional

    string

    A display name; omitted: none

    Constraints: max 64 chars

  • --ssh-key-pair-idOptional

    string

    A KMS SSH key pair (kms ssh-key-pairs)

    Constraints: uuid

  • --key-pair-idOptional

    string

    Instead of sshKeyPairId: a Compute key pair (ec2 key-pairs); not both

    Constraints: uuid

  • --user-dataOptional

    string

    A cloud-init script run at first boot, passed through unchanged

  • --tagsOptional

    map of string

    Tags for the instance (and its launch volumes); your organization’s required keys must be present

    Constraints: key=value

  • --security-group-idsOptional

    array of string

    Security groups to attach; omitted: none, so the instance is not filtered

    Constraints: uuid

  • --subnet-idOptional

    string

    A subnet of the VPC: the instance gets a fixed private address in its range and runs in its zone

    Constraints: uuid

  • --enable-public-ipv4Optional

    boolean (--enable-public-ipv4 / --no-enable-public-ipv4)

    Give the machine a public IPv4 (default true); false: IPv6 only, IPv4 out through the VPC’s NAT gateway if it has one

  • --os-patchingOptional

    boolean (--os-patching / --no-os-patching)

    Keep OS patched: install the platform patch reporter; security updates install nightly and reboots happen in the 02:00–05:00 UTC window. Ubuntu images only.

  • --connectOptional

    boolean (--connect / --no-connect)

    Deutsche Cloud Connect (default true): the machine keeps one outbound SSH connection to Deutsche Cloud so the console terminal and adding keys work with no inbound port. false: nothing is installed.

  • --iam-role-nameOptional

    string

    IAM role the machine acts as (needs iam:PassRole on it): it gets 60-minute credentials for it through its instance identity (`ews-instance credentials`), with no key in user data

    Constraints: 1-64 chars, /^[\w+=,.@-]+$/

  • --volumesOptional

    array of json

    Up to 4 extra volumes made with the instance in its zone, attached once it runs (needs ec2:CreateVolume and ec2:AttachVolume); encrypted and deleted with the instance unless told otherwise. CLI: --volumes '{"sizeGib":40}'

  • --public-hostnameOptional

    object

    Own hosts only: a name in one of your DNS zones (and *.name) that reaches this machine through the site’s front: HTTPS by SNI, SSH through the jump on port 2222. Needs dns:ChangeRecords on that zone; removed at terminate.

    Constraints: JSON

  • --idle-suspend-minutesOptional

    number

    Own hosts only: suspend the machine (memory saved) after this many idle minutes; the next HTTPS request or SSH connection through the front wakes it.

    Constraints: integer, 10-10080

  • --required-host-tagsOptional

    object

    Own hosts only: capability tags the machine’s host must carry (a name or name:value, e.g. fsync:high, cpu:a); only hosts with every one take it, else it waits saying which tag is missing. CLI: --required-host-tags fsync:high

    Constraints: JSON

Example

dcloud ec2 instances run --region-id example

Generated from the API description, the same one the API checks requests against and the CLI is built from.