Skip to main content

DynamoDB

DynamoDB Mock​

As a convenience, we provide a pre-made mock to get you started quickly with AWS DynamoDB. You can find the pre-made mock recording here. The parent directory contains the code for the demo app that was used to generate the mock.

Importing and Inspecting the Mock​

To import the mock, you can use the following command (point to the file in your local directory):

proxymock import --file default.jsonl

The import prints the directory it wrote the RRPair files to (under proxymock/). Run the following command to browse the mock in your browser:

proxymock web --in <directory>

Request Format​

For general information about AWS APIs, please see our notes. Speedscale's AWS DynamoDB default mock has recordings for the following operations:

  • CreateTable
  • GetItem
  • PutItem
  • UpdateItem
  • DeleteItem
  • Scan
  • Query
  • DeleteTable
  • BatchGetItem
  • BatchWriteItem

Open the request body of one of the Query operations:

{
  "ExpressionAttributeValues": {
    ":id": {
      "S": "1"
    }
  },
  "KeyConditionExpression": "ID = :id",
  "TableName": "DemoTable"
}

You can learn more about this format from the AWS documentation. To modify the query, you need to modify the request body. Unless you change the command type you don't need to edit query parameters or headers to mock this protocol.

Response Format​

{
  "Count": 1,
  "Items": [
    {
      "value": {
        "S": "Value1"
      },
      "ID": {
        "S": "1"
      },
      "name": {
        "S": "Item1"
      },
      "Value": {
        "S": "UpdatedValue1"
      }
    }
  ],
  "ScannedCount": 1
}

To modify the response returned by the mock, change the payload in the recording. The exact format of DynamoDB responses can be observed using the AWS CLI. The pattern is fairly straightforward with the key names and IDs outlined in the JSON.