Marketplace
BrowsePublish
Marketplace
You are viewing an outdated version of provider-aws.Go to Latest
upbound/provider-aws@v1.1.0
Instance
ec2.aws.upbound.io
Instance
upbound/provider-aws@v1.1.0ec2.aws.upbound.io

Instance is the Schema for the Instances API. Provides an EC2 instance resource. This allows instances to be created, updated, and deleted. Instances also support provisioning.

Type

CRD

Group

ec2.aws.upbound.io

Version

v1beta1

apiVersion: ec2.aws.upbound.io/v1beta1

kind: Instance

API Documentation
apiVersion
string
kind
string
metadata
object
spec
object
object

InstanceSpec defines the desired state of Instance

forProvider
requiredobject
requiredobject

No description provided.

ami
string
array

Describes an instance's Capacity Reservation targeting option. See Capacity Reservation Specification below for more details.

array

Information about the target Capacity Reservation. See Capacity Reservation Target below for more details.

array

The CPU options for the instance. See CPU Options below for more details.

array

Configuration block for customizing the credit specification of the instance. See Credit Specification below for more details. Removing this configuration on existing instances will only stop managing it. It will not change the configuration back to the default for the instance type.

array

One or more configuration blocks with additional EBS block devices to attach to the instance. Block device configurations only apply on resource creation. See Block Devices below for details on attributes and drift detection. When accessing this as an attribute reference, it is a set of objects.

encrypted
boolean
iops
number
kmsKeyId
string
object

Reference to a Key in kms to populate kmsKeyId.

name
requiredstring
policy
object
object

Policies for referencing.

resolve
string
object

Selector for a Key in kms to populate kmsKeyId.

policy
object
object

Policies for selection.

resolve
string
tags
object
array

Enable Nitro Enclaves on launched instances. See Enclave Options below for more details.

enabled
boolean
array

One or more configuration blocks to customize Ephemeral (also known as "Instance Store") volumes on the instance. See Block Devices below for details. When accessing this as an attribute reference, it is a set of objects.

hostId
string
array

Describes the market (purchasing) option for the instances. See Market Options below for details on attributes.

array

Block to configure the options for Spot Instances. See Spot Options below for details on attributes.

array

Specify one or more IPv6 addresses from the range of the subnet to associate with the primary network interface

keyName
string
array

Specifies a Launch Template to configure the instance. Parameters configured on this resource will override the corresponding parameters in the Launch Template. See Launch Template Specification below for more details.

id
string
name
string
version
string
array

Maintenance and recovery options for the instance. See Maintenance Options below for more details.

array

Customize the metadata options of the instance. See Metadata Options below for more details.

monitoring
boolean
array

Customize network interfaces to be attached at instance boot time. See Network Interfaces below for more details.

object

Reference to a NetworkInterface to populate networkInterfaceId.

name
requiredstring
policy
object
object

Policies for referencing.

resolve
string
object

Selector for a NetworkInterface to populate networkInterfaceId.

policy
object
object

Policies for selection.

resolve
string
array

Options for the instance hostname. The default values are inherited from the subnet. See Private DNS Name Options below for more details.

privateIp
string
region
requiredstring
array

Configuration block to customize details about the root block device of the instance. See Block Devices below for details. When accessing this as an attribute reference, it is a list containing one object.

encrypted
boolean
iops
number
kmsKeyId
string
object

Reference to a Key in kms to populate kmsKeyId.

name
requiredstring
policy
object
object

Policies for referencing.

resolve
string
object

Selector for a Key in kms to populate kmsKeyId.

policy
object
object

Policies for selection.

resolve
string
tags
object
array

List of secondary private IPv4 addresses to assign to the instance's primary network interface (eth0) in a VPC. Can only be assigned to the primary network interface (eth0) attached at instance creation, not a pre-existing network interface i.e., referenced in a network_interface block. Refer to the Elastic network interfaces documentation to see the maximum number of private IP addresses allowed per instance type.

subnetId
string
object

Reference to a Subnet to populate subnetId.

name
requiredstring
policy
object
object

Policies for referencing.

resolve
string
object

Selector for a Subnet to populate subnetId.

policy
object
object

Policies for selection.

resolve
string
tags
object
tenancy
string
userData
string
array

References to SecurityGroup to populate vpcSecurityGroupIds.

name
requiredstring
policy
object
object

Policies for referencing.

resolve
string
object

Selector for a list of SecurityGroup to populate vpcSecurityGroupIds.

policy
object
object

Policies for selection.

resolve
string
array

List of security group IDs to associate with.

object

THIS IS A BETA FIELD. It will be honored unless the Management Policies feature flag is disabled. InitProvider holds the same fields as ForProvider, with the exception of Identifier and other resource reference fields. The fields that are in InitProvider are merged into ForProvider when the resource is created. The same fields are also added to the terraform ignore_changes hook, to avoid updating them after creation. This is useful for fields that are required on creation, but we do not desire to update them after creation, for example because of an external controller is managing them, like an autoscaler.

ami
string
array

Describes an instance's Capacity Reservation targeting option. See Capacity Reservation Specification below for more details.

array

Information about the target Capacity Reservation. See Capacity Reservation Target below for more details.

array

The CPU options for the instance. See CPU Options below for more details.

array

Configuration block for customizing the credit specification of the instance. See Credit Specification below for more details. Removing this configuration on existing instances will only stop managing it. It will not change the configuration back to the default for the instance type.

array

One or more configuration blocks with additional EBS block devices to attach to the instance. Block device configurations only apply on resource creation. See Block Devices below for details on attributes and drift detection. When accessing this as an attribute reference, it is a set of objects.

encrypted
boolean
iops
number
kmsKeyId
string
object

Reference to a Key in kms to populate kmsKeyId.

name
requiredstring
policy
object
object

Policies for referencing.

resolve
string
object

Selector for a Key in kms to populate kmsKeyId.

policy
object
object

Policies for selection.

resolve
string
tags
object
array

Enable Nitro Enclaves on launched instances. See Enclave Options below for more details.

enabled
boolean
array

One or more configuration blocks to customize Ephemeral (also known as "Instance Store") volumes on the instance. See Block Devices below for details. When accessing this as an attribute reference, it is a set of objects.

hostId
string
array

Describes the market (purchasing) option for the instances. See Market Options below for details on attributes.

array

Block to configure the options for Spot Instances. See Spot Options below for details on attributes.

array

Specify one or more IPv6 addresses from the range of the subnet to associate with the primary network interface

keyName
string
array

Specifies a Launch Template to configure the instance. Parameters configured on this resource will override the corresponding parameters in the Launch Template. See Launch Template Specification below for more details.

id
string
name
string
version
string
array

Maintenance and recovery options for the instance. See Maintenance Options below for more details.

array

Customize the metadata options of the instance. See Metadata Options below for more details.

monitoring
boolean
array

Customize network interfaces to be attached at instance boot time. See Network Interfaces below for more details.

object

Reference to a NetworkInterface to populate networkInterfaceId.

name
requiredstring
policy
object
object

Policies for referencing.

resolve
string
object

Selector for a NetworkInterface to populate networkInterfaceId.

policy
object
object

Policies for selection.

resolve
string
array

Options for the instance hostname. The default values are inherited from the subnet. See Private DNS Name Options below for more details.

privateIp
string
array

Configuration block to customize details about the root block device of the instance. See Block Devices below for details. When accessing this as an attribute reference, it is a list containing one object.

encrypted
boolean
iops
number
kmsKeyId
string
object

Reference to a Key in kms to populate kmsKeyId.

name
requiredstring
policy
object
object

Policies for referencing.

resolve
string
object

Selector for a Key in kms to populate kmsKeyId.

policy
object
object

Policies for selection.

resolve
string
tags
object
array

List of secondary private IPv4 addresses to assign to the instance's primary network interface (eth0) in a VPC. Can only be assigned to the primary network interface (eth0) attached at instance creation, not a pre-existing network interface i.e., referenced in a network_interface block. Refer to the Elastic network interfaces documentation to see the maximum number of private IP addresses allowed per instance type.

subnetId
string
object

Reference to a Subnet to populate subnetId.

name
requiredstring
policy
object
object

Policies for referencing.

resolve
string
object

Selector for a Subnet to populate subnetId.

policy
object
object

Policies for selection.

resolve
string
tags
object
tenancy
string
userData
string
array

References to SecurityGroup to populate vpcSecurityGroupIds.

name
requiredstring
policy
object
object

Policies for referencing.

resolve
string
object

Selector for a list of SecurityGroup to populate vpcSecurityGroupIds.

policy
object
object

Policies for selection.

resolve
string
array

List of security group IDs to associate with.

array

THIS IS A BETA FIELD. It is on by default but can be opted out through a Crossplane feature flag. ManagementPolicies specify the array of actions Crossplane is allowed to take on the managed and external resources. This field is planned to replace the DeletionPolicy field in a future release. Currently, both could be set independently and non-default values would be honored if the feature flag is enabled. If both are custom, the DeletionPolicy field will be ignored. See the design doc for more information: https://github.com/crossplane/crossplane/blob/499895a25d1a1a0ba1604944ef98ac7a1a71f197/design/design-doc-observe-only-resources.md?plain=1#L223 and this one: https://github.com/crossplane/crossplane/blob/444267e84783136daa93568b364a5f01228cacbe/design/one-pager-ignore-changes.md

object

ProviderConfigReference specifies how the provider that will be used to create, observe, update, and delete this managed resource should be configured.

name
requiredstring
policy
object
object

Policies for referencing.

resolve
string
object

PublishConnectionDetailsTo specifies the connection secret config which contains a name, metadata and a reference to secret store config to which any connection details for this managed resource should be written. Connection details frequently include the endpoint, username, and password required to connect to the managed resource.

configRef
object
object

SecretStoreConfigRef specifies which secret store config should be used for this ConnectionSecret.

name
requiredstring
policy
object
object

Policies for referencing.

resolve
string
metadata
object
object

Metadata is the metadata for connection secret.

labels
object
type
string
name
requiredstring
object

WriteConnectionSecretToReference specifies the namespace and name of a Secret to which any connection details for this managed resource should be written. Connection details frequently include the endpoint, username, and password required to connect to the managed resource. This field is planned to be replaced in a future release in favor of PublishConnectionDetailsTo. Currently, both could be set independently and connection details would be published to both without affecting each other.

name
requiredstring
namespace
requiredstring
status
object
object

InstanceStatus defines the observed state of Instance.

object

No description provided.

ami
string
arn
string
array

Describes an instance's Capacity Reservation targeting option. See Capacity Reservation Specification below for more details.

array

Information about the target Capacity Reservation. See Capacity Reservation Target below for more details.

array

The CPU options for the instance. See CPU Options below for more details.

array

Configuration block for customizing the credit specification of the instance. See Credit Specification below for more details. Removing this configuration on existing instances will only stop managing it. It will not change the configuration back to the default for the instance type.

array

One or more configuration blocks with additional EBS block devices to attach to the instance. Block device configurations only apply on resource creation. See Block Devices below for details on attributes and drift detection. When accessing this as an attribute reference, it is a set of objects.

encrypted
boolean
iops
number
kmsKeyId
string
tags
object
volumeId
string
array

Enable Nitro Enclaves on launched instances. See Enclave Options below for more details.

enabled
boolean
array

One or more configuration blocks to customize Ephemeral (also known as "Instance Store") volumes on the instance. See Block Devices below for details. When accessing this as an attribute reference, it is a set of objects.

hostId
string
id
string
array

Describes the market (purchasing) option for the instances. See Market Options below for details on attributes.

array

Block to configure the options for Spot Instances. See Spot Options below for details on attributes.

array

Specify one or more IPv6 addresses from the range of the subnet to associate with the primary network interface

keyName
string
array

Specifies a Launch Template to configure the instance. Parameters configured on this resource will override the corresponding parameters in the Launch Template. See Launch Template Specification below for more details.

id
string
name
string
version
string
array

Maintenance and recovery options for the instance. See Maintenance Options below for more details.

array

Customize the metadata options of the instance. See Metadata Options below for more details.

monitoring
boolean
array

Customize network interfaces to be attached at instance boot time. See Network Interfaces below for more details.

array

Options for the instance hostname. The default values are inherited from the subnet. See Private DNS Name Options below for more details.

privateIp
string
publicDns
string
publicIp
string
array

Configuration block to customize details about the root block device of the instance. See Block Devices below for details. When accessing this as an attribute reference, it is a list containing one object.

encrypted
boolean
iops
number
kmsKeyId
string
tags
object
volumeId
string
array

List of secondary private IPv4 addresses to assign to the instance's primary network interface (eth0) in a VPC. Can only be assigned to the primary network interface (eth0) attached at instance creation, not a pre-existing network interface i.e., referenced in a network_interface block. Refer to the Elastic network interfaces documentation to see the maximum number of private IP addresses allowed per instance type.

array

List of security group names to associate with.

subnetId
string
tags
object
tagsAll
object
tenancy
string
userData
string
array

List of security group IDs to associate with.

array

Conditions of the resource.

lastTransitionTime
requiredstring
message
string
reason
requiredstring
status
requiredstring
type
requiredstring
Marketplace

Discover the building blocks for your internal cloud platform.

© 2022 Upbound, Inc.

SolutionsProvidersConfigurations
LearnDocumentationTry for Free
MorePrivacy PolicyTerms & Conditions
Marketplace

© 2022 Upbound, Inc.

Marketplace

Discover the building blocksfor your internal cloud platform.