/*
* Copyright 2010-2016 Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License").
* You may not use this file except in compliance with the License.
* A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed
* on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
* express or implied. See the License for the specific language governing
* permissions and limitations under the License.
*/
package com.amazonaws.services.ec2.model;
import java.io.Serializable;
import com.amazonaws.AmazonWebServiceRequest;
import com.amazonaws.Request;
import com.amazonaws.services.ec2.model.transform.DescribeInstancesRequestMarshaller;
/**
* Container for the parameters to the {@link com.amazonaws.services.ec2.AmazonEC2#describeInstances(DescribeInstancesRequest) DescribeInstances operation}.
* <p>
* Describes one or more of your instances.
* </p>
* <p>
* If you specify one or more instance IDs, Amazon EC2 returns
* information for those instances. If you do not specify instance IDs,
* Amazon EC2 returns information for all relevant instances. If you
* specify an instance ID that is not valid, an error is returned. If you
* specify an instance that you do not own, it is not included in the
* returned results.
* </p>
* <p>
* Recently terminated instances might appear in the returned results.
* This interval is usually less than one hour.
* </p>
*
* @see com.amazonaws.services.ec2.AmazonEC2#describeInstances(DescribeInstancesRequest)
*/
public class DescribeInstancesRequest extends AmazonWebServiceRequest implements Serializable, DryRunSupportedRequest<DescribeInstancesRequest> {
/**
* One or more instance IDs. <p>Default: Describes all your instances.
*/
private com.amazonaws.internal.ListWithAutoConstructFlag<String> instanceIds;
/**
* One or more filters. <ul> <li> <p><code>affinity</code> - The affinity
* setting for an instance running on a Dedicated host
* (<code>default</code> | <code>host</code>). </li> <li>
* <p><code>architecture</code> - The instance architecture
* (<code>i386</code> | <code>x86_64</code>). </li> <li>
* <p><code>availability-zone</code> - The Availability Zone of the
* instance. </li> <li> <p><code>block-device-mapping.attach-time</code>
* - The attach time for an EBS volume mapped to the instance, for
* example, <code>2010-09-15T17:15:20.000Z</code>. </li> <li>
* <p><code>block-device-mapping.delete-on-termination</code> - A Boolean
* that indicates whether the EBS volume is deleted on instance
* termination. </li> <li>
* <p><code>block-device-mapping.device-name</code> - The device name for
* the EBS volume (for example, <code>/dev/sdh</code> or
* <code>xvdh</code>). </li> <li>
* <p><code>block-device-mapping.status</code> - The status for the EBS
* volume (<code>attaching</code> | <code>attached</code> |
* <code>detaching</code> | <code>detached</code>). </li> <li>
* <p><code>block-device-mapping.volume-id</code> - The volume ID of the
* EBS volume. </li> <li> <p><code>client-token</code> - The idempotency
* token you provided when you launched the instance. </li> <li>
* <p><code>dns-name</code> - The public DNS name of the instance. </li>
* <li> <p><code>group-id</code> - The ID of the security group for the
* instance. EC2-Classic only. </li> <li> <p><code>group-name</code> -
* The name of the security group for the instance. EC2-Classic only.
* </li> <li> <p><code>host-Id</code> - The ID of the Dedicated host on
* which the instance is running, if applicable. </li> <li>
* <p><code>hypervisor</code> - The hypervisor type of the instance
* (<code>ovm</code> | <code>xen</code>). </li> <li>
* <p><code>iam-instance-profile.arn</code> - The instance profile
* associated with the instance. Specified as an ARN. </li> <li>
* <p><code>image-id</code> - The ID of the image used to launch the
* instance. </li> <li> <p><code>instance-id</code> - The ID of the
* instance. </li> <li> <p><code>instance-lifecycle</code> - Indicates
* whether this is a Spot Instance or a Scheduled Instance
* (<code>spot</code> | <code>scheduled</code>). </li> <li>
* <p><code>instance-state-code</code> - The state of the instance, as a
* 16-bit unsigned integer. The high byte is an opaque internal value and
* should be ignored. The low byte is set based on the state represented.
* The valid values are: 0 (pending), 16 (running), 32 (shutting-down),
* 48 (terminated), 64 (stopping), and 80 (stopped). </li> <li>
* <p><code>instance-state-name</code> - The state of the instance
* (<code>pending</code> | <code>running</code> |
* <code>shutting-down</code> | <code>terminated</code> |
* <code>stopping</code> | <code>stopped</code>). </li> <li>
* <p><code>instance-type</code> - The type of instance (for example,
* <code>t2.micro</code>). </li> <li> <p><code>instance.group-id</code> -
* The ID of the security group for the instance. </li> <li>
* <p><code>instance.group-name</code> - The name of the security group
* for the instance. </li> <li> <p><code>ip-address</code> - The public
* IP address of the instance. </li> <li> <p><code>kernel-id</code> - The
* kernel ID. </li> <li> <p><code>key-name</code> - The name of the key
* pair used when the instance was launched. </li> <li>
* <p><code>launch-index</code> - When launching multiple instances, this
* is the index for the instance in the launch group (for example, 0, 1,
* 2, and so on). </li> <li> <p><code>launch-time</code> - The time when
* the instance was launched. </li> <li> <p><code>monitoring-state</code>
* - Indicates whether monitoring is enabled for the instance
* (<code>disabled</code> | <code>enabled</code>). </li> <li>
* <p><code>owner-id</code> - The AWS account ID of the instance owner.
* </li> <li> <p><code>placement-group-name</code> - The name of the
* placement group for the instance. </li> <li> <p><code>platform</code>
* - The platform. Use <code>windows</code> if you have Windows
* instances; otherwise, leave blank. </li> <li>
* <p><code>private-dns-name</code> - The private DNS name of the
* instance. </li> <li> <p><code>private-ip-address</code> - The private
* IP address of the instance. </li> <li> <p><code>product-code</code> -
* The product code associated with the AMI used to launch the instance.
* </li> <li> <p><code>product-code.type</code> - The type of product
* code (<code>devpay</code> | <code>marketplace</code>). </li> <li>
* <p><code>ramdisk-id</code> - The RAM disk ID. </li> <li>
* <p><code>reason</code> - The reason for the current state of the
* instance (for example, shows "User Initiated [date]" when you stop or
* terminate the instance). Similar to the state-reason-code filter.
* </li> <li> <p><code>requester-id</code> - The ID of the entity that
* launched the instance on your behalf (for example, AWS Management
* Console, Auto Scaling, and so on). </li> <li>
* <p><code>reservation-id</code> - The ID of the instance's reservation.
* A reservation ID is created any time you launch an instance. A
* reservation ID has a one-to-one relationship with an instance launch
* request, but can be associated with more than one instance if you
* launch multiple instances using the same launch request. For example,
* if you launch one instance, you'll get one reservation ID. If you
* launch ten instances using the same launch request, you'll also get
* one reservation ID. </li> <li> <p><code>root-device-name</code> - The
* name of the root device for the instance (for example,
* <code>/dev/sda1</code> or <code>/dev/xvda</code>). </li> <li>
* <p><code>root-device-type</code> - The type of root device that the
* instance uses (<code>ebs</code> | <code>instance-store</code>). </li>
* <li> <p><code>source-dest-check</code> - Indicates whether the
* instance performs source/destination checking. A value of
* <code>true</code> means that checking is enabled, and
* <code>false</code> means checking is disabled. The value must be
* <code>false</code> for the instance to perform network address
* translation (NAT) in your VPC. </li> <li>
* <p><code>spot-instance-request-id</code> - The ID of the Spot instance
* request. </li> <li> <p><code>state-reason-code</code> - The reason
* code for the state change. </li> <li>
* <p><code>state-reason-message</code> - A message that describes the
* state change. </li> <li> <p><code>subnet-id</code> - The ID of the
* subnet for the instance. </li> <li>
* <p><code>tag</code>:<i>key</i>=<i>value</i> - The key/value
* combination of a tag assigned to the resource, where
* <code>tag</code>:<i>key</i> is the tag's key. </li> <li>
* <p><code>tag-key</code> - The key of a tag assigned to the resource.
* This filter is independent of the <code>tag-value</code> filter. For
* example, if you use both the filter "tag-key=Purpose" and the filter
* "tag-value=X", you get any resources assigned both the tag key Purpose
* (regardless of what the tag's value is), and the tag value X
* (regardless of what the tag's key is). If you want to list only
* resources where Purpose is X, see the
* <code>tag</code>:<i>key</i>=<i>value</i> filter. </li> <li>
* <p><code>tag-value</code> - The value of a tag assigned to the
* resource. This filter is independent of the <code>tag-key</code>
* filter. </li> <li> <p><code>tenancy</code> - The tenancy of an
* instance (<code>dedicated</code> | <code>default</code> |
* <code>host</code>). </li> <li> <p><code>virtualization-type</code> -
* The virtualization type of the instance (<code>paravirtual</code> |
* <code>hvm</code>). </li> <li> <p><code>vpc-id</code> - The ID of the
* VPC that the instance is running in. </li> <li>
* <p><code>network-interface.description</code> - The description of the
* network interface. </li> <li>
* <p><code>network-interface.subnet-id</code> - The ID of the subnet for
* the network interface. </li> <li>
* <p><code>network-interface.vpc-id</code> - The ID of the VPC for the
* network interface. </li> <li>
* <p><code>network-interface.network-interface-id</code> - The ID of the
* network interface. </li> <li>
* <p><code>network-interface.owner-id</code> - The ID of the owner of
* the network interface. </li> <li>
* <p><code>network-interface.availability-zone</code> - The Availability
* Zone for the network interface. </li> <li>
* <p><code>network-interface.requester-id</code> - The requester ID for
* the network interface. </li> <li>
* <p><code>network-interface.requester-managed</code> - Indicates
* whether the network interface is being managed by AWS. </li> <li>
* <p><code>network-interface.status</code> - The status of the network
* interface (<code>available</code>) | <code>in-use</code>). </li> <li>
* <p><code>network-interface.mac-address</code> - The MAC address of the
* network interface. </li> <li>
* <p><code>network-interface.private-dns-name</code> - The private DNS
* name of the network interface. </li> <li>
* <p><code>network-interface.source-dest-check</code> - Whether the
* network interface performs source/destination checking. A value of
* <code>true</code> means checking is enabled, and <code>false</code>
* means checking is disabled. The value must be <code>false</code> for
* the network interface to perform network address translation (NAT) in
* your VPC. </li> <li> <p><code>network-interface.group-id</code> - The
* ID of a security group associated with the network interface. </li>
* <li> <p><code>network-interface.group-name</code> - The name of a
* security group associated with the network interface. </li> <li>
* <p><code>network-interface.attachment.attachment-id</code> - The ID of
* the interface attachment. </li> <li>
* <p><code>network-interface.attachment.instance-id</code> - The ID of
* the instance to which the network interface is attached. </li> <li>
* <p><code>network-interface.attachment.instance-owner-id</code> - The
* owner ID of the instance to which the network interface is attached.
* </li> <li>
* <p><code>network-interface.addresses.private-ip-address</code> - The
* private IP address associated with the network interface. </li> <li>
* <p><code>network-interface.attachment.device-index</code> - The device
* index to which the network interface is attached. </li> <li>
* <p><code>network-interface.attachment.status</code> - The status of
* the attachment (<code>attaching</code> | <code>attached</code> |
* <code>detaching</code> | <code>detached</code>). </li> <li>
* <p><code>network-interface.attachment.attach-time</code> - The time
* that the network interface was attached to an instance. </li> <li>
* <p><code>network-interface.attachment.delete-on-termination</code> -
* Specifies whether the attachment is deleted when an instance is
* terminated. </li> <li>
* <p><code>network-interface.addresses.primary</code> - Specifies
* whether the IP address of the network interface is the primary private
* IP address. </li> <li>
* <p><code>network-interface.addresses.association.public-ip</code> -
* The ID of the association of an Elastic IP address with a network
* interface. </li> <li>
* <p><code>network-interface.addresses.association.ip-owner-id</code> -
* The owner ID of the private IP address associated with the network
* interface. </li> <li> <p><code>association.public-ip</code> - The
* address of the Elastic IP address bound to the network interface.
* </li> <li> <p><code>association.ip-owner-id</code> - The owner of the
* Elastic IP address associated with the network interface. </li> <li>
* <p><code>association.allocation-id</code> - The allocation ID returned
* when you allocated the Elastic IP address for your network interface.
* </li> <li> <p><code>association.association-id</code> - The
* association ID returned when the network interface was associated with
* an IP address. </li> </ul>
*/
private com.amazonaws.internal.ListWithAutoConstructFlag<Filter> filters;
/**
* The token to request the next page of results.
*/
private String nextToken;
/**
* The maximum number of results to return in a single call. To retrieve
* the remaining results, make another call with the returned
* <code>NextToken</code> value. This value can be between 5 and 1000.
* You cannot specify this parameter and the instance IDs parameter or
* tag filters in the same call.
*/
private Integer maxResults;
/**
* One or more instance IDs. <p>Default: Describes all your instances.
*
* @return One or more instance IDs. <p>Default: Describes all your instances.
*/
public java.util.List<String> getInstanceIds() {
if (instanceIds == null) {
instanceIds = new com.amazonaws.internal.ListWithAutoConstructFlag<String>();
instanceIds.setAutoConstruct(true);
}
return instanceIds;
}
/**
* One or more instance IDs. <p>Default: Describes all your instances.
*
* @param instanceIds One or more instance IDs. <p>Default: Describes all your instances.
*/
public void setInstanceIds(java.util.Collection<String> instanceIds) {
if (instanceIds == null) {
this.instanceIds = null;
return;
}
com.amazonaws.internal.ListWithAutoConstructFlag<String> instanceIdsCopy = new com.amazonaws.internal.ListWithAutoConstructFlag<String>(instanceIds.size());
instanceIdsCopy.addAll(instanceIds);
this.instanceIds = instanceIdsCopy;
}
/**
* One or more instance IDs. <p>Default: Describes all your instances.
* <p>
* Returns a reference to this object so that method calls can be chained together.
*
* @param instanceIds One or more instance IDs. <p>Default: Describes all your instances.
*
* @return A reference to this updated object so that method calls can be chained
* together.
*/
public DescribeInstancesRequest withInstanceIds(String... instanceIds) {
if (getInstanceIds() == null) setInstanceIds(new java.util.ArrayList<String>(instanceIds.length));
for (String value : instanceIds) {
getInstanceIds().add(value);
}
return this;
}
/**
* One or more instance IDs. <p>Default: Describes all your instances.
* <p>
* Returns a reference to this object so that method calls can be chained together.
*
* @param instanceIds One or more instance IDs. <p>Default: Describes all your instances.
*
* @return A reference to this updated object so that method calls can be chained
* together.
*/
public DescribeInstancesRequest withInstanceIds(java.util.Collection<String> instanceIds) {
if (instanceIds == null) {
this.instanceIds = null;
} else {
com.amazonaws.internal.ListWithAutoConstructFlag<String> instanceIdsCopy = new com.amazonaws.internal.ListWithAutoConstructFlag<String>(instanceIds.size());
instanceIdsCopy.addAll(instanceIds);
this.instanceIds = instanceIdsCopy;
}
return this;
}
/**
* One or more filters. <ul> <li> <p><code>affinity</code> - The affinity
* setting for an instance running on a Dedicated host
* (<code>default</code> | <code>host</code>). </li> <li>
* <p><code>architecture</code> - The instance architecture
* (<code>i386</code> | <code>x86_64</code>). </li> <li>
* <p><code>availability-zone</code> - The Availability Zone of the
* instance. </li> <li> <p><code>block-device-mapping.attach-time</code>
* - The attach time for an EBS volume mapped to the instance, for
* example, <code>2010-09-15T17:15:20.000Z</code>. </li> <li>
* <p><code>block-device-mapping.delete-on-termination</code> - A Boolean
* that indicates whether the EBS volume is deleted on instance
* termination. </li> <li>
* <p><code>block-device-mapping.device-name</code> - The device name for
* the EBS volume (for example, <code>/dev/sdh</code> or
* <code>xvdh</code>). </li> <li>
* <p><code>block-device-mapping.status</code> - The status for the EBS
* volume (<code>attaching</code> | <code>attached</code> |
* <code>detaching</code> | <code>detached</code>). </li> <li>
* <p><code>block-device-mapping.volume-id</code> - The volume ID of the
* EBS volume. </li> <li> <p><code>client-token</code> - The idempotency
* token you provided when you launched the instance. </li> <li>
* <p><code>dns-name</code> - The public DNS name of the instance. </li>
* <li> <p><code>group-id</code> - The ID of the security group for the
* instance. EC2-Classic only. </li> <li> <p><code>group-name</code> -
* The name of the security group for the instance. EC2-Classic only.
* </li> <li> <p><code>host-Id</code> - The ID of the Dedicated host on
* which the instance is running, if applicable. </li> <li>
* <p><code>hypervisor</code> - The hypervisor type of the instance
* (<code>ovm</code> | <code>xen</code>). </li> <li>
* <p><code>iam-instance-profile.arn</code> - The instance profile
* associated with the instance. Specified as an ARN. </li> <li>
* <p><code>image-id</code> - The ID of the image used to launch the
* instance. </li> <li> <p><code>instance-id</code> - The ID of the
* instance. </li> <li> <p><code>instance-lifecycle</code> - Indicates
* whether this is a Spot Instance or a Scheduled Instance
* (<code>spot</code> | <code>scheduled</code>). </li> <li>
* <p><code>instance-state-code</code> - The state of the instance, as a
* 16-bit unsigned integer. The high byte is an opaque internal value and
* should be ignored. The low byte is set based on the state represented.
* The valid values are: 0 (pending), 16 (running), 32 (shutting-down),
* 48 (terminated), 64 (stopping), and 80 (stopped). </li> <li>
* <p><code>instance-state-name</code> - The state of the instance
* (<code>pending</code> | <code>running</code> |
* <code>shutting-down</code> | <code>terminated</code> |
* <code>stopping</code> | <code>stopped</code>). </li> <li>
* <p><code>instance-type</code> - The type of instance (for example,
* <code>t2.micro</code>). </li> <li> <p><code>instance.group-id</code> -
* The ID of the security group for the instance. </li> <li>
* <p><code>instance.group-name</code> - The name of the security group
* for the instance. </li> <li> <p><code>ip-address</code> - The public
* IP address of the instance. </li> <li> <p><code>kernel-id</code> - The
* kernel ID. </li> <li> <p><code>key-name</code> - The name of the key
* pair used when the instance was launched. </li> <li>
* <p><code>launch-index</code> - When launching multiple instances, this
* is the index for the instance in the launch group (for example, 0, 1,
* 2, and so on). </li> <li> <p><code>launch-time</code> - The time when
* the instance was launched. </li> <li> <p><code>monitoring-state</code>
* - Indicates whether monitoring is enabled for the instance
* (<code>disabled</code> | <code>enabled</code>). </li> <li>
* <p><code>owner-id</code> - The AWS account ID of the instance owner.
* </li> <li> <p><code>placement-group-name</code> - The name of the
* placement group for the instance. </li> <li> <p><code>platform</code>
* - The platform. Use <code>windows</code> if you have Windows
* instances; otherwise, leave blank. </li> <li>
* <p><code>private-dns-name</code> - The private DNS name of the
* instance. </li> <li> <p><code>private-ip-address</code> - The private
* IP address of the instance. </li> <li> <p><code>product-code</code> -
* The product code associated with the AMI used to launch the instance.
* </li> <li> <p><code>product-code.type</code> - The type of product
* code (<code>devpay</code> | <code>marketplace</code>). </li> <li>
* <p><code>ramdisk-id</code> - The RAM disk ID. </li> <li>
* <p><code>reason</code> - The reason for the current state of the
* instance (for example, shows "User Initiated [date]" when you stop or
* terminate the instance). Similar to the state-reason-code filter.
* </li> <li> <p><code>requester-id</code> - The ID of the entity that
* launched the instance on your behalf (for example, AWS Management
* Console, Auto Scaling, and so on). </li> <li>
* <p><code>reservation-id</code> - The ID of the instance's reservation.
* A reservation ID is created any time you launch an instance. A
* reservation ID has a one-to-one relationship with an instance launch
* request, but can be associated with more than one instance if you
* launch multiple instances using the same launch request. For example,
* if you launch one instance, you'll get one reservation ID. If you
* launch ten instances using the same launch request, you'll also get
* one reservation ID. </li> <li> <p><code>root-device-name</code> - The
* name of the root device for the instance (for example,
* <code>/dev/sda1</code> or <code>/dev/xvda</code>). </li> <li>
* <p><code>root-device-type</code> - The type of root device that the
* instance uses (<code>ebs</code> | <code>instance-store</code>). </li>
* <li> <p><code>source-dest-check</code> - Indicates whether the
* instance performs source/destination checking. A value of
* <code>true</code> means that checking is enabled, and
* <code>false</code> means checking is disabled. The value must be
* <code>false</code> for the instance to perform network address
* translation (NAT) in your VPC. </li> <li>
* <p><code>spot-instance-request-id</code> - The ID of the Spot instance
* request. </li> <li> <p><code>state-reason-code</code> - The reason
* code for the state change. </li> <li>
* <p><code>state-reason-message</code> - A message that describes the
* state change. </li> <li> <p><code>subnet-id</code> - The ID of the
* subnet for the instance. </li> <li>
* <p><code>tag</code>:<i>key</i>=<i>value</i> - The key/value
* combination of a tag assigned to the resource, where
* <code>tag</code>:<i>key</i> is the tag's key. </li> <li>
* <p><code>tag-key</code> - The key of a tag assigned to the resource.
* This filter is independent of the <code>tag-value</code> filter. For
* example, if you use both the filter "tag-key=Purpose" and the filter
* "tag-value=X", you get any resources assigned both the tag key Purpose
* (regardless of what the tag's value is), and the tag value X
* (regardless of what the tag's key is). If you want to list only
* resources where Purpose is X, see the
* <code>tag</code>:<i>key</i>=<i>value</i> filter. </li> <li>
* <p><code>tag-value</code> - The value of a tag assigned to the
* resource. This filter is independent of the <code>tag-key</code>
* filter. </li> <li> <p><code>tenancy</code> - The tenancy of an
* instance (<code>dedicated</code> | <code>default</code> |
* <code>host</code>). </li> <li> <p><code>virtualization-type</code> -
* The virtualization type of the instance (<code>paravirtual</code> |
* <code>hvm</code>). </li> <li> <p><code>vpc-id</code> - The ID of the
* VPC that the instance is running in. </li> <li>
* <p><code>network-interface.description</code> - The description of the
* network interface. </li> <li>
* <p><code>network-interface.subnet-id</code> - The ID of the subnet for
* the network interface. </li> <li>
* <p><code>network-interface.vpc-id</code> - The ID of the VPC for the
* network interface. </li> <li>
* <p><code>network-interface.network-interface-id</code> - The ID of the
* network interface. </li> <li>
* <p><code>network-interface.owner-id</code> - The ID of the owner of
* the network interface. </li> <li>
* <p><code>network-interface.availability-zone</code> - The Availability
* Zone for the network interface. </li> <li>
* <p><code>network-interface.requester-id</code> - The requester ID for
* the network interface. </li> <li>
* <p><code>network-interface.requester-managed</code> - Indicates
* whether the network interface is being managed by AWS. </li> <li>
* <p><code>network-interface.status</code> - The status of the network
* interface (<code>available</code>) | <code>in-use</code>). </li> <li>
* <p><code>network-interface.mac-address</code> - The MAC address of the
* network interface. </li> <li>
* <p><code>network-interface.private-dns-name</code> - The private DNS
* name of the network interface. </li> <li>
* <p><code>network-interface.source-dest-check</code> - Whether the
* network interface performs source/destination checking. A value of
* <code>true</code> means checking is enabled, and <code>false</code>
* means checking is disabled. The value must be <code>false</code> for
* the network interface to perform network address translation (NAT) in
* your VPC. </li> <li> <p><code>network-interface.group-id</code> - The
* ID of a security group associated with the network interface. </li>
* <li> <p><code>network-interface.group-name</code> - The name of a
* security group associated with the network interface. </li> <li>
* <p><code>network-interface.attachment.attachment-id</code> - The ID of
* the interface attachment. </li> <li>
* <p><code>network-interface.attachment.instance-id</code> - The ID of
* the instance to which the network interface is attached. </li> <li>
* <p><code>network-interface.attachment.instance-owner-id</code> - The
* owner ID of the instance to which the network interface is attached.
* </li> <li>
* <p><code>network-interface.addresses.private-ip-address</code> - The
* private IP address associated with the network interface. </li> <li>
* <p><code>network-interface.attachment.device-index</code> - The device
* index to which the network interface is attached. </li> <li>
* <p><code>network-interface.attachment.status</code> - The status of
* the attachment (<code>attaching</code> | <code>attached</code> |
* <code>detaching</code> | <code>detached</code>). </li> <li>
* <p><code>network-interface.attachment.attach-time</code> - The time
* that the network interface was attached to an instance. </li> <li>
* <p><code>network-interface.attachment.delete-on-termination</code> -
* Specifies whether the attachment is deleted when an instance is
* terminated. </li> <li>
* <p><code>network-interface.addresses.primary</code> - Specifies
* whether the IP address of the network interface is the primary private
* IP address. </li> <li>
* <p><code>network-interface.addresses.association.public-ip</code> -
* The ID of the association of an Elastic IP address with a network
* interface. </li> <li>
* <p><code>network-interface.addresses.association.ip-owner-id</code> -
* The owner ID of the private IP address associated with the network
* interface. </li> <li> <p><code>association.public-ip</code> - The
* address of the Elastic IP address bound to the network interface.
* </li> <li> <p><code>association.ip-owner-id</code> - The owner of the
* Elastic IP address associated with the network interface. </li> <li>
* <p><code>association.allocation-id</code> - The allocation ID returned
* when you allocated the Elastic IP address for your network interface.
* </li> <li> <p><code>association.association-id</code> - The
* association ID returned when the network interface was associated with
* an IP address. </li> </ul>
*
* @return One or more filters. <ul> <li> <p><code>affinity</code> - The affinity
* setting for an instance running on a Dedicated host
* (<code>default</code> | <code>host</code>). </li> <li>
* <p><code>architecture</code> - The instance architecture
* (<code>i386</code> | <code>x86_64</code>). </li> <li>
* <p><code>availability-zone</code> - The Availability Zone of the
* instance. </li> <li> <p><code>block-device-mapping.attach-time</code>
* - The attach time for an EBS volume mapped to the instance, for
* example, <code>2010-09-15T17:15:20.000Z</code>. </li> <li>
* <p><code>block-device-mapping.delete-on-termination</code> - A Boolean
* that indicates whether the EBS volume is deleted on instance
* termination. </li> <li>
* <p><code>block-device-mapping.device-name</code> - The device name for
* the EBS volume (for example, <code>/dev/sdh</code> or
* <code>xvdh</code>). </li> <li>
* <p><code>block-device-mapping.status</code> - The status for the EBS
* volume (<code>attaching</code> | <code>attached</code> |
* <code>detaching</code> | <code>detached</code>). </li> <li>
* <p><code>block-device-mapping.volume-id</code> - The volume ID of the
* EBS volume. </li> <li> <p><code>client-token</code> - The idempotency
* token you provided when you launched the instance. </li> <li>
* <p><code>dns-name</code> - The public DNS name of the instance. </li>
* <li> <p><code>group-id</code> - The ID of the security group for the
* instance. EC2-Classic only. </li> <li> <p><code>group-name</code> -
* The name of the security group for the instance. EC2-Classic only.
* </li> <li> <p><code>host-Id</code> - The ID of the Dedicated host on
* which the instance is running, if applicable. </li> <li>
* <p><code>hypervisor</code> - The hypervisor type of the instance
* (<code>ovm</code> | <code>xen</code>). </li> <li>
* <p><code>iam-instance-profile.arn</code> - The instance profile
* associated with the instance. Specified as an ARN. </li> <li>
* <p><code>image-id</code> - The ID of the image used to launch the
* instance. </li> <li> <p><code>instance-id</code> - The ID of the
* instance. </li> <li> <p><code>instance-lifecycle</code> - Indicates
* whether this is a Spot Instance or a Scheduled Instance
* (<code>spot</code> | <code>scheduled</code>). </li> <li>
* <p><code>instance-state-code</code> - The state of the instance, as a
* 16-bit unsigned integer. The high byte is an opaque internal value and
* should be ignored. The low byte is set based on the state represented.
* The valid values are: 0 (pending), 16 (running), 32 (shutting-down),
* 48 (terminated), 64 (stopping), and 80 (stopped). </li> <li>
* <p><code>instance-state-name</code> - The state of the instance
* (<code>pending</code> | <code>running</code> |
* <code>shutting-down</code> | <code>terminated</code> |
* <code>stopping</code> | <code>stopped</code>). </li> <li>
* <p><code>instance-type</code> - The type of instance (for example,
* <code>t2.micro</code>). </li> <li> <p><code>instance.group-id</code> -
* The ID of the security group for the instance. </li> <li>
* <p><code>instance.group-name</code> - The name of the security group
* for the instance. </li> <li> <p><code>ip-address</code> - The public
* IP address of the instance. </li> <li> <p><code>kernel-id</code> - The
* kernel ID. </li> <li> <p><code>key-name</code> - The name of the key
* pair used when the instance was launched. </li> <li>
* <p><code>launch-index</code> - When launching multiple instances, this
* is the index for the instance in the launch group (for example, 0, 1,
* 2, and so on). </li> <li> <p><code>launch-time</code> - The time when
* the instance was launched. </li> <li> <p><code>monitoring-state</code>
* - Indicates whether monitoring is enabled for the instance
* (<code>disabled</code> | <code>enabled</code>). </li> <li>
* <p><code>owner-id</code> - The AWS account ID of the instance owner.
* </li> <li> <p><code>placement-group-name</code> - The name of the
* placement group for the instance. </li> <li> <p><code>platform</code>
* - The platform. Use <code>windows</code> if you have Windows
* instances; otherwise, leave blank. </li> <li>
* <p><code>private-dns-name</code> - The private DNS name of the
* instance. </li> <li> <p><code>private-ip-address</code> - The private
* IP address of the instance. </li> <li> <p><code>product-code</code> -
* The product code associated with the AMI used to launch the instance.
* </li> <li> <p><code>product-code.type</code> - The type of product
* code (<code>devpay</code> | <code>marketplace</code>). </li> <li>
* <p><code>ramdisk-id</code> - The RAM disk ID. </li> <li>
* <p><code>reason</code> - The reason for the current state of the
* instance (for example, shows "User Initiated [date]" when you stop or
* terminate the instance). Similar to the state-reason-code filter.
* </li> <li> <p><code>requester-id</code> - The ID of the entity that
* launched the instance on your behalf (for example, AWS Management
* Console, Auto Scaling, and so on). </li> <li>
* <p><code>reservation-id</code> - The ID of the instance's reservation.
* A reservation ID is created any time you launch an instance. A
* reservation ID has a one-to-one relationship with an instance launch
* request, but can be associated with more than one instance if you
* launch multiple instances using the same launch request. For example,
* if you launch one instance, you'll get one reservation ID. If you
* launch ten instances using the same launch request, you'll also get
* one reservation ID. </li> <li> <p><code>root-device-name</code> - The
* name of the root device for the instance (for example,
* <code>/dev/sda1</code> or <code>/dev/xvda</code>). </li> <li>
* <p><code>root-device-type</code> - The type of root device that the
* instance uses (<code>ebs</code> | <code>instance-store</code>). </li>
* <li> <p><code>source-dest-check</code> - Indicates whether the
* instance performs source/destination checking. A value of
* <code>true</code> means that checking is enabled, and
* <code>false</code> means checking is disabled. The value must be
* <code>false</code> for the instance to perform network address
* translation (NAT) in your VPC. </li> <li>
* <p><code>spot-instance-request-id</code> - The ID of the Spot instance
* request. </li> <li> <p><code>state-reason-code</code> - The reason
* code for the state change. </li> <li>
* <p><code>state-reason-message</code> - A message that describes the
* state change. </li> <li> <p><code>subnet-id</code> - The ID of the
* subnet for the instance. </li> <li>
* <p><code>tag</code>:<i>key</i>=<i>value</i> - The key/value
* combination of a tag assigned to the resource, where
* <code>tag</code>:<i>key</i> is the tag's key. </li> <li>
* <p><code>tag-key</code> - The key of a tag assigned to the resource.
* This filter is independent of the <code>tag-value</code> filter. For
* example, if you use both the filter "tag-key=Purpose" and the filter
* "tag-value=X", you get any resources assigned both the tag key Purpose
* (regardless of what the tag's value is), and the tag value X
* (regardless of what the tag's key is). If you want to list only
* resources where Purpose is X, see the
* <code>tag</code>:<i>key</i>=<i>value</i> filter. </li> <li>
* <p><code>tag-value</code> - The value of a tag assigned to the
* resource. This filter is independent of the <code>tag-key</code>
* filter. </li> <li> <p><code>tenancy</code> - The tenancy of an
* instance (<code>dedicated</code> | <code>default</code> |
* <code>host</code>). </li> <li> <p><code>virtualization-type</code> -
* The virtualization type of the instance (<code>paravirtual</code> |
* <code>hvm</code>). </li> <li> <p><code>vpc-id</code> - The ID of the
* VPC that the instance is running in. </li> <li>
* <p><code>network-interface.description</code> - The description of the
* network interface. </li> <li>
* <p><code>network-interface.subnet-id</code> - The ID of the subnet for
* the network interface. </li> <li>
* <p><code>network-interface.vpc-id</code> - The ID of the VPC for the
* network interface. </li> <li>
* <p><code>network-interface.network-interface-id</code> - The ID of the
* network interface. </li> <li>
* <p><code>network-interface.owner-id</code> - The ID of the owner of
* the network interface. </li> <li>
* <p><code>network-interface.availability-zone</code> - The Availability
* Zone for the network interface. </li> <li>
* <p><code>network-interface.requester-id</code> - The requester ID for
* the network interface. </li> <li>
* <p><code>network-interface.requester-managed</code> - Indicates
* whether the network interface is being managed by AWS. </li> <li>
* <p><code>network-interface.status</code> - The status of the network
* interface (<code>available</code>) | <code>in-use</code>). </li> <li>
* <p><code>network-interface.mac-address</code> - The MAC address of the
* network interface. </li> <li>
* <p><code>network-interface.private-dns-name</code> - The private DNS
* name of the network interface. </li> <li>
* <p><code>network-interface.source-dest-check</code> - Whether the
* network interface performs source/destination checking. A value of
* <code>true</code> means checking is enabled, and <code>false</code>
* means checking is disabled. The value must be <code>false</code> for
* the network interface to perform network address translation (NAT) in
* your VPC. </li> <li> <p><code>network-interface.group-id</code> - The
* ID of a security group associated with the network interface. </li>
* <li> <p><code>network-interface.group-name</code> - The name of a
* security group associated with the network interface. </li> <li>
* <p><code>network-interface.attachment.attachment-id</code> - The ID of
* the interface attachment. </li> <li>
* <p><code>network-interface.attachment.instance-id</code> - The ID of
* the instance to which the network interface is attached. </li> <li>
* <p><code>network-interface.attachment.instance-owner-id</code> - The
* owner ID of the instance to which the network interface is attached.
* </li> <li>
* <p><code>network-interface.addresses.private-ip-address</code> - The
* private IP address associated with the network interface. </li> <li>
* <p><code>network-interface.attachment.device-index</code> - The device
* index to which the network interface is attached. </li> <li>
* <p><code>network-interface.attachment.status</code> - The status of
* the attachment (<code>attaching</code> | <code>attached</code> |
* <code>detaching</code> | <code>detached</code>). </li> <li>
* <p><code>network-interface.attachment.attach-time</code> - The time
* that the network interface was attached to an instance. </li> <li>
* <p><code>network-interface.attachment.delete-on-termination</code> -
* Specifies whether the attachment is deleted when an instance is
* terminated. </li> <li>
* <p><code>network-interface.addresses.primary</code> - Specifies
* whether the IP address of the network interface is the primary private
* IP address. </li> <li>
* <p><code>network-interface.addresses.association.public-ip</code> -
* The ID of the association of an Elastic IP address with a network
* interface. </li> <li>
* <p><code>network-interface.addresses.association.ip-owner-id</code> -
* The owner ID of the private IP address associated with the network
* interface. </li> <li> <p><code>association.public-ip</code> - The
* address of the Elastic IP address bound to the network interface.
* </li> <li> <p><code>association.ip-owner-id</code> - The owner of the
* Elastic IP address associated with the network interface. </li> <li>
* <p><code>association.allocation-id</code> - The allocation ID returned
* when you allocated the Elastic IP address for your network interface.
* </li> <li> <p><code>association.association-id</code> - The
* association ID returned when the network interface was associated with
* an IP address. </li> </ul>
*/
public java.util.List<Filter> getFilters() {
if (filters == null) {
filters = new com.amazonaws.internal.ListWithAutoConstructFlag<Filter>();
filters.setAutoConstruct(true);
}
return filters;
}
/**
* One or more filters. <ul> <li> <p><code>affinity</code> - The affinity
* setting for an instance running on a Dedicated host
* (<code>default</code> | <code>host</code>). </li> <li>
* <p><code>architecture</code> - The instance architecture
* (<code>i386</code> | <code>x86_64</code>). </li> <li>
* <p><code>availability-zone</code> - The Availability Zone of the
* instance. </li> <li> <p><code>block-device-mapping.attach-time</code>
* - The attach time for an EBS volume mapped to the instance, for
* example, <code>2010-09-15T17:15:20.000Z</code>. </li> <li>
* <p><code>block-device-mapping.delete-on-termination</code> - A Boolean
* that indicates whether the EBS volume is deleted on instance
* termination. </li> <li>
* <p><code>block-device-mapping.device-name</code> - The device name for
* the EBS volume (for example, <code>/dev/sdh</code> or
* <code>xvdh</code>). </li> <li>
* <p><code>block-device-mapping.status</code> - The status for the EBS
* volume (<code>attaching</code> | <code>attached</code> |
* <code>detaching</code> | <code>detached</code>). </li> <li>
* <p><code>block-device-mapping.volume-id</code> - The volume ID of the
* EBS volume. </li> <li> <p><code>client-token</code> - The idempotency
* token you provided when you launched the instance. </li> <li>
* <p><code>dns-name</code> - The public DNS name of the instance. </li>
* <li> <p><code>group-id</code> - The ID of the security group for the
* instance. EC2-Classic only. </li> <li> <p><code>group-name</code> -
* The name of the security group for the instance. EC2-Classic only.
* </li> <li> <p><code>host-Id</code> - The ID of the Dedicated host on
* which the instance is running, if applicable. </li> <li>
* <p><code>hypervisor</code> - The hypervisor type of the instance
* (<code>ovm</code> | <code>xen</code>). </li> <li>
* <p><code>iam-instance-profile.arn</code> - The instance profile
* associated with the instance. Specified as an ARN. </li> <li>
* <p><code>image-id</code> - The ID of the image used to launch the
* instance. </li> <li> <p><code>instance-id</code> - The ID of the
* instance. </li> <li> <p><code>instance-lifecycle</code> - Indicates
* whether this is a Spot Instance or a Scheduled Instance
* (<code>spot</code> | <code>scheduled</code>). </li> <li>
* <p><code>instance-state-code</code> - The state of the instance, as a
* 16-bit unsigned integer. The high byte is an opaque internal value and
* should be ignored. The low byte is set based on the state represented.
* The valid values are: 0 (pending), 16 (running), 32 (shutting-down),
* 48 (terminated), 64 (stopping), and 80 (stopped). </li> <li>
* <p><code>instance-state-name</code> - The state of the instance
* (<code>pending</code> | <code>running</code> |
* <code>shutting-down</code> | <code>terminated</code> |
* <code>stopping</code> | <code>stopped</code>). </li> <li>
* <p><code>instance-type</code> - The type of instance (for example,
* <code>t2.micro</code>). </li> <li> <p><code>instance.group-id</code> -
* The ID of the security group for the instance. </li> <li>
* <p><code>instance.group-name</code> - The name of the security group
* for the instance. </li> <li> <p><code>ip-address</code> - The public
* IP address of the instance. </li> <li> <p><code>kernel-id</code> - The
* kernel ID. </li> <li> <p><code>key-name</code> - The name of the key
* pair used when the instance was launched. </li> <li>
* <p><code>launch-index</code> - When launching multiple instances, this
* is the index for the instance in the launch group (for example, 0, 1,
* 2, and so on). </li> <li> <p><code>launch-time</code> - The time when
* the instance was launched. </li> <li> <p><code>monitoring-state</code>
* - Indicates whether monitoring is enabled for the instance
* (<code>disabled</code> | <code>enabled</code>). </li> <li>
* <p><code>owner-id</code> - The AWS account ID of the instance owner.
* </li> <li> <p><code>placement-group-name</code> - The name of the
* placement group for the instance. </li> <li> <p><code>platform</code>
* - The platform. Use <code>windows</code> if you have Windows
* instances; otherwise, leave blank. </li> <li>
* <p><code>private-dns-name</code> - The private DNS name of the
* instance. </li> <li> <p><code>private-ip-address</code> - The private
* IP address of the instance. </li> <li> <p><code>product-code</code> -
* The product code associated with the AMI used to launch the instance.
* </li> <li> <p><code>product-code.type</code> - The type of product
* code (<code>devpay</code> | <code>marketplace</code>). </li> <li>
* <p><code>ramdisk-id</code> - The RAM disk ID. </li> <li>
* <p><code>reason</code> - The reason for the current state of the
* instance (for example, shows "User Initiated [date]" when you stop or
* terminate the instance). Similar to the state-reason-code filter.
* </li> <li> <p><code>requester-id</code> - The ID of the entity that
* launched the instance on your behalf (for example, AWS Management
* Console, Auto Scaling, and so on). </li> <li>
* <p><code>reservation-id</code> - The ID of the instance's reservation.
* A reservation ID is created any time you launch an instance. A
* reservation ID has a one-to-one relationship with an instance launch
* request, but can be associated with more than one instance if you
* launch multiple instances using the same launch request. For example,
* if you launch one instance, you'll get one reservation ID. If you
* launch ten instances using the same launch request, you'll also get
* one reservation ID. </li> <li> <p><code>root-device-name</code> - The
* name of the root device for the instance (for example,
* <code>/dev/sda1</code> or <code>/dev/xvda</code>). </li> <li>
* <p><code>root-device-type</code> - The type of root device that the
* instance uses (<code>ebs</code> | <code>instance-store</code>). </li>
* <li> <p><code>source-dest-check</code> - Indicates whether the
* instance performs source/destination checking. A value of
* <code>true</code> means that checking is enabled, and
* <code>false</code> means checking is disabled. The value must be
* <code>false</code> for the instance to perform network address
* translation (NAT) in your VPC. </li> <li>
* <p><code>spot-instance-request-id</code> - The ID of the Spot instance
* request. </li> <li> <p><code>state-reason-code</code> - The reason
* code for the state change. </li> <li>
* <p><code>state-reason-message</code> - A message that describes the
* state change. </li> <li> <p><code>subnet-id</code> - The ID of the
* subnet for the instance. </li> <li>
* <p><code>tag</code>:<i>key</i>=<i>value</i> - The key/value
* combination of a tag assigned to the resource, where
* <code>tag</code>:<i>key</i> is the tag's key. </li> <li>
* <p><code>tag-key</code> - The key of a tag assigned to the resource.
* This filter is independent of the <code>tag-value</code> filter. For
* example, if you use both the filter "tag-key=Purpose" and the filter
* "tag-value=X", you get any resources assigned both the tag key Purpose
* (regardless of what the tag's value is), and the tag value X
* (regardless of what the tag's key is). If you want to list only
* resources where Purpose is X, see the
* <code>tag</code>:<i>key</i>=<i>value</i> filter. </li> <li>
* <p><code>tag-value</code> - The value of a tag assigned to the
* resource. This filter is independent of the <code>tag-key</code>
* filter. </li> <li> <p><code>tenancy</code> - The tenancy of an
* instance (<code>dedicated</code> | <code>default</code> |
* <code>host</code>). </li> <li> <p><code>virtualization-type</code> -
* The virtualization type of the instance (<code>paravirtual</code> |
* <code>hvm</code>). </li> <li> <p><code>vpc-id</code> - The ID of the
* VPC that the instance is running in. </li> <li>
* <p><code>network-interface.description</code> - The description of the
* network interface. </li> <li>
* <p><code>network-interface.subnet-id</code> - The ID of the subnet for
* the network interface. </li> <li>
* <p><code>network-interface.vpc-id</code> - The ID of the VPC for the
* network interface. </li> <li>
* <p><code>network-interface.network-interface-id</code> - The ID of the
* network interface. </li> <li>
* <p><code>network-interface.owner-id</code> - The ID of the owner of
* the network interface. </li> <li>
* <p><code>network-interface.availability-zone</code> - The Availability
* Zone for the network interface. </li> <li>
* <p><code>network-interface.requester-id</code> - The requester ID for
* the network interface. </li> <li>
* <p><code>network-interface.requester-managed</code> - Indicates
* whether the network interface is being managed by AWS. </li> <li>
* <p><code>network-interface.status</code> - The status of the network
* interface (<code>available</code>) | <code>in-use</code>). </li> <li>
* <p><code>network-interface.mac-address</code> - The MAC address of the
* network interface. </li> <li>
* <p><code>network-interface.private-dns-name</code> - The private DNS
* name of the network interface. </li> <li>
* <p><code>network-interface.source-dest-check</code> - Whether the
* network interface performs source/destination checking. A value of
* <code>true</code> means checking is enabled, and <code>false</code>
* means checking is disabled. The value must be <code>false</code> for
* the network interface to perform network address translation (NAT) in
* your VPC. </li> <li> <p><code>network-interface.group-id</code> - The
* ID of a security group associated with the network interface. </li>
* <li> <p><code>network-interface.group-name</code> - The name of a
* security group associated with the network interface. </li> <li>
* <p><code>network-interface.attachment.attachment-id</code> - The ID of
* the interface attachment. </li> <li>
* <p><code>network-interface.attachment.instance-id</code> - The ID of
* the instance to which the network interface is attached. </li> <li>
* <p><code>network-interface.attachment.instance-owner-id</code> - The
* owner ID of the instance to which the network interface is attached.
* </li> <li>
* <p><code>network-interface.addresses.private-ip-address</code> - The
* private IP address associated with the network interface. </li> <li>
* <p><code>network-interface.attachment.device-index</code> - The device
* index to which the network interface is attached. </li> <li>
* <p><code>network-interface.attachment.status</code> - The status of
* the attachment (<code>attaching</code> | <code>attached</code> |
* <code>detaching</code> | <code>detached</code>). </li> <li>
* <p><code>network-interface.attachment.attach-time</code> - The time
* that the network interface was attached to an instance. </li> <li>
* <p><code>network-interface.attachment.delete-on-termination</code> -
* Specifies whether the attachment is deleted when an instance is
* terminated. </li> <li>
* <p><code>network-interface.addresses.primary</code> - Specifies
* whether the IP address of the network interface is the primary private
* IP address. </li> <li>
* <p><code>network-interface.addresses.association.public-ip</code> -
* The ID of the association of an Elastic IP address with a network
* interface. </li> <li>
* <p><code>network-interface.addresses.association.ip-owner-id</code> -
* The owner ID of the private IP address associated with the network
* interface. </li> <li> <p><code>association.public-ip</code> - The
* address of the Elastic IP address bound to the network interface.
* </li> <li> <p><code>association.ip-owner-id</code> - The owner of the
* Elastic IP address associated with the network interface. </li> <li>
* <p><code>association.allocation-id</code> - The allocation ID returned
* when you allocated the Elastic IP address for your network interface.
* </li> <li> <p><code>association.association-id</code> - The
* association ID returned when the network interface was associated with
* an IP address. </li> </ul>
*
* @param filters One or more filters. <ul> <li> <p><code>affinity</code> - The affinity
* setting for an instance running on a Dedicated host
* (<code>default</code> | <code>host</code>). </li> <li>
* <p><code>architecture</code> - The instance architecture
* (<code>i386</code> | <code>x86_64</code>). </li> <li>
* <p><code>availability-zone</code> - The Availability Zone of the
* instance. </li> <li> <p><code>block-device-mapping.attach-time</code>
* - The attach time for an EBS volume mapped to the instance, for
* example, <code>2010-09-15T17:15:20.000Z</code>. </li> <li>
* <p><code>block-device-mapping.delete-on-termination</code> - A Boolean
* that indicates whether the EBS volume is deleted on instance
* termination. </li> <li>
* <p><code>block-device-mapping.device-name</code> - The device name for
* the EBS volume (for example, <code>/dev/sdh</code> or
* <code>xvdh</code>). </li> <li>
* <p><code>block-device-mapping.status</code> - The status for the EBS
* volume (<code>attaching</code> | <code>attached</code> |
* <code>detaching</code> | <code>detached</code>). </li> <li>
* <p><code>block-device-mapping.volume-id</code> - The volume ID of the
* EBS volume. </li> <li> <p><code>client-token</code> - The idempotency
* token you provided when you launched the instance. </li> <li>
* <p><code>dns-name</code> - The public DNS name of the instance. </li>
* <li> <p><code>group-id</code> - The ID of the security group for the
* instance. EC2-Classic only. </li> <li> <p><code>group-name</code> -
* The name of the security group for the instance. EC2-Classic only.
* </li> <li> <p><code>host-Id</code> - The ID of the Dedicated host on
* which the instance is running, if applicable. </li> <li>
* <p><code>hypervisor</code> - The hypervisor type of the instance
* (<code>ovm</code> | <code>xen</code>). </li> <li>
* <p><code>iam-instance-profile.arn</code> - The instance profile
* associated with the instance. Specified as an ARN. </li> <li>
* <p><code>image-id</code> - The ID of the image used to launch the
* instance. </li> <li> <p><code>instance-id</code> - The ID of the
* instance. </li> <li> <p><code>instance-lifecycle</code> - Indicates
* whether this is a Spot Instance or a Scheduled Instance
* (<code>spot</code> | <code>scheduled</code>). </li> <li>
* <p><code>instance-state-code</code> - The state of the instance, as a
* 16-bit unsigned integer. The high byte is an opaque internal value and
* should be ignored. The low byte is set based on the state represented.
* The valid values are: 0 (pending), 16 (running), 32 (shutting-down),
* 48 (terminated), 64 (stopping), and 80 (stopped). </li> <li>
* <p><code>instance-state-name</code> - The state of the instance
* (<code>pending</code> | <code>running</code> |
* <code>shutting-down</code> | <code>terminated</code> |
* <code>stopping</code> | <code>stopped</code>). </li> <li>
* <p><code>instance-type</code> - The type of instance (for example,
* <code>t2.micro</code>). </li> <li> <p><code>instance.group-id</code> -
* The ID of the security group for the instance. </li> <li>
* <p><code>instance.group-name</code> - The name of the security group
* for the instance. </li> <li> <p><code>ip-address</code> - The public
* IP address of the instance. </li> <li> <p><code>kernel-id</code> - The
* kernel ID. </li> <li> <p><code>key-name</code> - The name of the key
* pair used when the instance was launched. </li> <li>
* <p><code>launch-index</code> - When launching multiple instances, this
* is the index for the instance in the launch group (for example, 0, 1,
* 2, and so on). </li> <li> <p><code>launch-time</code> - The time when
* the instance was launched. </li> <li> <p><code>monitoring-state</code>
* - Indicates whether monitoring is enabled for the instance
* (<code>disabled</code> | <code>enabled</code>). </li> <li>
* <p><code>owner-id</code> - The AWS account ID of the instance owner.
* </li> <li> <p><code>placement-group-name</code> - The name of the
* placement group for the instance. </li> <li> <p><code>platform</code>
* - The platform. Use <code>windows</code> if you have Windows
* instances; otherwise, leave blank. </li> <li>
* <p><code>private-dns-name</code> - The private DNS name of the
* instance. </li> <li> <p><code>private-ip-address</code> - The private
* IP address of the instance. </li> <li> <p><code>product-code</code> -
* The product code associated with the AMI used to launch the instance.
* </li> <li> <p><code>product-code.type</code> - The type of product
* code (<code>devpay</code> | <code>marketplace</code>). </li> <li>
* <p><code>ramdisk-id</code> - The RAM disk ID. </li> <li>
* <p><code>reason</code> - The reason for the current state of the
* instance (for example, shows "User Initiated [date]" when you stop or
* terminate the instance). Similar to the state-reason-code filter.
* </li> <li> <p><code>requester-id</code> - The ID of the entity that
* launched the instance on your behalf (for example, AWS Management
* Console, Auto Scaling, and so on). </li> <li>
* <p><code>reservation-id</code> - The ID of the instance's reservation.
* A reservation ID is created any time you launch an instance. A
* reservation ID has a one-to-one relationship with an instance launch
* request, but can be associated with more than one instance if you
* launch multiple instances using the same launch request. For example,
* if you launch one instance, you'll get one reservation ID. If you
* launch ten instances using the same launch request, you'll also get
* one reservation ID. </li> <li> <p><code>root-device-name</code> - The
* name of the root device for the instance (for example,
* <code>/dev/sda1</code> or <code>/dev/xvda</code>). </li> <li>
* <p><code>root-device-type</code> - The type of root device that the
* instance uses (<code>ebs</code> | <code>instance-store</code>). </li>
* <li> <p><code>source-dest-check</code> - Indicates whether the
* instance performs source/destination checking. A value of
* <code>true</code> means that checking is enabled, and
* <code>false</code> means checking is disabled. The value must be
* <code>false</code> for the instance to perform network address
* translation (NAT) in your VPC. </li> <li>
* <p><code>spot-instance-request-id</code> - The ID of the Spot instance
* request. </li> <li> <p><code>state-reason-code</code> - The reason
* code for the state change. </li> <li>
* <p><code>state-reason-message</code> - A message that describes the
* state change. </li> <li> <p><code>subnet-id</code> - The ID of the
* subnet for the instance. </li> <li>
* <p><code>tag</code>:<i>key</i>=<i>value</i> - The key/value
* combination of a tag assigned to the resource, where
* <code>tag</code>:<i>key</i> is the tag's key. </li> <li>
* <p><code>tag-key</code> - The key of a tag assigned to the resource.
* This filter is independent of the <code>tag-value</code> filter. For
* example, if you use both the filter "tag-key=Purpose" and the filter
* "tag-value=X", you get any resources assigned both the tag key Purpose
* (regardless of what the tag's value is), and the tag value X
* (regardless of what the tag's key is). If you want to list only
* resources where Purpose is X, see the
* <code>tag</code>:<i>key</i>=<i>value</i> filter. </li> <li>
* <p><code>tag-value</code> - The value of a tag assigned to the
* resource. This filter is independent of the <code>tag-key</code>
* filter. </li> <li> <p><code>tenancy</code> - The tenancy of an
* instance (<code>dedicated</code> | <code>default</code> |
* <code>host</code>). </li> <li> <p><code>virtualization-type</code> -
* The virtualization type of the instance (<code>paravirtual</code> |
* <code>hvm</code>). </li> <li> <p><code>vpc-id</code> - The ID of the
* VPC that the instance is running in. </li> <li>
* <p><code>network-interface.description</code> - The description of the
* network interface. </li> <li>
* <p><code>network-interface.subnet-id</code> - The ID of the subnet for
* the network interface. </li> <li>
* <p><code>network-interface.vpc-id</code> - The ID of the VPC for the
* network interface. </li> <li>
* <p><code>network-interface.network-interface-id</code> - The ID of the
* network interface. </li> <li>
* <p><code>network-interface.owner-id</code> - The ID of the owner of
* the network interface. </li> <li>
* <p><code>network-interface.availability-zone</code> - The Availability
* Zone for the network interface. </li> <li>
* <p><code>network-interface.requester-id</code> - The requester ID for
* the network interface. </li> <li>
* <p><code>network-interface.requester-managed</code> - Indicates
* whether the network interface is being managed by AWS. </li> <li>
* <p><code>network-interface.status</code> - The status of the network
* interface (<code>available</code>) | <code>in-use</code>). </li> <li>
* <p><code>network-interface.mac-address</code> - The MAC address of the
* network interface. </li> <li>
* <p><code>network-interface.private-dns-name</code> - The private DNS
* name of the network interface. </li> <li>
* <p><code>network-interface.source-dest-check</code> - Whether the
* network interface performs source/destination checking. A value of
* <code>true</code> means checking is enabled, and <code>false</code>
* means checking is disabled. The value must be <code>false</code> for
* the network interface to perform network address translation (NAT) in
* your VPC. </li> <li> <p><code>network-interface.group-id</code> - The
* ID of a security group associated with the network interface. </li>
* <li> <p><code>network-interface.group-name</code> - The name of a
* security group associated with the network interface. </li> <li>
* <p><code>network-interface.attachment.attachment-id</code> - The ID of
* the interface attachment. </li> <li>
* <p><code>network-interface.attachment.instance-id</code> - The ID of
* the instance to which the network interface is attached. </li> <li>
* <p><code>network-interface.attachment.instance-owner-id</code> - The
* owner ID of the instance to which the network interface is attached.
* </li> <li>
* <p><code>network-interface.addresses.private-ip-address</code> - The
* private IP address associated with the network interface. </li> <li>
* <p><code>network-interface.attachment.device-index</code> - The device
* index to which the network interface is attached. </li> <li>
* <p><code>network-interface.attachment.status</code> - The status of
* the attachment (<code>attaching</code> | <code>attached</code> |
* <code>detaching</code> | <code>detached</code>). </li> <li>
* <p><code>network-interface.attachment.attach-time</code> - The time
* that the network interface was attached to an instance. </li> <li>
* <p><code>network-interface.attachment.delete-on-termination</code> -
* Specifies whether the attachment is deleted when an instance is
* terminated. </li> <li>
* <p><code>network-interface.addresses.primary</code> - Specifies
* whether the IP address of the network interface is the primary private
* IP address. </li> <li>
* <p><code>network-interface.addresses.association.public-ip</code> -
* The ID of the association of an Elastic IP address with a network
* interface. </li> <li>
* <p><code>network-interface.addresses.association.ip-owner-id</code> -
* The owner ID of the private IP address associated with the network
* interface. </li> <li> <p><code>association.public-ip</code> - The
* address of the Elastic IP address bound to the network interface.
* </li> <li> <p><code>association.ip-owner-id</code> - The owner of the
* Elastic IP address associated with the network interface. </li> <li>
* <p><code>association.allocation-id</code> - The allocation ID returned
* when you allocated the Elastic IP address for your network interface.
* </li> <li> <p><code>association.association-id</code> - The
* association ID returned when the network interface was associated with
* an IP address. </li> </ul>
*/
public void setFilters(java.util.Collection<Filter> filters) {
if (filters == null) {
this.filters = null;
return;
}
com.amazonaws.internal.ListWithAutoConstructFlag<Filter> filtersCopy = new com.amazonaws.internal.ListWithAutoConstructFlag<Filter>(filters.size());
filtersCopy.addAll(filters);
this.filters = filtersCopy;
}
/**
* One or more filters. <ul> <li> <p><code>affinity</code> - The affinity
* setting for an instance running on a Dedicated host
* (<code>default</code> | <code>host</code>). </li> <li>
* <p><code>architecture</code> - The instance architecture
* (<code>i386</code> | <code>x86_64</code>). </li> <li>
* <p><code>availability-zone</code> - The Availability Zone of the
* instance. </li> <li> <p><code>block-device-mapping.attach-time</code>
* - The attach time for an EBS volume mapped to the instance, for
* example, <code>2010-09-15T17:15:20.000Z</code>. </li> <li>
* <p><code>block-device-mapping.delete-on-termination</code> - A Boolean
* that indicates whether the EBS volume is deleted on instance
* termination. </li> <li>
* <p><code>block-device-mapping.device-name</code> - The device name for
* the EBS volume (for example, <code>/dev/sdh</code> or
* <code>xvdh</code>). </li> <li>
* <p><code>block-device-mapping.status</code> - The status for the EBS
* volume (<code>attaching</code> | <code>attached</code> |
* <code>detaching</code> | <code>detached</code>). </li> <li>
* <p><code>block-device-mapping.volume-id</code> - The volume ID of the
* EBS volume. </li> <li> <p><code>client-token</code> - The idempotency
* token you provided when you launched the instance. </li> <li>
* <p><code>dns-name</code> - The public DNS name of the instance. </li>
* <li> <p><code>group-id</code> - The ID of the security group for the
* instance. EC2-Classic only. </li> <li> <p><code>group-name</code> -
* The name of the security group for the instance. EC2-Classic only.
* </li> <li> <p><code>host-Id</code> - The ID of the Dedicated host on
* which the instance is running, if applicable. </li> <li>
* <p><code>hypervisor</code> - The hypervisor type of the instance
* (<code>ovm</code> | <code>xen</code>). </li> <li>
* <p><code>iam-instance-profile.arn</code> - The instance profile
* associated with the instance. Specified as an ARN. </li> <li>
* <p><code>image-id</code> - The ID of the image used to launch the
* instance. </li> <li> <p><code>instance-id</code> - The ID of the
* instance. </li> <li> <p><code>instance-lifecycle</code> - Indicates
* whether this is a Spot Instance or a Scheduled Instance
* (<code>spot</code> | <code>scheduled</code>). </li> <li>
* <p><code>instance-state-code</code> - The state of the instance, as a
* 16-bit unsigned integer. The high byte is an opaque internal value and
* should be ignored. The low byte is set based on the state represented.
* The valid values are: 0 (pending), 16 (running), 32 (shutting-down),
* 48 (terminated), 64 (stopping), and 80 (stopped). </li> <li>
* <p><code>instance-state-name</code> - The state of the instance
* (<code>pending</code> | <code>running</code> |
* <code>shutting-down</code> | <code>terminated</code> |
* <code>stopping</code> | <code>stopped</code>). </li> <li>
* <p><code>instance-type</code> - The type of instance (for example,
* <code>t2.micro</code>). </li> <li> <p><code>instance.group-id</code> -
* The ID of the security group for the instance. </li> <li>
* <p><code>instance.group-name</code> - The name of the security group
* for the instance. </li> <li> <p><code>ip-address</code> - The public
* IP address of the instance. </li> <li> <p><code>kernel-id</code> - The
* kernel ID. </li> <li> <p><code>key-name</code> - The name of the key
* pair used when the instance was launched. </li> <li>
* <p><code>launch-index</code> - When launching multiple instances, this
* is the index for the instance in the launch group (for example, 0, 1,
* 2, and so on). </li> <li> <p><code>launch-time</code> - The time when
* the instance was launched. </li> <li> <p><code>monitoring-state</code>
* - Indicates whether monitoring is enabled for the instance
* (<code>disabled</code> | <code>enabled</code>). </li> <li>
* <p><code>owner-id</code> - The AWS account ID of the instance owner.
* </li> <li> <p><code>placement-group-name</code> - The name of the
* placement group for the instance. </li> <li> <p><code>platform</code>
* - The platform. Use <code>windows</code> if you have Windows
* instances; otherwise, leave blank. </li> <li>
* <p><code>private-dns-name</code> - The private DNS name of the
* instance. </li> <li> <p><code>private-ip-address</code> - The private
* IP address of the instance. </li> <li> <p><code>product-code</code> -
* The product code associated with the AMI used to launch the instance.
* </li> <li> <p><code>product-code.type</code> - The type of product
* code (<code>devpay</code> | <code>marketplace</code>). </li> <li>
* <p><code>ramdisk-id</code> - The RAM disk ID. </li> <li>
* <p><code>reason</code> - The reason for the current state of the
* instance (for example, shows "User Initiated [date]" when you stop or
* terminate the instance). Similar to the state-reason-code filter.
* </li> <li> <p><code>requester-id</code> - The ID of the entity that
* launched the instance on your behalf (for example, AWS Management
* Console, Auto Scaling, and so on). </li> <li>
* <p><code>reservation-id</code> - The ID of the instance's reservation.
* A reservation ID is created any time you launch an instance. A
* reservation ID has a one-to-one relationship with an instance launch
* request, but can be associated with more than one instance if you
* launch multiple instances using the same launch request. For example,
* if you launch one instance, you'll get one reservation ID. If you
* launch ten instances using the same launch request, you'll also get
* one reservation ID. </li> <li> <p><code>root-device-name</code> - The
* name of the root device for the instance (for example,
* <code>/dev/sda1</code> or <code>/dev/xvda</code>). </li> <li>
* <p><code>root-device-type</code> - The type of root device that the
* instance uses (<code>ebs</code> | <code>instance-store</code>). </li>
* <li> <p><code>source-dest-check</code> - Indicates whether the
* instance performs source/destination checking. A value of
* <code>true</code> means that checking is enabled, and
* <code>false</code> means checking is disabled. The value must be
* <code>false</code> for the instance to perform network address
* translation (NAT) in your VPC. </li> <li>
* <p><code>spot-instance-request-id</code> - The ID of the Spot instance
* request. </li> <li> <p><code>state-reason-code</code> - The reason
* code for the state change. </li> <li>
* <p><code>state-reason-message</code> - A message that describes the
* state change. </li> <li> <p><code>subnet-id</code> - The ID of the
* subnet for the instance. </li> <li>
* <p><code>tag</code>:<i>key</i>=<i>value</i> - The key/value
* combination of a tag assigned to the resource, where
* <code>tag</code>:<i>key</i> is the tag's key. </li> <li>
* <p><code>tag-key</code> - The key of a tag assigned to the resource.
* This filter is independent of the <code>tag-value</code> filter. For
* example, if you use both the filter "tag-key=Purpose" and the filter
* "tag-value=X", you get any resources assigned both the tag key Purpose
* (regardless of what the tag's value is), and the tag value X
* (regardless of what the tag's key is). If you want to list only
* resources where Purpose is X, see the
* <code>tag</code>:<i>key</i>=<i>value</i> filter. </li> <li>
* <p><code>tag-value</code> - The value of a tag assigned to the
* resource. This filter is independent of the <code>tag-key</code>
* filter. </li> <li> <p><code>tenancy</code> - The tenancy of an
* instance (<code>dedicated</code> | <code>default</code> |
* <code>host</code>). </li> <li> <p><code>virtualization-type</code> -
* The virtualization type of the instance (<code>paravirtual</code> |
* <code>hvm</code>). </li> <li> <p><code>vpc-id</code> - The ID of the
* VPC that the instance is running in. </li> <li>
* <p><code>network-interface.description</code> - The description of the
* network interface. </li> <li>
* <p><code>network-interface.subnet-id</code> - The ID of the subnet for
* the network interface. </li> <li>
* <p><code>network-interface.vpc-id</code> - The ID of the VPC for the
* network interface. </li> <li>
* <p><code>network-interface.network-interface-id</code> - The ID of the
* network interface. </li> <li>
* <p><code>network-interface.owner-id</code> - The ID of the owner of
* the network interface. </li> <li>
* <p><code>network-interface.availability-zone</code> - The Availability
* Zone for the network interface. </li> <li>
* <p><code>network-interface.requester-id</code> - The requester ID for
* the network interface. </li> <li>
* <p><code>network-interface.requester-managed</code> - Indicates
* whether the network interface is being managed by AWS. </li> <li>
* <p><code>network-interface.status</code> - The status of the network
* interface (<code>available</code>) | <code>in-use</code>). </li> <li>
* <p><code>network-interface.mac-address</code> - The MAC address of the
* network interface. </li> <li>
* <p><code>network-interface.private-dns-name</code> - The private DNS
* name of the network interface. </li> <li>
* <p><code>network-interface.source-dest-check</code> - Whether the
* network interface performs source/destination checking. A value of
* <code>true</code> means checking is enabled, and <code>false</code>
* means checking is disabled. The value must be <code>false</code> for
* the network interface to perform network address translation (NAT) in
* your VPC. </li> <li> <p><code>network-interface.group-id</code> - The
* ID of a security group associated with the network interface. </li>
* <li> <p><code>network-interface.group-name</code> - The name of a
* security group associated with the network interface. </li> <li>
* <p><code>network-interface.attachment.attachment-id</code> - The ID of
* the interface attachment. </li> <li>
* <p><code>network-interface.attachment.instance-id</code> - The ID of
* the instance to which the network interface is attached. </li> <li>
* <p><code>network-interface.attachment.instance-owner-id</code> - The
* owner ID of the instance to which the network interface is attached.
* </li> <li>
* <p><code>network-interface.addresses.private-ip-address</code> - The
* private IP address associated with the network interface. </li> <li>
* <p><code>network-interface.attachment.device-index</code> - The device
* index to which the network interface is attached. </li> <li>
* <p><code>network-interface.attachment.status</code> - The status of
* the attachment (<code>attaching</code> | <code>attached</code> |
* <code>detaching</code> | <code>detached</code>). </li> <li>
* <p><code>network-interface.attachment.attach-time</code> - The time
* that the network interface was attached to an instance. </li> <li>
* <p><code>network-interface.attachment.delete-on-termination</code> -
* Specifies whether the attachment is deleted when an instance is
* terminated. </li> <li>
* <p><code>network-interface.addresses.primary</code> - Specifies
* whether the IP address of the network interface is the primary private
* IP address. </li> <li>
* <p><code>network-interface.addresses.association.public-ip</code> -
* The ID of the association of an Elastic IP address with a network
* interface. </li> <li>
* <p><code>network-interface.addresses.association.ip-owner-id</code> -
* The owner ID of the private IP address associated with the network
* interface. </li> <li> <p><code>association.public-ip</code> - The
* address of the Elastic IP address bound to the network interface.
* </li> <li> <p><code>association.ip-owner-id</code> - The owner of the
* Elastic IP address associated with the network interface. </li> <li>
* <p><code>association.allocation-id</code> - The allocation ID returned
* when you allocated the Elastic IP address for your network interface.
* </li> <li> <p><code>association.association-id</code> - The
* association ID returned when the network interface was associated with
* an IP address. </li> </ul>
* <p>
* Returns a reference to this object so that method calls can be chained together.
*
* @param filters One or more filters. <ul> <li> <p><code>affinity</code> - The affinity
* setting for an instance running on a Dedicated host
* (<code>default</code> | <code>host</code>). </li> <li>
* <p><code>architecture</code> - The instance architecture
* (<code>i386</code> | <code>x86_64</code>). </li> <li>
* <p><code>availability-zone</code> - The Availability Zone of the
* instance. </li> <li> <p><code>block-device-mapping.attach-time</code>
* - The attach time for an EBS volume mapped to the instance, for
* example, <code>2010-09-15T17:15:20.000Z</code>. </li> <li>
* <p><code>block-device-mapping.delete-on-termination</code> - A Boolean
* that indicates whether the EBS volume is deleted on instance
* termination. </li> <li>
* <p><code>block-device-mapping.device-name</code> - The device name for
* the EBS volume (for example, <code>/dev/sdh</code> or
* <code>xvdh</code>). </li> <li>
* <p><code>block-device-mapping.status</code> - The status for the EBS
* volume (<code>attaching</code> | <code>attached</code> |
* <code>detaching</code> | <code>detached</code>). </li> <li>
* <p><code>block-device-mapping.volume-id</code> - The volume ID of the
* EBS volume. </li> <li> <p><code>client-token</code> - The idempotency
* token you provided when you launched the instance. </li> <li>
* <p><code>dns-name</code> - The public DNS name of the instance. </li>
* <li> <p><code>group-id</code> - The ID of the security group for the
* instance. EC2-Classic only. </li> <li> <p><code>group-name</code> -
* The name of the security group for the instance. EC2-Classic only.
* </li> <li> <p><code>host-Id</code> - The ID of the Dedicated host on
* which the instance is running, if applicable. </li> <li>
* <p><code>hypervisor</code> - The hypervisor type of the instance
* (<code>ovm</code> | <code>xen</code>). </li> <li>
* <p><code>iam-instance-profile.arn</code> - The instance profile
* associated with the instance. Specified as an ARN. </li> <li>
* <p><code>image-id</code> - The ID of the image used to launch the
* instance. </li> <li> <p><code>instance-id</code> - The ID of the
* instance. </li> <li> <p><code>instance-lifecycle</code> - Indicates
* whether this is a Spot Instance or a Scheduled Instance
* (<code>spot</code> | <code>scheduled</code>). </li> <li>
* <p><code>instance-state-code</code> - The state of the instance, as a
* 16-bit unsigned integer. The high byte is an opaque internal value and
* should be ignored. The low byte is set based on the state represented.
* The valid values are: 0 (pending), 16 (running), 32 (shutting-down),
* 48 (terminated), 64 (stopping), and 80 (stopped). </li> <li>
* <p><code>instance-state-name</code> - The state of the instance
* (<code>pending</code> | <code>running</code> |
* <code>shutting-down</code> | <code>terminated</code> |
* <code>stopping</code> | <code>stopped</code>). </li> <li>
* <p><code>instance-type</code> - The type of instance (for example,
* <code>t2.micro</code>). </li> <li> <p><code>instance.group-id</code> -
* The ID of the security group for the instance. </li> <li>
* <p><code>instance.group-name</code> - The name of the security group
* for the instance. </li> <li> <p><code>ip-address</code> - The public
* IP address of the instance. </li> <li> <p><code>kernel-id</code> - The
* kernel ID. </li> <li> <p><code>key-name</code> - The name of the key
* pair used when the instance was launched. </li> <li>
* <p><code>launch-index</code> - When launching multiple instances, this
* is the index for the instance in the launch group (for example, 0, 1,
* 2, and so on). </li> <li> <p><code>launch-time</code> - The time when
* the instance was launched. </li> <li> <p><code>monitoring-state</code>
* - Indicates whether monitoring is enabled for the instance
* (<code>disabled</code> | <code>enabled</code>). </li> <li>
* <p><code>owner-id</code> - The AWS account ID of the instance owner.
* </li> <li> <p><code>placement-group-name</code> - The name of the
* placement group for the instance. </li> <li> <p><code>platform</code>
* - The platform. Use <code>windows</code> if you have Windows
* instances; otherwise, leave blank. </li> <li>
* <p><code>private-dns-name</code> - The private DNS name of the
* instance. </li> <li> <p><code>private-ip-address</code> - The private
* IP address of the instance. </li> <li> <p><code>product-code</code> -
* The product code associated with the AMI used to launch the instance.
* </li> <li> <p><code>product-code.type</code> - The type of product
* code (<code>devpay</code> | <code>marketplace</code>). </li> <li>
* <p><code>ramdisk-id</code> - The RAM disk ID. </li> <li>
* <p><code>reason</code> - The reason for the current state of the
* instance (for example, shows "User Initiated [date]" when you stop or
* terminate the instance). Similar to the state-reason-code filter.
* </li> <li> <p><code>requester-id</code> - The ID of the entity that
* launched the instance on your behalf (for example, AWS Management
* Console, Auto Scaling, and so on). </li> <li>
* <p><code>reservation-id</code> - The ID of the instance's reservation.
* A reservation ID is created any time you launch an instance. A
* reservation ID has a one-to-one relationship with an instance launch
* request, but can be associated with more than one instance if you
* launch multiple instances using the same launch request. For example,
* if you launch one instance, you'll get one reservation ID. If you
* launch ten instances using the same launch request, you'll also get
* one reservation ID. </li> <li> <p><code>root-device-name</code> - The
* name of the root device for the instance (for example,
* <code>/dev/sda1</code> or <code>/dev/xvda</code>). </li> <li>
* <p><code>root-device-type</code> - The type of root device that the
* instance uses (<code>ebs</code> | <code>instance-store</code>). </li>
* <li> <p><code>source-dest-check</code> - Indicates whether the
* instance performs source/destination checking. A value of
* <code>true</code> means that checking is enabled, and
* <code>false</code> means checking is disabled. The value must be
* <code>false</code> for the instance to perform network address
* translation (NAT) in your VPC. </li> <li>
* <p><code>spot-instance-request-id</code> - The ID of the Spot instance
* request. </li> <li> <p><code>state-reason-code</code> - The reason
* code for the state change. </li> <li>
* <p><code>state-reason-message</code> - A message that describes the
* state change. </li> <li> <p><code>subnet-id</code> - The ID of the
* subnet for the instance. </li> <li>
* <p><code>tag</code>:<i>key</i>=<i>value</i> - The key/value
* combination of a tag assigned to the resource, where
* <code>tag</code>:<i>key</i> is the tag's key. </li> <li>
* <p><code>tag-key</code> - The key of a tag assigned to the resource.
* This filter is independent of the <code>tag-value</code> filter. For
* example, if you use both the filter "tag-key=Purpose" and the filter
* "tag-value=X", you get any resources assigned both the tag key Purpose
* (regardless of what the tag's value is), and the tag value X
* (regardless of what the tag's key is). If you want to list only
* resources where Purpose is X, see the
* <code>tag</code>:<i>key</i>=<i>value</i> filter. </li> <li>
* <p><code>tag-value</code> - The value of a tag assigned to the
* resource. This filter is independent of the <code>tag-key</code>
* filter. </li> <li> <p><code>tenancy</code> - The tenancy of an
* instance (<code>dedicated</code> | <code>default</code> |
* <code>host</code>). </li> <li> <p><code>virtualization-type</code> -
* The virtualization type of the instance (<code>paravirtual</code> |
* <code>hvm</code>). </li> <li> <p><code>vpc-id</code> - The ID of the
* VPC that the instance is running in. </li> <li>
* <p><code>network-interface.description</code> - The description of the
* network interface. </li> <li>
* <p><code>network-interface.subnet-id</code> - The ID of the subnet for
* the network interface. </li> <li>
* <p><code>network-interface.vpc-id</code> - The ID of the VPC for the
* network interface. </li> <li>
* <p><code>network-interface.network-interface-id</code> - The ID of the
* network interface. </li> <li>
* <p><code>network-interface.owner-id</code> - The ID of the owner of
* the network interface. </li> <li>
* <p><code>network-interface.availability-zone</code> - The Availability
* Zone for the network interface. </li> <li>
* <p><code>network-interface.requester-id</code> - The requester ID for
* the network interface. </li> <li>
* <p><code>network-interface.requester-managed</code> - Indicates
* whether the network interface is being managed by AWS. </li> <li>
* <p><code>network-interface.status</code> - The status of the network
* interface (<code>available</code>) | <code>in-use</code>). </li> <li>
* <p><code>network-interface.mac-address</code> - The MAC address of the
* network interface. </li> <li>
* <p><code>network-interface.private-dns-name</code> - The private DNS
* name of the network interface. </li> <li>
* <p><code>network-interface.source-dest-check</code> - Whether the
* network interface performs source/destination checking. A value of
* <code>true</code> means checking is enabled, and <code>false</code>
* means checking is disabled. The value must be <code>false</code> for
* the network interface to perform network address translation (NAT) in
* your VPC. </li> <li> <p><code>network-interface.group-id</code> - The
* ID of a security group associated with the network interface. </li>
* <li> <p><code>network-interface.group-name</code> - The name of a
* security group associated with the network interface. </li> <li>
* <p><code>network-interface.attachment.attachment-id</code> - The ID of
* the interface attachment. </li> <li>
* <p><code>network-interface.attachment.instance-id</code> - The ID of
* the instance to which the network interface is attached. </li> <li>
* <p><code>network-interface.attachment.instance-owner-id</code> - The
* owner ID of the instance to which the network interface is attached.
* </li> <li>
* <p><code>network-interface.addresses.private-ip-address</code> - The
* private IP address associated with the network interface. </li> <li>
* <p><code>network-interface.attachment.device-index</code> - The device
* index to which the network interface is attached. </li> <li>
* <p><code>network-interface.attachment.status</code> - The status of
* the attachment (<code>attaching</code> | <code>attached</code> |
* <code>detaching</code> | <code>detached</code>). </li> <li>
* <p><code>network-interface.attachment.attach-time</code> - The time
* that the network interface was attached to an instance. </li> <li>
* <p><code>network-interface.attachment.delete-on-termination</code> -
* Specifies whether the attachment is deleted when an instance is
* terminated. </li> <li>
* <p><code>network-interface.addresses.primary</code> - Specifies
* whether the IP address of the network interface is the primary private
* IP address. </li> <li>
* <p><code>network-interface.addresses.association.public-ip</code> -
* The ID of the association of an Elastic IP address with a network
* interface. </li> <li>
* <p><code>network-interface.addresses.association.ip-owner-id</code> -
* The owner ID of the private IP address associated with the network
* interface. </li> <li> <p><code>association.public-ip</code> - The
* address of the Elastic IP address bound to the network interface.
* </li> <li> <p><code>association.ip-owner-id</code> - The owner of the
* Elastic IP address associated with the network interface. </li> <li>
* <p><code>association.allocation-id</code> - The allocation ID returned
* when you allocated the Elastic IP address for your network interface.
* </li> <li> <p><code>association.association-id</code> - The
* association ID returned when the network interface was associated with
* an IP address. </li> </ul>
*
* @return A reference to this updated object so that method calls can be chained
* together.
*/
public DescribeInstancesRequest withFilters(Filter... filters) {
if (getFilters() == null) setFilters(new java.util.ArrayList<Filter>(filters.length));
for (Filter value : filters) {
getFilters().add(value);
}
return this;
}
/**
* One or more filters. <ul> <li> <p><code>affinity</code> - The affinity
* setting for an instance running on a Dedicated host
* (<code>default</code> | <code>host</code>). </li> <li>
* <p><code>architecture</code> - The instance architecture
* (<code>i386</code> | <code>x86_64</code>). </li> <li>
* <p><code>availability-zone</code> - The Availability Zone of the
* instance. </li> <li> <p><code>block-device-mapping.attach-time</code>
* - The attach time for an EBS volume mapped to the instance, for
* example, <code>2010-09-15T17:15:20.000Z</code>. </li> <li>
* <p><code>block-device-mapping.delete-on-termination</code> - A Boolean
* that indicates whether the EBS volume is deleted on instance
* termination. </li> <li>
* <p><code>block-device-mapping.device-name</code> - The device name for
* the EBS volume (for example, <code>/dev/sdh</code> or
* <code>xvdh</code>). </li> <li>
* <p><code>block-device-mapping.status</code> - The status for the EBS
* volume (<code>attaching</code> | <code>attached</code> |
* <code>detaching</code> | <code>detached</code>). </li> <li>
* <p><code>block-device-mapping.volume-id</code> - The volume ID of the
* EBS volume. </li> <li> <p><code>client-token</code> - The idempotency
* token you provided when you launched the instance. </li> <li>
* <p><code>dns-name</code> - The public DNS name of the instance. </li>
* <li> <p><code>group-id</code> - The ID of the security group for the
* instance. EC2-Classic only. </li> <li> <p><code>group-name</code> -
* The name of the security group for the instance. EC2-Classic only.
* </li> <li> <p><code>host-Id</code> - The ID of the Dedicated host on
* which the instance is running, if applicable. </li> <li>
* <p><code>hypervisor</code> - The hypervisor type of the instance
* (<code>ovm</code> | <code>xen</code>). </li> <li>
* <p><code>iam-instance-profile.arn</code> - The instance profile
* associated with the instance. Specified as an ARN. </li> <li>
* <p><code>image-id</code> - The ID of the image used to launch the
* instance. </li> <li> <p><code>instance-id</code> - The ID of the
* instance. </li> <li> <p><code>instance-lifecycle</code> - Indicates
* whether this is a Spot Instance or a Scheduled Instance
* (<code>spot</code> | <code>scheduled</code>). </li> <li>
* <p><code>instance-state-code</code> - The state of the instance, as a
* 16-bit unsigned integer. The high byte is an opaque internal value and
* should be ignored. The low byte is set based on the state represented.
* The valid values are: 0 (pending), 16 (running), 32 (shutting-down),
* 48 (terminated), 64 (stopping), and 80 (stopped). </li> <li>
* <p><code>instance-state-name</code> - The state of the instance
* (<code>pending</code> | <code>running</code> |
* <code>shutting-down</code> | <code>terminated</code> |
* <code>stopping</code> | <code>stopped</code>). </li> <li>
* <p><code>instance-type</code> - The type of instance (for example,
* <code>t2.micro</code>). </li> <li> <p><code>instance.group-id</code> -
* The ID of the security group for the instance. </li> <li>
* <p><code>instance.group-name</code> - The name of the security group
* for the instance. </li> <li> <p><code>ip-address</code> - The public
* IP address of the instance. </li> <li> <p><code>kernel-id</code> - The
* kernel ID. </li> <li> <p><code>key-name</code> - The name of the key
* pair used when the instance was launched. </li> <li>
* <p><code>launch-index</code> - When launching multiple instances, this
* is the index for the instance in the launch group (for example, 0, 1,
* 2, and so on). </li> <li> <p><code>launch-time</code> - The time when
* the instance was launched. </li> <li> <p><code>monitoring-state</code>
* - Indicates whether monitoring is enabled for the instance
* (<code>disabled</code> | <code>enabled</code>). </li> <li>
* <p><code>owner-id</code> - The AWS account ID of the instance owner.
* </li> <li> <p><code>placement-group-name</code> - The name of the
* placement group for the instance. </li> <li> <p><code>platform</code>
* - The platform. Use <code>windows</code> if you have Windows
* instances; otherwise, leave blank. </li> <li>
* <p><code>private-dns-name</code> - The private DNS name of the
* instance. </li> <li> <p><code>private-ip-address</code> - The private
* IP address of the instance. </li> <li> <p><code>product-code</code> -
* The product code associated with the AMI used to launch the instance.
* </li> <li> <p><code>product-code.type</code> - The type of product
* code (<code>devpay</code> | <code>marketplace</code>). </li> <li>
* <p><code>ramdisk-id</code> - The RAM disk ID. </li> <li>
* <p><code>reason</code> - The reason for the current state of the
* instance (for example, shows "User Initiated [date]" when you stop or
* terminate the instance). Similar to the state-reason-code filter.
* </li> <li> <p><code>requester-id</code> - The ID of the entity that
* launched the instance on your behalf (for example, AWS Management
* Console, Auto Scaling, and so on). </li> <li>
* <p><code>reservation-id</code> - The ID of the instance's reservation.
* A reservation ID is created any time you launch an instance. A
* reservation ID has a one-to-one relationship with an instance launch
* request, but can be associated with more than one instance if you
* launch multiple instances using the same launch request. For example,
* if you launch one instance, you'll get one reservation ID. If you
* launch ten instances using the same launch request, you'll also get
* one reservation ID. </li> <li> <p><code>root-device-name</code> - The
* name of the root device for the instance (for example,
* <code>/dev/sda1</code> or <code>/dev/xvda</code>). </li> <li>
* <p><code>root-device-type</code> - The type of root device that the
* instance uses (<code>ebs</code> | <code>instance-store</code>). </li>
* <li> <p><code>source-dest-check</code> - Indicates whether the
* instance performs source/destination checking. A value of
* <code>true</code> means that checking is enabled, and
* <code>false</code> means checking is disabled. The value must be
* <code>false</code> for the instance to perform network address
* translation (NAT) in your VPC. </li> <li>
* <p><code>spot-instance-request-id</code> - The ID of the Spot instance
* request. </li> <li> <p><code>state-reason-code</code> - The reason
* code for the state change. </li> <li>
* <p><code>state-reason-message</code> - A message that describes the
* state change. </li> <li> <p><code>subnet-id</code> - The ID of the
* subnet for the instance. </li> <li>
* <p><code>tag</code>:<i>key</i>=<i>value</i> - The key/value
* combination of a tag assigned to the resource, where
* <code>tag</code>:<i>key</i> is the tag's key. </li> <li>
* <p><code>tag-key</code> - The key of a tag assigned to the resource.
* This filter is independent of the <code>tag-value</code> filter. For
* example, if you use both the filter "tag-key=Purpose" and the filter
* "tag-value=X", you get any resources assigned both the tag key Purpose
* (regardless of what the tag's value is), and the tag value X
* (regardless of what the tag's key is). If you want to list only
* resources where Purpose is X, see the
* <code>tag</code>:<i>key</i>=<i>value</i> filter. </li> <li>
* <p><code>tag-value</code> - The value of a tag assigned to the
* resource. This filter is independent of the <code>tag-key</code>
* filter. </li> <li> <p><code>tenancy</code> - The tenancy of an
* instance (<code>dedicated</code> | <code>default</code> |
* <code>host</code>). </li> <li> <p><code>virtualization-type</code> -
* The virtualization type of the instance (<code>paravirtual</code> |
* <code>hvm</code>). </li> <li> <p><code>vpc-id</code> - The ID of the
* VPC that the instance is running in. </li> <li>
* <p><code>network-interface.description</code> - The description of the
* network interface. </li> <li>
* <p><code>network-interface.subnet-id</code> - The ID of the subnet for
* the network interface. </li> <li>
* <p><code>network-interface.vpc-id</code> - The ID of the VPC for the
* network interface. </li> <li>
* <p><code>network-interface.network-interface-id</code> - The ID of the
* network interface. </li> <li>
* <p><code>network-interface.owner-id</code> - The ID of the owner of
* the network interface. </li> <li>
* <p><code>network-interface.availability-zone</code> - The Availability
* Zone for the network interface. </li> <li>
* <p><code>network-interface.requester-id</code> - The requester ID for
* the network interface. </li> <li>
* <p><code>network-interface.requester-managed</code> - Indicates
* whether the network interface is being managed by AWS. </li> <li>
* <p><code>network-interface.status</code> - The status of the network
* interface (<code>available</code>) | <code>in-use</code>). </li> <li>
* <p><code>network-interface.mac-address</code> - The MAC address of the
* network interface. </li> <li>
* <p><code>network-interface.private-dns-name</code> - The private DNS
* name of the network interface. </li> <li>
* <p><code>network-interface.source-dest-check</code> - Whether the
* network interface performs source/destination checking. A value of
* <code>true</code> means checking is enabled, and <code>false</code>
* means checking is disabled. The value must be <code>false</code> for
* the network interface to perform network address translation (NAT) in
* your VPC. </li> <li> <p><code>network-interface.group-id</code> - The
* ID of a security group associated with the network interface. </li>
* <li> <p><code>network-interface.group-name</code> - The name of a
* security group associated with the network interface. </li> <li>
* <p><code>network-interface.attachment.attachment-id</code> - The ID of
* the interface attachment. </li> <li>
* <p><code>network-interface.attachment.instance-id</code> - The ID of
* the instance to which the network interface is attached. </li> <li>
* <p><code>network-interface.attachment.instance-owner-id</code> - The
* owner ID of the instance to which the network interface is attached.
* </li> <li>
* <p><code>network-interface.addresses.private-ip-address</code> - The
* private IP address associated with the network interface. </li> <li>
* <p><code>network-interface.attachment.device-index</code> - The device
* index to which the network interface is attached. </li> <li>
* <p><code>network-interface.attachment.status</code> - The status of
* the attachment (<code>attaching</code> | <code>attached</code> |
* <code>detaching</code> | <code>detached</code>). </li> <li>
* <p><code>network-interface.attachment.attach-time</code> - The time
* that the network interface was attached to an instance. </li> <li>
* <p><code>network-interface.attachment.delete-on-termination</code> -
* Specifies whether the attachment is deleted when an instance is
* terminated. </li> <li>
* <p><code>network-interface.addresses.primary</code> - Specifies
* whether the IP address of the network interface is the primary private
* IP address. </li> <li>
* <p><code>network-interface.addresses.association.public-ip</code> -
* The ID of the association of an Elastic IP address with a network
* interface. </li> <li>
* <p><code>network-interface.addresses.association.ip-owner-id</code> -
* The owner ID of the private IP address associated with the network
* interface. </li> <li> <p><code>association.public-ip</code> - The
* address of the Elastic IP address bound to the network interface.
* </li> <li> <p><code>association.ip-owner-id</code> - The owner of the
* Elastic IP address associated with the network interface. </li> <li>
* <p><code>association.allocation-id</code> - The allocation ID returned
* when you allocated the Elastic IP address for your network interface.
* </li> <li> <p><code>association.association-id</code> - The
* association ID returned when the network interface was associated with
* an IP address. </li> </ul>
* <p>
* Returns a reference to this object so that method calls can be chained together.
*
* @param filters One or more filters. <ul> <li> <p><code>affinity</code> - The affinity
* setting for an instance running on a Dedicated host
* (<code>default</code> | <code>host</code>). </li> <li>
* <p><code>architecture</code> - The instance architecture
* (<code>i386</code> | <code>x86_64</code>). </li> <li>
* <p><code>availability-zone</code> - The Availability Zone of the
* instance. </li> <li> <p><code>block-device-mapping.attach-time</code>
* - The attach time for an EBS volume mapped to the instance, for
* example, <code>2010-09-15T17:15:20.000Z</code>. </li> <li>
* <p><code>block-device-mapping.delete-on-termination</code> - A Boolean
* that indicates whether the EBS volume is deleted on instance
* termination. </li> <li>
* <p><code>block-device-mapping.device-name</code> - The device name for
* the EBS volume (for example, <code>/dev/sdh</code> or
* <code>xvdh</code>). </li> <li>
* <p><code>block-device-mapping.status</code> - The status for the EBS
* volume (<code>attaching</code> | <code>attached</code> |
* <code>detaching</code> | <code>detached</code>). </li> <li>
* <p><code>block-device-mapping.volume-id</code> - The volume ID of the
* EBS volume. </li> <li> <p><code>client-token</code> - The idempotency
* token you provided when you launched the instance. </li> <li>
* <p><code>dns-name</code> - The public DNS name of the instance. </li>
* <li> <p><code>group-id</code> - The ID of the security group for the
* instance. EC2-Classic only. </li> <li> <p><code>group-name</code> -
* The name of the security group for the instance. EC2-Classic only.
* </li> <li> <p><code>host-Id</code> - The ID of the Dedicated host on
* which the instance is running, if applicable. </li> <li>
* <p><code>hypervisor</code> - The hypervisor type of the instance
* (<code>ovm</code> | <code>xen</code>). </li> <li>
* <p><code>iam-instance-profile.arn</code> - The instance profile
* associated with the instance. Specified as an ARN. </li> <li>
* <p><code>image-id</code> - The ID of the image used to launch the
* instance. </li> <li> <p><code>instance-id</code> - The ID of the
* instance. </li> <li> <p><code>instance-lifecycle</code> - Indicates
* whether this is a Spot Instance or a Scheduled Instance
* (<code>spot</code> | <code>scheduled</code>). </li> <li>
* <p><code>instance-state-code</code> - The state of the instance, as a
* 16-bit unsigned integer. The high byte is an opaque internal value and
* should be ignored. The low byte is set based on the state represented.
* The valid values are: 0 (pending), 16 (running), 32 (shutting-down),
* 48 (terminated), 64 (stopping), and 80 (stopped). </li> <li>
* <p><code>instance-state-name</code> - The state of the instance
* (<code>pending</code> | <code>running</code> |
* <code>shutting-down</code> | <code>terminated</code> |
* <code>stopping</code> | <code>stopped</code>). </li> <li>
* <p><code>instance-type</code> - The type of instance (for example,
* <code>t2.micro</code>). </li> <li> <p><code>instance.group-id</code> -
* The ID of the security group for the instance. </li> <li>
* <p><code>instance.group-name</code> - The name of the security group
* for the instance. </li> <li> <p><code>ip-address</code> - The public
* IP address of the instance. </li> <li> <p><code>kernel-id</code> - The
* kernel ID. </li> <li> <p><code>key-name</code> - The name of the key
* pair used when the instance was launched. </li> <li>
* <p><code>launch-index</code> - When launching multiple instances, this
* is the index for the instance in the launch group (for example, 0, 1,
* 2, and so on). </li> <li> <p><code>launch-time</code> - The time when
* the instance was launched. </li> <li> <p><code>monitoring-state</code>
* - Indicates whether monitoring is enabled for the instance
* (<code>disabled</code> | <code>enabled</code>). </li> <li>
* <p><code>owner-id</code> - The AWS account ID of the instance owner.
* </li> <li> <p><code>placement-group-name</code> - The name of the
* placement group for the instance. </li> <li> <p><code>platform</code>
* - The platform. Use <code>windows</code> if you have Windows
* instances; otherwise, leave blank. </li> <li>
* <p><code>private-dns-name</code> - The private DNS name of the
* instance. </li> <li> <p><code>private-ip-address</code> - The private
* IP address of the instance. </li> <li> <p><code>product-code</code> -
* The product code associated with the AMI used to launch the instance.
* </li> <li> <p><code>product-code.type</code> - The type of product
* code (<code>devpay</code> | <code>marketplace</code>). </li> <li>
* <p><code>ramdisk-id</code> - The RAM disk ID. </li> <li>
* <p><code>reason</code> - The reason for the current state of the
* instance (for example, shows "User Initiated [date]" when you stop or
* terminate the instance). Similar to the state-reason-code filter.
* </li> <li> <p><code>requester-id</code> - The ID of the entity that
* launched the instance on your behalf (for example, AWS Management
* Console, Auto Scaling, and so on). </li> <li>
* <p><code>reservation-id</code> - The ID of the instance's reservation.
* A reservation ID is created any time you launch an instance. A
* reservation ID has a one-to-one relationship with an instance launch
* request, but can be associated with more than one instance if you
* launch multiple instances using the same launch request. For example,
* if you launch one instance, you'll get one reservation ID. If you
* launch ten instances using the same launch request, you'll also get
* one reservation ID. </li> <li> <p><code>root-device-name</code> - The
* name of the root device for the instance (for example,
* <code>/dev/sda1</code> or <code>/dev/xvda</code>). </li> <li>
* <p><code>root-device-type</code> - The type of root device that the
* instance uses (<code>ebs</code> | <code>instance-store</code>). </li>
* <li> <p><code>source-dest-check</code> - Indicates whether the
* instance performs source/destination checking. A value of
* <code>true</code> means that checking is enabled, and
* <code>false</code> means checking is disabled. The value must be
* <code>false</code> for the instance to perform network address
* translation (NAT) in your VPC. </li> <li>
* <p><code>spot-instance-request-id</code> - The ID of the Spot instance
* request. </li> <li> <p><code>state-reason-code</code> - The reason
* code for the state change. </li> <li>
* <p><code>state-reason-message</code> - A message that describes the
* state change. </li> <li> <p><code>subnet-id</code> - The ID of the
* subnet for the instance. </li> <li>
* <p><code>tag</code>:<i>key</i>=<i>value</i> - The key/value
* combination of a tag assigned to the resource, where
* <code>tag</code>:<i>key</i> is the tag's key. </li> <li>
* <p><code>tag-key</code> - The key of a tag assigned to the resource.
* This filter is independent of the <code>tag-value</code> filter. For
* example, if you use both the filter "tag-key=Purpose" and the filter
* "tag-value=X", you get any resources assigned both the tag key Purpose
* (regardless of what the tag's value is), and the tag value X
* (regardless of what the tag's key is). If you want to list only
* resources where Purpose is X, see the
* <code>tag</code>:<i>key</i>=<i>value</i> filter. </li> <li>
* <p><code>tag-value</code> - The value of a tag assigned to the
* resource. This filter is independent of the <code>tag-key</code>
* filter. </li> <li> <p><code>tenancy</code> - The tenancy of an
* instance (<code>dedicated</code> | <code>default</code> |
* <code>host</code>). </li> <li> <p><code>virtualization-type</code> -
* The virtualization type of the instance (<code>paravirtual</code> |
* <code>hvm</code>). </li> <li> <p><code>vpc-id</code> - The ID of the
* VPC that the instance is running in. </li> <li>
* <p><code>network-interface.description</code> - The description of the
* network interface. </li> <li>
* <p><code>network-interface.subnet-id</code> - The ID of the subnet for
* the network interface. </li> <li>
* <p><code>network-interface.vpc-id</code> - The ID of the VPC for the
* network interface. </li> <li>
* <p><code>network-interface.network-interface-id</code> - The ID of the
* network interface. </li> <li>
* <p><code>network-interface.owner-id</code> - The ID of the owner of
* the network interface. </li> <li>
* <p><code>network-interface.availability-zone</code> - The Availability
* Zone for the network interface. </li> <li>
* <p><code>network-interface.requester-id</code> - The requester ID for
* the network interface. </li> <li>
* <p><code>network-interface.requester-managed</code> - Indicates
* whether the network interface is being managed by AWS. </li> <li>
* <p><code>network-interface.status</code> - The status of the network
* interface (<code>available</code>) | <code>in-use</code>). </li> <li>
* <p><code>network-interface.mac-address</code> - The MAC address of the
* network interface. </li> <li>
* <p><code>network-interface.private-dns-name</code> - The private DNS
* name of the network interface. </li> <li>
* <p><code>network-interface.source-dest-check</code> - Whether the
* network interface performs source/destination checking. A value of
* <code>true</code> means checking is enabled, and <code>false</code>
* means checking is disabled. The value must be <code>false</code> for
* the network interface to perform network address translation (NAT) in
* your VPC. </li> <li> <p><code>network-interface.group-id</code> - The
* ID of a security group associated with the network interface. </li>
* <li> <p><code>network-interface.group-name</code> - The name of a
* security group associated with the network interface. </li> <li>
* <p><code>network-interface.attachment.attachment-id</code> - The ID of
* the interface attachment. </li> <li>
* <p><code>network-interface.attachment.instance-id</code> - The ID of
* the instance to which the network interface is attached. </li> <li>
* <p><code>network-interface.attachment.instance-owner-id</code> - The
* owner ID of the instance to which the network interface is attached.
* </li> <li>
* <p><code>network-interface.addresses.private-ip-address</code> - The
* private IP address associated with the network interface. </li> <li>
* <p><code>network-interface.attachment.device-index</code> - The device
* index to which the network interface is attached. </li> <li>
* <p><code>network-interface.attachment.status</code> - The status of
* the attachment (<code>attaching</code> | <code>attached</code> |
* <code>detaching</code> | <code>detached</code>). </li> <li>
* <p><code>network-interface.attachment.attach-time</code> - The time
* that the network interface was attached to an instance. </li> <li>
* <p><code>network-interface.attachment.delete-on-termination</code> -
* Specifies whether the attachment is deleted when an instance is
* terminated. </li> <li>
* <p><code>network-interface.addresses.primary</code> - Specifies
* whether the IP address of the network interface is the primary private
* IP address. </li> <li>
* <p><code>network-interface.addresses.association.public-ip</code> -
* The ID of the association of an Elastic IP address with a network
* interface. </li> <li>
* <p><code>network-interface.addresses.association.ip-owner-id</code> -
* The owner ID of the private IP address associated with the network
* interface. </li> <li> <p><code>association.public-ip</code> - The
* address of the Elastic IP address bound to the network interface.
* </li> <li> <p><code>association.ip-owner-id</code> - The owner of the
* Elastic IP address associated with the network interface. </li> <li>
* <p><code>association.allocation-id</code> - The allocation ID returned
* when you allocated the Elastic IP address for your network interface.
* </li> <li> <p><code>association.association-id</code> - The
* association ID returned when the network interface was associated with
* an IP address. </li> </ul>
*
* @return A reference to this updated object so that method calls can be chained
* together.
*/
public DescribeInstancesRequest withFilters(java.util.Collection<Filter> filters) {
if (filters == null) {
this.filters = null;
} else {
com.amazonaws.internal.ListWithAutoConstructFlag<Filter> filtersCopy = new com.amazonaws.internal.ListWithAutoConstructFlag<Filter>(filters.size());
filtersCopy.addAll(filters);
this.filters = filtersCopy;
}
return this;
}
/**
* The token to request the next page of results.
*
* @return The token to request the next page of results.
*/
public String getNextToken() {
return nextToken;
}
/**
* The token to request the next page of results.
*
* @param nextToken The token to request the next page of results.
*/
public void setNextToken(String nextToken) {
this.nextToken = nextToken;
}
/**
* The token to request the next page of results.
* <p>
* Returns a reference to this object so that method calls can be chained together.
*
* @param nextToken The token to request the next page of results.
*
* @return A reference to this updated object so that method calls can be chained
* together.
*/
public DescribeInstancesRequest withNextToken(String nextToken) {
this.nextToken = nextToken;
return this;
}
/**
* The maximum number of results to return in a single call. To retrieve
* the remaining results, make another call with the returned
* <code>NextToken</code> value. This value can be between 5 and 1000.
* You cannot specify this parameter and the instance IDs parameter or
* tag filters in the same call.
*
* @return The maximum number of results to return in a single call. To retrieve
* the remaining results, make another call with the returned
* <code>NextToken</code> value. This value can be between 5 and 1000.
* You cannot specify this parameter and the instance IDs parameter or
* tag filters in the same call.
*/
public Integer getMaxResults() {
return maxResults;
}
/**
* The maximum number of results to return in a single call. To retrieve
* the remaining results, make another call with the returned
* <code>NextToken</code> value. This value can be between 5 and 1000.
* You cannot specify this parameter and the instance IDs parameter or
* tag filters in the same call.
*
* @param maxResults The maximum number of results to return in a single call. To retrieve
* the remaining results, make another call with the returned
* <code>NextToken</code> value. This value can be between 5 and 1000.
* You cannot specify this parameter and the instance IDs parameter or
* tag filters in the same call.
*/
public void setMaxResults(Integer maxResults) {
this.maxResults = maxResults;
}
/**
* The maximum number of results to return in a single call. To retrieve
* the remaining results, make another call with the returned
* <code>NextToken</code> value. This value can be between 5 and 1000.
* You cannot specify this parameter and the instance IDs parameter or
* tag filters in the same call.
* <p>
* Returns a reference to this object so that method calls can be chained together.
*
* @param maxResults The maximum number of results to return in a single call. To retrieve
* the remaining results, make another call with the returned
* <code>NextToken</code> value. This value can be between 5 and 1000.
* You cannot specify this parameter and the instance IDs parameter or
* tag filters in the same call.
*
* @return A reference to this updated object so that method calls can be chained
* together.
*/
public DescribeInstancesRequest withMaxResults(Integer maxResults) {
this.maxResults = maxResults;
return this;
}
/**
* This method is intended for internal use only.
* Returns the marshaled request configured with additional parameters to
* enable operation dry-run.
*/
@Override
public Request<DescribeInstancesRequest> getDryRunRequest() {
Request<DescribeInstancesRequest> request = new DescribeInstancesRequestMarshaller().marshall(this);
request.addParameter("DryRun", Boolean.toString(true));
return request;
}
/**
* Returns a string representation of this object; useful for testing and
* debugging.
*
* @return A string representation of this object.
*
* @see java.lang.Object#toString()
*/
@Override
public String toString() {
StringBuilder sb = new StringBuilder();
sb.append("{");
if (getInstanceIds() != null) sb.append("InstanceIds: " + getInstanceIds() + ",");
if (getFilters() != null) sb.append("Filters: " + getFilters() + ",");
if (getNextToken() != null) sb.append("NextToken: " + getNextToken() + ",");
if (getMaxResults() != null) sb.append("MaxResults: " + getMaxResults() );
sb.append("}");
return sb.toString();
}
@Override
public int hashCode() {
final int prime = 31;
int hashCode = 1;
hashCode = prime * hashCode + ((getInstanceIds() == null) ? 0 : getInstanceIds().hashCode());
hashCode = prime * hashCode + ((getFilters() == null) ? 0 : getFilters().hashCode());
hashCode = prime * hashCode + ((getNextToken() == null) ? 0 : getNextToken().hashCode());
hashCode = prime * hashCode + ((getMaxResults() == null) ? 0 : getMaxResults().hashCode());
return hashCode;
}
@Override
public boolean equals(Object obj) {
if (this == obj) return true;
if (obj == null) return false;
if (obj instanceof DescribeInstancesRequest == false) return false;
DescribeInstancesRequest other = (DescribeInstancesRequest)obj;
if (other.getInstanceIds() == null ^ this.getInstanceIds() == null) return false;
if (other.getInstanceIds() != null && other.getInstanceIds().equals(this.getInstanceIds()) == false) return false;
if (other.getFilters() == null ^ this.getFilters() == null) return false;
if (other.getFilters() != null && other.getFilters().equals(this.getFilters()) == false) return false;
if (other.getNextToken() == null ^ this.getNextToken() == null) return false;
if (other.getNextToken() != null && other.getNextToken().equals(this.getNextToken()) == false) return false;
if (other.getMaxResults() == null ^ this.getMaxResults() == null) return false;
if (other.getMaxResults() != null && other.getMaxResults().equals(this.getMaxResults()) == false) return false;
return true;
}
}