Instance
Describes an instance (a virtual private server).
Contents
- addOns
-
An array of objects representing the add-ons enabled on the instance.
Type: Array of AddOn objects
Required: No
- arn
-
The Amazon Resource Name (ARN) of the instance (
arn:aws:lightsail:us-east-2:123456789101:Instance/244ad76f-8aad-4741-809f-12345EXAMPLE
).Type: String
Pattern:
.*\S.*
Required: No
- blueprintId
-
The blueprint ID (
amazon_linux_2023
).Type: String
Pattern:
.*\S.*
Required: No
- blueprintName
-
The friendly name of the blueprint (
Amazon Linux 2023
).Type: String
Pattern:
.*\S.*
Required: No
- bundleId
-
The bundle for the instance (
micro_x_x
).Type: String
Pattern:
.*\S.*
Required: No
- createdAt
-
The timestamp when the instance was created (
1479734909.17
) in Unix time format.Type: Timestamp
Required: No
- hardware
-
The size of the vCPU and the amount of RAM for the instance.
Type: InstanceHardware object
Required: No
- ipAddressType
-
The IP address type of the instance.
The possible values are
ipv4
for IPv4 only,ipv6
for IPv6 only, anddualstack
for IPv4 and IPv6.Type: String
Valid Values:
dualstack | ipv4 | ipv6
Required: No
- ipv6Addresses
-
The IPv6 addresses of the instance.
Type: Array of strings
Pattern:
([A-F0-9]{1,4}:){7}[A-F0-9]{1,4}
Required: No
- isStaticIp
-
A Boolean value indicating whether this instance has a static IP assigned to it.
Type: Boolean
Required: No
- location
-
The region name and Availability Zone where the instance is located.
Type: ResourceLocation object
Required: No
- metadataOptions
-
The metadata options for the Amazon Lightsail instance.
Type: InstanceMetadataOptions object
Required: No
- name
-
The name the user gave the instance (
Amazon_Linux_2023-1
).Type: String
Pattern:
\w[\w\-]*\w
Required: No
- networking
-
Information about the public ports and monthly data transfer rates for the instance.
Type: InstanceNetworking object
Required: No
- privateIpAddress
-
The private IP address of the instance.
Type: String
Pattern:
([0-9]{1,3}\.){3}[0-9]{1,3}
Required: No
- publicIpAddress
-
The public IP address of the instance.
Type: String
Pattern:
([0-9]{1,3}\.){3}[0-9]{1,3}
Required: No
- resourceType
-
The type of resource (usually
Instance
).Type: String
Valid Values:
ContainerService | Instance | StaticIp | KeyPair | InstanceSnapshot | Domain | PeeredVpc | LoadBalancer | LoadBalancerTlsCertificate | Disk | DiskSnapshot | RelationalDatabase | RelationalDatabaseSnapshot | ExportSnapshotRecord | CloudFormationStackRecord | Alarm | ContactMethod | Distribution | Certificate | Bucket
Required: No
- sshKeyName
-
The name of the SSH key being used to connect to the instance (
LightsailDefaultKeyPair
).Type: String
Pattern:
\w[\w\-]*\w
Required: No
- state
-
The status code and the state (
running
) for the instance.Type: InstanceState object
Required: No
- supportCode
-
The support code. Include this code in your email to support when you have questions about an instance or another resource in Lightsail. This code enables our support team to look up your Lightsail information more easily.
Type: String
Required: No
-
The tag keys and optional values for the resource. For more information about tags in Lightsail, see the Amazon Lightsail Developer Guide
. Type: Array of Tag objects
Required: No
- username
-
The user name for connecting to the instance (
ec2-user
).Type: String
Pattern:
.*\S.*
Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: