CloudFront Key Value Store API

The Key Value Store API from CloudFront — 2 operation(s) for key value store.

Operations 5

POST /2020-05-31/key-value-store Create Key Value Store #
GET /2020-05-31/key-value-store List Key Value Stores #
DELETE /2020-05-31/key-value-store/{Name} Delete Key Value Store #
GET /2020-05-31/key-value-store/{Name} Describe Key Value Store #
PUT /2020-05-31/key-value-store/{Name} Update Key Value Store #

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/cloudfront:cloudfront-key-value-store-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

cloudfront-key-value-store-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Amazon CloudFront Key Value Store API
  version: '2020-05-31'
  description: Generated from AWS's published Smithy model for Amazon CloudFront. 5 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://cloudfront.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
paths:
  /2020-05-31/key-value-store:
    post:
      operationId: CreateKeyValueStore
      summary: Create Key Value Store
      description: Specifies the key value store resource to add to your account. In your account, the key value store names
        must be unique. You can also import key value store data in JSON format from an S3 bucket by providing a valid ImportSource
        that you own.
      responses:
        '200':
          description: Success
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/CreateKeyValueStoreResult'
              example:
                KeyValueStore:
                  Name: my-keyvaluestore-name
                  Id: 54947df8-0e9e-4471-a2f9-9af509fb5889
                  Comment: my-key-valuestore-comment
                  ARN: arn:aws:cloudfront::123456789012:key-value-store/54947df8-0e9e-4471-a2f9-9af509fb5889
                  Status: PROVISIONING
                  LastModifiedTime: '2023-11-07T18:15:52.042Z'
                ETag: ETVPDKIKX0DER
                Location: https://cloudfront.amazonaws.com/2020-05-31/key-value-store/arn:aws:cloudfront::123456789012:key-value-store/54947df8-0e9e-4471-a2f9-9af509fb5889
        '403':
          description: AccessDenied
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/AccessDenied'
        '409':
          description: EntityAlreadyExists
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/EntityAlreadyExists'
        '400':
          description: EntityLimitExceeded; InvalidArgument; UnsupportedOperation
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/EntityLimitExceeded'
        '413':
          description: EntitySizeLimitExceeded
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/EntitySizeLimitExceeded'
      requestBody:
        content:
          application/xml:
            schema:
              $ref: '#/components/schemas/CreateKeyValueStoreRequest'
            example:
              Name: my-keyvaluestore-name
              Comment: my-key-valuestore-comment
              ImportSource:
                SourceType: S3
                SourceARN: arn:aws:s3:::amzn-s3-demo-bucket/validJSON.json
      tags:
      - Key Value Store
    get:
      operationId: ListKeyValueStores
      summary: List Key Value Stores
      description: Specifies the key value stores to list.
      responses:
        '200':
          description: Success
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/ListKeyValueStoresResult'
              example:
                KeyValueStoreList:
                  NextMarker: ''
                  MaxItems: 100
                  Quantity: 1
                  Items:
                  - Name: my-keyvaluestore-name
                    Id: 54947df8-0e9e-4471-a2f9-9af509fb5889
                    Comment: ''
                    ARN: arn:aws:cloudfront::123456789012:key-value-store/54947df8-0e9e-4471-a2f9-9af509fb5889
                    Status: READY
                    LastModifiedTime: '2023-11-07T18:45:21.069Z'
        '403':
          description: AccessDenied
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/AccessDenied'
        '400':
          description: InvalidArgument; UnsupportedOperation
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/InvalidArgument'
      requestBody:
        content:
          application/xml:
            schema:
              $ref: '#/components/schemas/ListKeyValueStoresRequest'
            example:
              Status: READY
      tags:
      - Key Value Store
  /2020-05-31/key-value-store/{Name}:
    delete:
      operationId: DeleteKeyValueStore
      summary: Delete Key Value Store
      description: Specifies the key value store to delete.
      responses:
        '200':
          description: Success
          content:
            text/xml:
              schema:
                type: string
        '403':
          description: AccessDenied
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/AccessDenied'
        '409':
          description: CannotDeleteEntityWhileInUse
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/CannotDeleteEntityWhileInUse'
        '404':
          description: EntityNotFound
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/EntityNotFound'
        '400':
          description: InvalidIfMatchVersion; UnsupportedOperation
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/InvalidIfMatchVersion'
        '412':
          description: PreconditionFailed
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/PreconditionFailed'
      requestBody:
        content:
          application/xml:
            schema:
              $ref: '#/components/schemas/DeleteKeyValueStoreRequest'
            example:
              Name: my-keyvaluestore-name
              IfMatch: ETVPDKIKX0DER
      tags:
      - Key Value Store
    get:
      operationId: DescribeKeyValueStore
      summary: Describe Key Value Store
      description: Specifies the key value store and its configuration.
      responses:
        '200':
          description: Success
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/DescribeKeyValueStoreResult'
              example:
                KeyValueStore:
                  Name: my-keyvaluestore-name
                  Id: 54947df8-0e9e-4471-a2f9-9af509fb5889
                  Comment: my-key-valuestore-comment
                  ARN: arn:aws:cloudfront::123456789012:key-value-store/54947df8-0e9e-4471-a2f9-9af509fb5889
                  Status: READY
                  LastModifiedTime: '2023-11-07T18:20:33.056Z'
                ETag: ETVPDKIKX0DER
        '403':
          description: AccessDenied
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/AccessDenied'
        '404':
          description: EntityNotFound
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/EntityNotFound'
        '400':
          description: InvalidArgument; UnsupportedOperation
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/InvalidArgument'
      requestBody:
        content:
          application/xml:
            schema:
              $ref: '#/components/schemas/DescribeKeyValueStoreRequest'
            example:
              Name: my-keyvaluestore-name
      tags:
      - Key Value Store
    put:
      operationId: UpdateKeyValueStore
      summary: Update Key Value Store
      description: Specifies the key value store to update.
      responses:
        '200':
          description: Success
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/UpdateKeyValueStoreResult'
              example:
                KeyValueStore:
                  Name: my-keyvaluestore-name
                  Id: 54947df8-0e9e-4471-a2f9-9af509fb5889
                  Comment: my-changed-comment
                  ARN: arn:aws:cloudfront::123456789012:key-value-store/54947df8-0e9e-4471-a2f9-9af509fb5889
                  Status: READY
                  LastModifiedTime: '2023-11-07T18:45:21.069Z'
                ETag: E3UN6WX5RRO2AG
        '403':
          description: AccessDenied
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/AccessDenied'
        '404':
          description: EntityNotFound
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/EntityNotFound'
        '400':
          description: InvalidArgument; InvalidIfMatchVersion; UnsupportedOperation
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/InvalidArgument'
        '412':
          description: PreconditionFailed
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/PreconditionFailed'
      requestBody:
        content:
          application/xml:
            schema:
              $ref: '#/components/schemas/UpdateKeyValueStoreRequest'
            example:
              Name: my-keyvaluestore-name
              Comment: my-changed-comment
              IfMatch: ETVPDKIKX0DER
      tags:
      - Key Value Store
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: cloudfront
  schemas:
    AccessDenied:
      type: object
      properties:
        Message:
          type: string
    CannotDeleteEntityWhileInUse:
      type: object
      properties:
        Message:
          type: string
    CreateKeyValueStoreRequest:
      type: object
      properties:
        Name:
          type: string
          description: The name of the key value store. The minimum length is 1 character and the maximum length is 64 characters.
        Comment:
          type: string
          description: The comment of the key value store.
        ImportSource:
          $ref: '#/components/schemas/ImportSource'
        Tags:
          $ref: '#/components/schemas/Tags'
      required:
      - Name
    CreateKeyValueStoreResult:
      type: object
      properties:
        KeyValueStore:
          $ref: '#/components/schemas/KeyValueStore'
        ETag:
          type: string
          description: The ETag in the resulting key value store.
        Location:
          type: string
          description: The location of the resulting key value store.
    DeleteKeyValueStoreRequest:
      type: object
      properties:
        Name:
          type: string
          description: The name of the key value store.
        IfMatch:
          type: string
          description: The key value store to delete, if a match occurs.
      required:
      - Name
      - IfMatch
    DescribeKeyValueStoreRequest:
      type: object
      properties:
        Name:
          type: string
          description: The name of the key value store.
      required:
      - Name
    DescribeKeyValueStoreResult:
      type: object
      properties:
        KeyValueStore:
          $ref: '#/components/schemas/KeyValueStore'
        ETag:
          type: string
          description: The ETag of the resulting key value store.
    EntityAlreadyExists:
      type: object
      properties:
        Message:
          type: string
    EntityLimitExceeded:
      type: object
      properties:
        Message:
          type: string
    EntityNotFound:
      type: object
      properties:
        Message:
          type: string
    EntitySizeLimitExceeded:
      type: object
      properties:
        Message:
          type: string
    ImportSource:
      type: object
      properties:
        SourceType:
          type: string
          enum:
          - S3
          description: The source type of the import source for the key value store.
        SourceARN:
          type: string
          description: The Amazon Resource Name (ARN) of the import source for the key value store.
      required:
      - SourceType
      - SourceARN
    InvalidArgument:
      type: object
      properties:
        Message:
          type: string
    InvalidIfMatchVersion:
      type: object
      properties:
        Message:
          type: string
    KeyValueStore:
      type: object
      properties:
        Name:
          type: string
          description: The name of the key value store.
        Id:
          type: string
          description: The unique Id for the key value store.
        Comment:
          type: string
          description: A comment for the key value store.
        ARN:
          type: string
          description: The Amazon Resource Name (ARN) of the key value store.
        Status:
          type: string
          description: The status of the key value store.
        LastModifiedTime:
          type: string
          format: date-time
          description: The last-modified time of the key value store.
      required:
      - Name
      - Id
      - Comment
      - ARN
      - LastModifiedTime
    KeyValueStoreList:
      type: object
      properties:
        NextMarker:
          type: string
          description: The next marker associated with the key value store list.
        MaxItems:
          type: integer
          description: The maximum number of items in the key value store list.
        Quantity:
          type: integer
          description: The quantity of the key value store list.
        Items:
          type: array
          items:
            $ref: '#/components/schemas/KeyValueStore'
          description: The items of the key value store list.
      required:
      - MaxItems
      - Quantity
    ListKeyValueStoresRequest:
      type: object
      properties:
        Marker:
          type: string
          description: The marker associated with the key value stores list.
        MaxItems:
          type: integer
          description: The maximum number of items in the key value stores list.
        Status:
          type: string
          description: The status of the request for the key value stores list.
    ListKeyValueStoresResult:
      type: object
      properties:
        KeyValueStoreList:
          $ref: '#/components/schemas/KeyValueStoreList'
    PreconditionFailed:
      type: object
      properties:
        Message:
          type: string
    Tag:
      type: object
      properties:
        Key:
          type: string
          description: 'A string that contains Tag key. The string length should be between 1 and 128 characters. Valid characters
            include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @.'
        Value:
          type: string
          description: 'A string that contains an optional Tag value. The string length should be between 0 and 256 characters.
            Valid characters include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @.'
      required:
      - Key
    Tags:
      type: object
      properties:
        Items:
          type: array
          items:
            $ref: '#/components/schemas/Tag'
          description: A complex type that contains Tag elements.
    UpdateKeyValueStoreRequest:
      type: object
      properties:
        Name:
          type: string
          description: The name of the key value store to update.
        Comment:
          type: string
          description: The comment of the key value store to update.
        IfMatch:
          type: string
          description: The key value store to update, if a match occurs.
      required:
      - Name
      - Comment
      - IfMatch
    UpdateKeyValueStoreResult:
      type: object
      properties:
        KeyValueStore:
          $ref: '#/components/schemas/KeyValueStore'
        ETag:
          type: string
          description: The ETag of the resulting key value store.
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/cloudfront/service/2020-05-31/cloudfront-2020-05-31.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)