Amazon S3 S3 Storage Class API

The S3 Storage Class API from Amazon S3 — 2 operation(s) for s3 storage class.

GitHub OpenAPI

Operations 3

GET /buckets/{tableBucketARN}/storage-class Get Table Bucket Storage Class #
PUT /buckets/{tableBucketARN}/storage-class Put Table Bucket Storage Class #
GET /tables/{tableBucketARN}/{namespace}/{name}/storage-class Get Table Storage Class #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/amazon-s3:amazon-s3-storage-class-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

amazon-s3-storage-class-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Amazon Simple Storage Service Storage Class API
  version: '2006-03-01'
  description: Generated from AWS's published Smithy model for Amazon Simple Storage Service. 3 operation(s).
  contact:
    name: Amazon Web Services
    url: https://aws.amazon.com/contact-us/
  license:
    name: Apache 2.0
    identifier: Apache-2.0
    url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://s3tables.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
paths:
  /buckets/{tableBucketARN}/storage-class:
    get:
      operationId: GetTableBucketStorageClass
      summary: Get Table Bucket Storage Class
      description: Retrieves the storage class configuration for a specific table. This allows you to view the storage class
        settings that apply to an individual table, which may differ from the table bucket's default configuration. Permissions
        You must have the s3tables:GetTableBucketStorageClass permission to use this operation.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTableBucketStorageClassResponse'
        '403':
          description: AccessDeniedException; ForbiddenException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
        '400':
          description: BadRequestException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/S3TablesBadRequestException'
        '500':
          description: InternalServerErrorException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerErrorException'
        '404':
          description: NotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/S3TablesNotFoundException'
        '429':
          description: TooManyRequestsException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TooManyRequestsException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetTableBucketStorageClassRequest'
      tags:
      - Storage Class
    put:
      operationId: PutTableBucketStorageClass
      summary: Put Table Bucket Storage Class
      description: Sets or updates the storage class configuration for a table bucket. This configuration serves as the default
        storage class for all new tables created in the bucket, allowing you to optimize storage costs at the bucket level.
        Permissions You must have the s3tables:PutTableBucketStorageClass permission to use this operation.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: string
        '400':
          description: BadRequestException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/S3TablesBadRequestException'
        '409':
          description: ConflictException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConflictException'
        '403':
          description: ForbiddenException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenException'
        '500':
          description: InternalServerErrorException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerErrorException'
        '404':
          description: NotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/S3TablesNotFoundException'
        '429':
          description: TooManyRequestsException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TooManyRequestsException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PutTableBucketStorageClassRequest'
      tags:
      - Storage Class
  /tables/{tableBucketARN}/{namespace}/{name}/storage-class:
    get:
      operationId: GetTableStorageClass
      summary: Get Table Storage Class
      description: Retrieves the storage class configuration for a specific table. This allows you to view the storage class
        settings that apply to an individual table, which may differ from the table bucket's default configuration. Permissions
        You must have the s3tables:GetTableStorageClass permission to use this operation.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTableStorageClassResponse'
        '403':
          description: AccessDeniedException; ForbiddenException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
        '400':
          description: BadRequestException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/S3TablesBadRequestException'
        '500':
          description: InternalServerErrorException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerErrorException'
        '404':
          description: NotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/S3TablesNotFoundException'
        '429':
          description: TooManyRequestsException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TooManyRequestsException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetTableStorageClassRequest'
      tags:
      - Storage Class
components:
  securitySchemes:
    sigv4:
      type: apiKey
      in: header
      name: Authorization
      description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical
        request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
      x-aws-sigv4:
        signingName: s3tables
  schemas:
    AccessDeniedException:
      type: object
      properties:
        message:
          type: string
    ConflictException:
      type: object
      properties:
        message:
          type: string
    ForbiddenException:
      type: object
      properties:
        message:
          type: string
    GetTableBucketStorageClassRequest:
      type: object
      properties:
        tableBucketARN:
          type: string
          description: The Amazon Resource Name (ARN) of the table bucket.
      required:
      - tableBucketARN
    GetTableBucketStorageClassResponse:
      type: object
      properties:
        storageClassConfiguration:
          $ref: '#/components/schemas/StorageClassConfiguration'
      required:
      - storageClassConfiguration
    GetTableStorageClassRequest:
      type: object
      properties:
        tableBucketARN:
          type: string
          description: The Amazon Resource Name (ARN) of the table bucket that contains the table.
        namespace:
          type: string
          description: The namespace associated with the table.
        name:
          type: string
          description: The name of the table.
      required:
      - tableBucketARN
      - namespace
      - name
    GetTableStorageClassResponse:
      type: object
      properties:
        storageClassConfiguration:
          $ref: '#/components/schemas/StorageClassConfiguration'
      required:
      - storageClassConfiguration
    InternalServerErrorException:
      type: object
      properties:
        message:
          type: string
    PutTableBucketStorageClassRequest:
      type: object
      properties:
        tableBucketARN:
          type: string
          description: The Amazon Resource Name (ARN) of the table bucket.
        storageClassConfiguration:
          $ref: '#/components/schemas/StorageClassConfiguration'
      required:
      - tableBucketARN
      - storageClassConfiguration
    S3TablesBadRequestException:
      type: object
      properties:
        message:
          type: string
    S3TablesNotFoundException:
      type: object
      properties:
        message:
          type: string
    StorageClassConfiguration:
      type: object
      properties:
        storageClass:
          type: string
          enum:
          - STANDARD
          - INTELLIGENT_TIERING
          description: The storage class for the table or table bucket. Valid values include storage classes optimized for
            different access patterns and cost profiles.
      required:
      - storageClass
    TooManyRequestsException:
      type: object
      properties:
        message:
          type: string
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/3cd98287b471c106254abd89279cc87308d38bfd/models/s3tables/service/2018-05-10/s3tables-2018-05-10.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)