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
InstanceSpec defines the desired state of Instance
No description provided.
Describes an instance's Capacity Reservation targeting option. See Capacity Reservation Specification below for more details.
Information about the target Capacity Reservation. See Capacity Reservation Target below for more details.
The CPU options for the instance. See CPU Options below for more details.
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.
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.
Reference to a Key in kms to populate kmsKeyId.
Policies for referencing.
Selector for a Key in kms to populate kmsKeyId.
Policies for selection.
Enable Nitro Enclaves on launched instances. See Enclave Options below for more details.
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.
Describes the market (purchasing) option for the instances. See Market Options below for details on attributes.
Block to configure the options for Spot Instances. See Spot Options below for details on attributes.
Specify one or more IPv6 addresses from the range of the subnet to associate with the primary network interface
Maintenance and recovery options for the instance. See Maintenance Options below for more details.
Customize the metadata options of the instance. See Metadata Options below for more details.
Customize network interfaces to be attached at instance boot time. See Network Interfaces below for more details.
Reference to a NetworkInterface to populate networkInterfaceId.
Policies for referencing.
Selector for a NetworkInterface to populate networkInterfaceId.
Policies for selection.
Options for the instance hostname. The default values are inherited from the subnet. See Private DNS Name Options below for more details.
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.
Reference to a Key in kms to populate kmsKeyId.
Policies for referencing.
Selector for a Key in kms to populate kmsKeyId.
Policies for selection.
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.
Reference to a Subnet to populate subnetId.
Policies for referencing.
Selector for a Subnet to populate subnetId.
Policies for selection.
References to SecurityGroup to populate vpcSecurityGroupIds.
Policies for referencing.
Selector for a list of SecurityGroup to populate vpcSecurityGroupIds.
Policies for selection.
List of security group IDs to associate with.
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.
Describes an instance's Capacity Reservation targeting option. See Capacity Reservation Specification below for more details.
Information about the target Capacity Reservation. See Capacity Reservation Target below for more details.
The CPU options for the instance. See CPU Options below for more details.
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.
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.
Reference to a Key in kms to populate kmsKeyId.
Policies for referencing.
Selector for a Key in kms to populate kmsKeyId.
Policies for selection.
Enable Nitro Enclaves on launched instances. See Enclave Options below for more details.
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.
Describes the market (purchasing) option for the instances. See Market Options below for details on attributes.
Block to configure the options for Spot Instances. See Spot Options below for details on attributes.
Specify one or more IPv6 addresses from the range of the subnet to associate with the primary network interface
Maintenance and recovery options for the instance. See Maintenance Options below for more details.
Customize the metadata options of the instance. See Metadata Options below for more details.
Customize network interfaces to be attached at instance boot time. See Network Interfaces below for more details.
Reference to a NetworkInterface to populate networkInterfaceId.
Policies for referencing.
Selector for a NetworkInterface to populate networkInterfaceId.
Policies for selection.
Options for the instance hostname. The default values are inherited from the subnet. See Private DNS Name Options below for more details.
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.
Reference to a Key in kms to populate kmsKeyId.
Policies for referencing.
Selector for a Key in kms to populate kmsKeyId.
Policies for selection.
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.
Reference to a Subnet to populate subnetId.
Policies for referencing.
Selector for a Subnet to populate subnetId.
Policies for selection.
References to SecurityGroup to populate vpcSecurityGroupIds.
Policies for referencing.
Selector for a list of SecurityGroup to populate vpcSecurityGroupIds.
Policies for selection.
List of security group IDs to associate with.
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
ProviderConfigReference specifies how the provider that will be used to create, observe, update, and delete this managed resource should be configured.
Policies for referencing.
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.
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.
InstanceStatus defines the observed state of Instance.
No description provided.
Describes an instance's Capacity Reservation targeting option. See Capacity Reservation Specification below for more details.
Information about the target Capacity Reservation. See Capacity Reservation Target below for more details.
The CPU options for the instance. See CPU Options below for more details.
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.
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.
Enable Nitro Enclaves on launched instances. See Enclave Options below for more details.
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.
Describes the market (purchasing) option for the instances. See Market Options below for details on attributes.
Block to configure the options for Spot Instances. See Spot Options below for details on attributes.
Specify one or more IPv6 addresses from the range of the subnet to associate with the primary network interface
Maintenance and recovery options for the instance. See Maintenance Options below for more details.
Customize the metadata options of the instance. See Metadata Options below for more details.
Customize network interfaces to be attached at instance boot time. See Network Interfaces below for more details.
Options for the instance hostname. The default values are inherited from the subnet. See Private DNS Name Options below for more details.
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.
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.
List of security group names to associate with.
List of security group IDs to associate with.
Conditions of the resource.
test
apiVersion: ec2.aws.upbound.io/v1beta1
kind: Instance
metadata:
labels:
testing.upbound.io/example-name: test
name: test
spec:
forProvider:
ami: ami-0d9858aa3c6322f73
instanceType: t2.micro
networkInterface:
- deviceIndex: 0
networkInterfaceIdRef:
name: test
region: us-west-1
upbound-instance
apiVersion: ec2.aws.upbound.io/v1beta1
kind: Instance
metadata:
name: upbound-instance
spec:
forProvider:
ami: ami-07b068f843ec78e72
creditSpecification:
- cpuCredits: unlimited
instanceType: t2.micro
networkInterface:
- deviceIndex: 0
networkInterfaceIdRef:
name: sample-ni
region: us-west-1
test
apiVersion: ec2.aws.upbound.io/v1beta1
kind: Instance
metadata:
annotations:
meta.upbound.io/example-id: ssm/v1beta1/maintenancewindowtask
labels:
testing.upbound.io/example-name: test
name: test
spec:
forProvider:
ami: ami-0b5eea76982371e91
instanceType: t2.micro
networkInterface:
- deviceIndex: 0
networkInterfaceIdRef:
name: test
region: us-east-1
test
apiVersion: ec2.aws.upbound.io/v1beta1
kind: Instance
metadata:
annotations:
meta.upbound.io/example-id: ec2/v1beta1/instancestate
labels:
testing.upbound.io/example-name: test
name: test
spec:
forProvider:
ami: ${data.aws_ami.ubuntu.id}
instanceType: t3.micro
region: us-west-1
tags:
Name: HelloWorld
instance
apiVersion: ec2.aws.upbound.io/v1beta1
kind: Instance
metadata:
labels:
testing.upbound.io/example-name: instance
name: instance
spec:
forProvider:
ami: ami-0d9858aa3c6322f73
instanceType: t2.micro
region: us-west-1
tags:
type: upbound-test-instance
web
apiVersion: ec2.aws.upbound.io/v1beta1
kind: Instance
metadata:
labels:
testing.upbound.io/example-name: web
name: web
spec:
forProvider:
ami: ami-0d9858aa3c6322f73
availabilityZone: us-west-1c
instanceType: t2.micro
region: us-west-1
tags:
Name: HelloWorld
sample-instance
apiVersion: ec2.aws.upbound.io/v1beta1
kind: Instance
metadata:
annotations:
meta.upbound.io/example-id: ec2/v1beta1/instance
uptest.upbound.io/timeout: "3600"
labels:
testing.upbound.io/example-name: sample-instance
name: sample-instance
spec:
forProvider:
ami: ami-07b068f843ec78e72
creditSpecification:
- cpuCredits: unlimited
instanceType: t2.micro
networkInterface:
- deviceIndex: 0
networkInterfaceIdSelector:
matchLabels:
testing.upbound.io/example-name: sample-instance
region: us-west-1
© 2022 Upbound, Inc.
Discover the building blocksfor your internal cloud platform.