:doc:`IAM <../../iam>` / Resource / Policy

======
Policy
======



.. 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:: IAM.Policy(arn)

  A resource representing an AWS Identity and Access Management (IAM) Policy::

    
    import boto3
    
    iam = boto3.resource('iam')
    policy = iam.Policy('arn')

  :type arn: string
  :param arn: The Policy's arn 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:

  arn



----------
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:

  attachment_count
  create_date
  default_version_id
  description
  is_attachable
  path
  permissions_boundary_usage_count
  policy_id
  policy_name
  tags
  update_date



----------
References
----------



References are related resource instances that have a belongs-to relationship.
For more information about references refer to the :ref:`Resources Introduction Guide<references_intro>`.

These are the resource's available references:

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

  default_version



-------
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:

  attach_group
  attach_role
  attach_user
  create_version
  delete
  detach_group
  detach_role
  detach_user
  get_available_subresources
  load
  reload



-----------
Collections
-----------



Collections provide an interface to iterate over and manipulate groups of resources. 
For more information about collections refer to the :ref:`Resources Introduction Guide<guide_collections>`.

These are the resource's available collections:

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

  attached_groups
  attached_roles
  attached_users
  versions
