Addressing Table Service Resources

  • Article

The Table service exposes the following resources via the REST API:

  • Account. The storage account is a uniquely identified entity within the storage system. The storage account is the parent namespace for the Table service. All tables are associated with an account.

  • Tables. The Tables resource represents the set of tables within a given storage account.

  • Entity. An individual table stores data as a collection of entities.

Resource URI Syntax

The base URI for Table service resources is the storage account:

https://myaccount.table.core.windows.net

To list the tables in a given storage account, to create a new table, or to delete a table, refer to the set of tables in the specified storage account:

https://myaccount.table.core.windows.net/Tables

To return a single table, name that table within the Tables collection, as follows:

https://myaccount.table.core.windows.net/Tables('MyTable')

To query entities in a table, or to insert, update, or delete an entity, refer to that table directly within the storage account. This basic syntax refers to the set of all entities in the named table:

https://myaccount.table.core.windows.net/MyTable()

The format for addressing data resources for queries conforms to that specified by the OData Protocol Specification. You can use this syntax to filter entities based on criteria specified on the URI.

Note that all values for query parameters must be URL encoded before they are sent to the Azure storage services.

Supported HTTP Operations

Each resource supports operations based on the HTTP verbs GET, PUT, HEAD, and DELETE. The verb, syntax, and supported HTTP version(s) for each operation appears on the reference page for each operation. For a complete list of operation reference pages, see Table Service REST API.

See also

Table Service REST API
Understanding the Table Service Data Model
Query Timeout and Pagination
Operations on Tables
Operations on Entities