:doc:`DynamoDB <../../dynamodb>` / Resource / Table

=====
Table
=====



.. 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:: DynamoDB.Table(name)

  A resource representing an Amazon DynamoDB Table::

    
    import boto3
    
    dynamodb = boto3.resource('dynamodb')
    table = dynamodb.Table('name')

  :type name: string
  :param name: The Table'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:

  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:

  archival_summary
  attribute_definitions
  billing_mode_summary
  creation_date_time
  deletion_protection_enabled
  global_secondary_indexes
  global_table_settings_replication_mode
  global_table_version
  global_table_witnesses
  item_count
  key_schema
  latest_stream_arn
  latest_stream_label
  local_secondary_indexes
  multi_region_consistency
  on_demand_throughput
  provisioned_throughput
  replicas
  restore_summary
  sse_description
  stream_specification
  table_arn
  table_class_summary
  table_id
  table_name
  table_size_bytes
  table_status
  warm_throughput



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

  batch_writer
  delete
  delete_item
  get_available_subresources
  get_item
  load
  put_item
  query
  reload
  scan
  update
  update_item



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