:doc:`EC2 <../../ec2>` / Resource / Image

=====
Image
=====



.. note::

  Before using anything on this page, please refer to the resources :doc:`user guide <../../../../guide/resources>` for the most recent guidance on using resources.



.. py:class:: EC2.Image(id)

  A resource representing an Amazon Elastic Compute Cloud (EC2) Image::

    
    import boto3
    
    ec2 = boto3.resource('ec2')
    image = ec2.Image('id')

  :type id: string
  :param id: The Image's id identifier. This **must** be set.
  




-----------
Identifiers
-----------



Identifiers are properties of a resource that are set upon instantiation of the resource.
For more information about identifiers refer to the :ref:`Resources Introduction Guide<identifiers_attributes_intro>`.

These are the resource's available identifiers:

.. toctree::
  :maxdepth: 1
  :titlesonly:

  id



----------
Attributes
----------



Attributes provide access to the properties of a resource. Attributes are lazy-loaded the first time one is accessed via the :py:meth:`load` method.
For more information about attributes refer to the :ref:`Resources Introduction Guide<identifiers_attributes_intro>`.

These are the resource's available attributes:

.. toctree::
  :maxdepth: 1
  :titlesonly:

  architecture
  block_device_mappings
  boot_mode
  creation_date
  deprecation_time
  deregistration_protection
  description
  ena_support
  free_tier_eligible
  hypervisor
  image_allowed
  image_id
  image_location
  image_owner_alias
  image_type
  imds_support
  kernel_id
  last_launched_time
  name
  owner_id
  platform
  platform_details
  product_codes
  public
  ramdisk_id
  root_device_name
  root_device_type
  source_image_id
  source_image_region
  source_instance_id
  sriov_net_support
  state
  state_reason
  tags
  tpm_support
  usage_operation
  virtualization_type



-------
Actions
-------



Actions call operations on resources.  They may automatically handle the passing in of arguments set from identifiers and some attributes.
For more information about actions refer to the :ref:`Resources Introduction Guide<actions_intro>`.

These are the resource's available actions:

.. toctree::
  :maxdepth: 1
  :titlesonly:

  create_tags
  deregister
  describe_attribute
  get_available_subresources
  load
  modify_attribute
  reload
  reset_attribute



-------
Waiters
-------



Waiters provide an interface to wait for a resource to reach a specific state.
For more information about waiters refer to the :ref:`Resources Introduction Guide<waiters_intro>`.

These are the resource's available waiters:

.. toctree::
  :maxdepth: 1
  :titlesonly:

  wait_until_exists
