list_tables

list_tables(**kwargs)

The ListTables API allows you to retrieve a list of all the tables in a workbook.

See also: AWS API Documentation

Request Syntax

response = client.list_tables(
    workbookId='string',
    maxResults=123,
    nextToken='string'
)
Parameters
  • workbookId (string) --

    [REQUIRED]

    The ID of the workbook whose tables are being retrieved.

    If a workbook with the specified id could not be found, this API throws ResourceNotFoundException.

  • maxResults (integer) -- The maximum number of tables to return in each page of the results.
  • nextToken (string) --

    This parameter is optional. If a nextToken is not specified, the API returns the first page of data.

    Pagination tokens expire after 1 hour. If you use a token that was returned more than an hour back, the API will throw ValidationException.

Return type

dict

Returns

Response Syntax

{
    'tables': [
        {
            'tableId': 'string',
            'tableName': 'string'
        },
    ],
    'nextToken': 'string',
    'workbookCursor': 123
}

Response Structure

  • (dict) --

    • tables (list) --

      The list of tables in the workbook.

      • (dict) --

        An object representing the properties of a table in a workbook.

        • tableId (string) --

          The id of the table.

        • tableName (string) --

          The name of the table.

    • nextToken (string) --

      Provides the pagination token to load the next page if there are more results matching the request. If a pagination token is not present in the response, it means that all data matching the request has been loaded.

    • workbookCursor (integer) --

      Indicates the cursor of the workbook at which the data returned by this request is read. Workbook cursor keeps increasing with every update and the increments are not sequential.

Exceptions

  • Honeycode.Client.exceptions.AccessDeniedException
  • Honeycode.Client.exceptions.InternalServerException
  • Honeycode.Client.exceptions.RequestTimeoutException
  • Honeycode.Client.exceptions.ResourceNotFoundException
  • Honeycode.Client.exceptions.ServiceUnavailableException
  • Honeycode.Client.exceptions.ThrottlingException
  • Honeycode.Client.exceptions.ValidationException