:doc:`Glacier <../../glacier>` / Resource / Vault

=====
Vault
=====



.. 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:: Glacier.Vault(account_id,name)

  A resource representing an Amazon Glacier Vault::

    
    import boto3
    
    glacier = boto3.resource('glacier')
    vault = glacier.Vault('account_id','name')

  :type account_id: string
  :param account_id: The Vault's account_id identifier. This **must** be set.
  :type name: string
  :param name: The Vault's name 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:

  account_id
  name



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

  creation_date
  last_inventory_date
  number_of_archives
  size_in_bytes
  vault_arn
  vault_name



-------
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
  delete
  get_available_subresources
  initiate_inventory_retrieval
  initiate_multipart_upload
  load
  reload
  upload_archive



-------------
Sub-resources
-------------



Sub-resources are methods that create a new instance of a child resource. This resource's identifiers get passed along to the child.
For more information about sub-resources refer to the :ref:`Resources Introduction Guide<subresources_intro>`.

These are the resource's available sub-resources:

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

  Account
  Archive
  Job
  MultipartUpload
  Notification



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

  completed_jobs
  failed_jobs
  jobs
  jobs_in_progress
  multipart_uplaods
  multipart_uploads
  succeeded_jobs
