Azure Storage Tables Reference

Table Reference

This section provides detailed reference information for Azure Table Storage operations, including REST API endpoints, request/response formats, and data structures.

Table Operations

Table operations allow you to manage tables within your Azure Storage account. These operations are performed via the Table service REST API.

List Tables

Retrieves a collection of tables that belong to the storage account.

Request URI

GET /<storage-account-name>/Tables?query=[...] HTTP/1.1
Authorization: SharedKey <account-name>:<signature>
Date: <date>
Content-Type: application/json;odata=nometadata

Response Body (Success Example)

{
    "value": [
        {
            "TableName": "Products",
            " odata.editLink": "Tables('Products')"
        },
        {
            "TableName": "Customers",
            "odata.editLink": "Tables('Customers')"
        }
    ]
}

Create Table

Creates a new table within the storage account.

Request URI

POST /<storage-account-name>/Tables HTTP/1.1
Authorization: SharedKey <account-name>:<signature>
Date: <date>
Content-Type: application/json;odata=nometadata

Request Body

{
    "TableName": "NewOrders"
}

Response Body (Success Example)

{
    "TableName": "NewOrders",
    "odata.editLink": "Tables('NewOrders')"
}

Delete Table

Deletes a table and all of its data from the storage account.

Request URI

DELETE /<storage-account-name>/Tables('TableName') HTTP/1.1
Authorization: SharedKey <account-name>:<signature>
Date: <date>
Content-Type: application/json;odata=nometadata

Common Headers and Parameters

The following headers and parameters are commonly used across table operations:

Header/Parameter	Description
`Authorization`	Required. Specifies the authentication method and credentials.
`Date`	Required. The date and time of the request in RFC 1123 format.
`Content-Type`	Specifies the media type of the request body. For OData, typically `application/json;odata=nometadata`.
`Accept`	Specifies the desired media type for the response.
`DataServiceVersion`	Specifies the OData version for the request.
`x-ms-version`	Specifies the version of the Table service API.

Data Formats

Azure Table Storage primarily uses the OData (Open Data Protocol) format for requests and responses. The odata=nometadata option is commonly used to minimize the payload size.

Error Handling

Azure Table Storage returns standard HTTP status codes. Error details are provided in the response body, typically in JSON format, including an error code and a descriptive message.