CmdID

CmdID / aws / aws fis

aws fis start-experiment

Starts running an experiment from the specified experiment template. AWS CLI reference

1 example 4 options Its page in the AWS CLI reference

Opens CmdID with your command. It is read in your browser and sent nowhere.

Examples

from aws-cli, each command read by CmdID

To start an experiment

The following start-experiment example starts the specified experiment.

aws fis start-experiment --experiment-template-id ABCDE1fgHIJkLmNopIdentify
--experiment-template-idThe ID of the experiment template.
Its output, shortened
{
    "experiment": {
        "id": "ABC12DeFGhI3jKLMNOP",
        "experimentTemplateId": "ABCDE1fgHIJkLmNop",
        "roleArn": "arn:aws:iam::123456789012:role/myRole",
        "state": {
            "status": "initiating",
            "reason": "Experiment is initiating."
        },
        "targets": {
            "Instances-Target-1": {
                "resourceType": "aws:ec2:instance",
                "resourceArns": [
                    "arn:aws:ec2:us-west-2:123456789012:instance/i-12a3b4c56d78e9012"
                ],
                "selectionMode": "ALL"
            }
        },
        "actions": {
            "reboot": {
                "actionId": "aws:ec2:reboot-instances",
                "parameters": {},
                "targets": {
                    "Instances": "Instances-Target-1"
                },
                "state": {
                    "status": "pending",
                    "reason": "Initial state"
                }
            }
… 11 more lines

For more information, see Experiments for AWS FIS in the AWS Fault Injection Simulator User Guide.

Options

4 in the AWS CLI reference
--client-tokenUnique, case-sensitive identifier that you provide to ensure the idempotency of the request.
--experiment-optionsThe experiment options for running the experiment.
--experiment-template-idThe ID of the experiment template.
--tagsThe tags to apply to the experiment.