Replays

Get All Replays for a Capture

Gets all replays for a given capture within an environment.

GET /api/replays?captureId={id}

Permissions

User must be logged in. User must be a member of the environment.

Body Params

Param

Description

Optional/Required

id=[number]

id of the capture to get all replays for

Required

Success Response

200 OK
[
  {
    "id": 1,
    "captureId": 1,
    "dbId": 2,
    "name": "Replay 1",
    "start": "2018-05-19T22:12:46.000Z",
    "end": "2018-05-19T22:12:58.000Z",
    "status": "DONE",
    "type": "REPLAY",
    "reason": null
  }
]

Error Response

404 NOT FOUND
{
    "code": 404,
    "message": "Capture was not Found"
}
{
    "code": 404,
    "message": "Environment was not Found"
}

Get a Specific Replay

Gets the information of a specific replay associated with an environment.

GET /api/replays/{id}

Permissions

User must be logged in. User must be a member of the environment.

Query Params

Param

Description

Optional/Required

id=[number]

id of the replay to get

Required

Success Response

200 OK
{
    "id": 1,
    "captureId": 1,
    "dbId": 2,
    "name": "Replay 1",
    "start": "2018-05-19T22:12:46.000Z",
    "end": "2018-05-19T22:12:58.000Z",
    "status": "DONE",
    "type": "REPLAY",
    "reason": null
}

Error Response

404 NOT FOUND
{
    "code": 404,
    "message": "Replay was not Found"
}

Get Metrics for a Replay

Gets the CloudWatch metrics associated with specific replay associated with an environment.

GET /api/replays/{id}/metrics

Permissions

User must be logged in. User must be a member of the environment.

Query Params

Param

Description

Optional/Required

id=[number]

id of the replay to get metrics for

Required

Success Response

200 OK
[
    {
        "label": "ReadIOPS",
        "type": "READ IOPS",
        "displayName": "READ IOPS",
        "dataPoints": [
            {
                "Timestamp": "2018-05-17T00:53:00.000Z",
                "Maximum": 0.06666888896296544,
                "Unit": "Count/Second"
            }
    }
]

Error Response

404 NOT FOUND
{
    "code": 404,
    "message": "Replay was not Found"
}

Edit a Replay

Edits the information of a replay.

PUT /api/replays/{id}

Permissions

User must be logged in. User must either be the owner of the replay or be an admin of the environment.

Query Params

Param

Description

Optional/Required

id=[number]

id of the replay to edit

Required

Sample Request Body

{
 "name" : "newName"
}

Success Response

200 OK

Error Response

400 BAD REQUEST
{
    "code": 400,
    "message": "Replay's capture does not exist"
}
{
    "code": 404,
    "message": "Replay with the same name already exists on this capture"
}

Post a New Replay

Creates a new replay to be run on a capture.

POST /api/replays

Permissions

User must be logged in. User must be a member of the environment.

Body Params

Param

Description

Optional/Required

name=[string]

Name of the replay that will be displayed in the UI

Required

captureId=[number]

id of the capture that the replay belongs to

Required

dbName=[string]

Name of the AWS database resource that the replay will be running on

Required

host=[string]

Where the AWS server resource is

Required

user=[string]

Username for AWS resource

Required

pass=[string]

Password for AWS resource

Required

instance=[string]

AWS EC2 instance

Required

parameterGroup=[string]

AWS DB container for engine configuration

Required

status=[string]

Status of the replay. Must be ‘SCHEDULED’, ‘STARTED’, or ‘STARTING’

Optional

start=[date]

Time that the replay actually started

Optional

scheduledStart=[date]

Time that the replay is scheduled for

Optional

Sample Request Body

{
 "name" : "myReplay",
      "captureId" : "1",
      "dbName" : "myDB",
      "host" : "xxxxx.xxxxx.us-east-2.rds.amazonaws.com",
      "user" : "user",
      "pass" : "pass",
      "parameterGroup" : "paramGroup",      "instance" : "XXXXX",
 "start" : "2018-05-19 12:00:00",
 "scheduledStart": null
}

Success Response

200 OK

Error Response

400 BAD REQUEST
{
    "code": 400,
    "message": "Replay's capture does not exist"
}
{
    "code": 400,
    "message": "Cannot schedule without a schedule start time"
}
{
    "code": 400,
    "message": "Replay with the same name already exists for this capture"
}

Delete a Replay

Deletes a specific replay associated with an environment and capture.

DELETE /api/replays/{id}

Permissions

User must be logged in. User must either be an owner of the replay or be an admin of the environment.

Query Params

Param

Description

Optional/Required

id=[number]

id of the replay to delete

Required

Success Response

200 OK

Error Response

400 BAD REQUEST
{
    "code": 400,
    "message": "Replay's capture does not exist"
}
401 UNAUTHORIZED
{
    "code": 401,
    "message": "Admin login required"
}
404 NOT FOUND
{
    "code": 404,
    "message": "Replay not found"
}

Last updated