AWS CLI Command Reference

[ aws . resiliencehubv2 ]

get-test-run

Description

Retrieves a test run by ID, including its status, results, and the configuration snapshotted when the run started.

See also: AWS API Documentation

Synopsis

  get-test-run
--test-run-id <value>
--service-arn <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]
[--cli-error-format <value>]

Options

--test-run-id (string) [required]

The identifier of the test run to retrieve.

--service-arn (string) [required]

The ARN of the service the test run belongs to.

Constraints:

  • min: 31
  • pattern: arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}

--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command. The generated JSON skeleton is not stable between versions of the AWS CLI and there are no backwards compatibility guarantees in the JSON skeleton generated.

Global Options

--debug (boolean)

Turn on debug logging.

--endpoint-url (string)

Override command’s default URL with the given URL.

--no-verify-ssl (boolean)

By default, the AWS CLI uses SSL when communicating with AWS services. For each SSL connection, the AWS CLI will verify SSL certificates. This option overrides the default behavior of verifying SSL certificates.

--no-paginate (boolean)

Disable automatic pagination. If automatic pagination is disabled, the AWS CLI will only make one call, for the first page of results.

--output (string)

The formatting style for command output.

  • json
  • text
  • table
  • yaml
  • yaml-stream
  • off

--query (string)

A JMESPath query to use in filtering the response data.

--profile (string)

Use a specific profile from your credential file.

--region (string)

The region to use. Overrides config/env settings.

--version (string)

Display the version of this tool.

--color (string)

Turn on/off color output.

  • on
  • off
  • auto

--no-sign-request (boolean)

Do not sign requests. Credentials will not be loaded if this argument is provided.

--ca-bundle (string)

The CA certificate bundle to use when verifying SSL certificates. Overrides config/env settings.

--cli-read-timeout (int)

The maximum socket read time in seconds. If the value is set to 0, the socket read will be blocking and not timeout. The default value is 60 seconds.

--cli-connect-timeout (int)

The maximum socket connect time in seconds. If the value is set to 0, the socket connect will be blocking and not timeout. The default value is 60 seconds.

--cli-binary-format (string)

The formatting style to be used for binary blobs. The default format is base64. The base64 format expects binary blobs to be provided as a base64 encoded string. The raw-in-base64-out format preserves compatibility with AWS CLI V1 behavior and binary values must be passed literally. When providing contents from a file that map to a binary blob fileb:// will always be treated as binary and use the file contents directly regardless of the cli-binary-format setting. When using file:// the file contents will need to properly formatted for the configured cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (boolean)

Disable cli pager for output.

--cli-auto-prompt (boolean)

Automatically prompt for CLI input parameters.

--no-cli-auto-prompt (boolean)

Disable automatically prompt for CLI input parameters.

--cli-error-format (string)

The formatting style for error output. By default, errors are displayed in enhanced format.

  • legacy
  • json
  • yaml
  • text
  • table
  • enhanced

Output

testRun -> (structure)

The requested test run.

testRunId -> (string) [required]

The unique identifier of the test run.

testId -> (string) [required]

The identifier of the test that was run.

status -> (string) [required]

The current status of the test run.

Possible values:

  • INITIALIZING
  • RUNNING
  • STOPPING
  • PASSED
  • FAILED
  • STOPPED
  • ERROR

serviceArn -> (string)

The ARN of the service the test run belongs to.

Constraints:

  • min: 31
  • pattern: arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}

startedAt -> (timestamp) [required]

The timestamp when the test run started.

endedAt -> (timestamp)

The timestamp when the test run ended.

experiments -> (list)

The AWS Fault Injection Service (AWS FIS) experiments run as part of the test run.

(structure)

Details about an AWS Fault Injection Service (AWS FIS) experiment run as part of a test run.

experimentArn -> (string) [required]

The ARN of the AWS FIS experiment.

Constraints:

  • min: 31
  • pattern: arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}

details -> (string)

Additional details about the experiment.

eventCount -> (integer)

The number of events recorded for the test run. Use ListTestRunEvents to retrieve the details.

parameters -> (map)

The parameter values used for the test run.

Constraints:

  • min: 0
  • max: 20

key -> (string)

The key of a test parameter.

Constraints:

  • min: 1
  • max: 256
  • pattern: [\w.-]+

value -> (list)

Constraints:

  • min: 0
  • max: 10

(string)

A value of a test parameter.

Constraints:

  • min: 0
  • max: 1024

errorMessage -> (string)

A human-readable reason for test run failure. Only present when the status is FAILED or ERROR.

stopConditions -> (list)

The stop conditions snapshotted from the test when the run was started.

(structure)

A CloudWatch alarm that automatically stops a test run if it breaches its threshold.

source -> (string) [required]

The source of the stop condition.

Possible values:

  • aws:cloudwatch:alarm
  • none

value -> (string) [required]

The value of the stop condition, such as the ARN of the CloudWatch alarm.

loggingConfiguration -> (structure)

The logging configuration snapshotted from the test when the run was started.

s3BucketName -> (string)

The name of the S3 bucket for log delivery.

cloudWatchLogGroupArn -> (string)

The ARN of the CloudWatch Logs log group for log delivery.

Constraints:

  • min: 31
  • pattern: arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}

logSchemaVersion -> (string)

The version of the log schema.

roleName -> (string)

The IAM execution role name snapshotted from the test when the run was started.

Constraints:

  • min: 2
  • max: 60
  • pattern: [A-Za-z0-9][A-Za-z0-9_\-]{1,59}

testTemplateArn -> (string) [required]

The ARN of the test template snapshotted from the test when the run was started.

Constraints:

  • min: 31
  • pattern: arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):([0-9]{12}|aws):[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}

reportConfiguration -> (structure)

The report configuration snapshotted from the service when the run was started.

reportOutput -> (list) [required]

The output destinations for generated reports.

Constraints:

  • min: 1
  • max: 1

(tagged union structure)

Configuration for a report output destination.

Note

This is a Tagged Union structure. Only one of the following top level keys can be set: s3.

s3 -> (structure)

S3 configuration for report output.

bucketPath -> (string) [required]

S3 bucket path where reports will be written (e.g., my-bucket/ngrh-reports/).

Constraints:

  • min: 3
  • max: 512
  • pattern: (s3://)?[a-z0-9][a-z0-9.-]{1,61}[a-z0-9](/.*)?

bucketOwner -> (string) [required]

Account ID of the bucket owner for cross-account access verification.

Constraints:

  • min: 12
  • max: 12
  • pattern: \d{12}

policy -> (structure)

The resilience policy snapshotted from the service when the run was started.

policyArn -> (string)

The ARN of the policy.

Constraints:

  • min: 31
  • pattern: arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}

name -> (string)

The name of the policy.

Constraints:

  • min: 2
  • max: 60
  • pattern: [A-Za-z0-9][A-Za-z0-9_\-]{1,59}

availabilitySlo -> (structure)

The availability SLO targets.

target -> (double)

The target availability percentage, expressed as a value between 0 and 100.

Constraints:

  • min: 0
  • max: 100

multiAz -> (structure)

The multi-AZ resilience targets.

rtoInMinutes -> (integer)

The recovery time objective (RTO) target for multi-AZ, in minutes.

Constraints:

  • min: 0

rpoInMinutes -> (integer)

The recovery point objective (RPO) target for multi-AZ, in minutes.

Constraints:

  • min: 0

disasterRecoveryApproach -> (string)

The disaster recovery approach for multi-AZ.

Possible values:

  • ACTIVE_ACTIVE
  • HOT_STANDBY
  • WARM_STANDBY
  • PILOT_LIGHT
  • BACKUP_AND_RESTORE

multiRegion -> (structure)

The multi-Region resilience targets.

rtoInMinutes -> (integer)

The recovery time objective (RTO) target for multi-Region, in minutes.

Constraints:

  • min: 0

rpoInMinutes -> (integer)

The recovery point objective (RPO) target for multi-Region, in minutes.

Constraints:

  • min: 0

disasterRecoveryApproach -> (string)

The disaster recovery approach for multi-Region.

Possible values:

  • ACTIVE_ACTIVE
  • HOT_STANDBY
  • WARM_STANDBY
  • PILOT_LIGHT
  • BACKUP_AND_RESTORE

dataRecovery -> (structure)

The data recovery targets.

timeBetweenBackupsInMinutes -> (integer)

The target time between backups, in minutes.

Constraints:

  • min: 0

reportOutput -> (structure)

The report generation result for the test run. Present after report generation completes or fails.

reportType -> (string) [required]

The type of the generated report.

Possible values:

  • FAILURE_MODE
  • TESTING

status -> (string) [required]

The status of the report generation.

Possible values:

  • PENDING
  • SUCCEEDED
  • FAILED

serviceArn -> (string)

The service this report was generated for.

Constraints:

  • min: 31
  • pattern: arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}

assessmentId -> (string)

Present for FAILURE_MODE reports.

Constraints:

  • min: 36
  • max: 36
  • pattern: [0-9a-f]{8}-[0-9a-f]{4}-[0-5][0-9a-f]{3}-[089ab][0-9a-f]{3}-[0-9a-f]{12}

testRunId -> (string)

The unique identifier of a test run.

testTemplateArn -> (string)

An ARN owned by the service. Accepts either a standard 12-digit account ID or the literal “aws” for AWS-managed resources, such as AWS-managed test templates.

Constraints:

  • min: 31
  • pattern: arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):([0-9]{12}|aws):[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}

createdAt -> (timestamp)

The timestamp when the report was created.

reportOutput -> (tagged union structure)

Present when status is SUCCEEDED or FAILED.

Note

This is a Tagged Union structure. Only one of the following top level keys can be set: s3ReportOutput, failedReportOutput.

s3ReportOutput -> (structure)

The S3 location where the report was written.

s3ObjectKey -> (string) [required]

The S3 object key for the generated report.

failedReportOutput -> (structure)

Details when report generation failed.

errorCode -> (string) [required]

The error code describing why the report generation failed.

Possible values:

  • INSUFFICIENT_PERMISSIONS
  • CONFIGURATION_ERROR
  • INTERNAL_ERROR

errorMessage -> (string)

The error message describing why the report generation failed.

regionSwitchPlanArn -> (string)

The ARN of the ARC Region switch plan associated with the test run.

Constraints:

  • min: 31
  • pattern: arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}

regionSwitchExecutionId -> (string)

The identifier of the ARC Region switch execution detected during the test run.

Constraints:

  • min: 1
  • max: 64
  • pattern: [a-z]{2}(-[a-z]+)+-[0-9]+/[0-9a-fA-F]{16}

permissionModel -> (structure)

The permission model snapshotted from the service when the run was started.

invokerRoleName -> (string) [required]

IAM role name (supports up to 64 characters per IAM limits).

Constraints:

  • min: 1
  • max: 576
  • pattern: ([A-Za-z0-9_+=,.@\-]+/)*[A-Za-z0-9_+=,.@\-]+

crossAccountRoles -> (list)

The list of cross-account IAM role ARNs.

Constraints:

  • min: 0
  • max: 5

(structure)

Specifies a cross-account IAM role ARN and optional external ID.

crossAccountRoleArn -> (string) [required]

ARN of the IAM Role for the profile. Null if the permission profile is the ‘Admin’ profile.

Constraints:

  • min: 32
  • pattern: arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):iam::[0-9]{12}:role/(([^/][!-~]+/){1,511})?[A-Za-z0-9_+=,.@-]{1,64}

externalId -> (string)

The external ID used for assuming the cross-account role.

Constraints:

  • min: 2
  • max: 1224

regions -> (list)

The Regions snapshotted from the service when the run was started.

Constraints:

  • min: 1
  • max: 5

(string)

Constraints:

  • min: 6
  • pattern: [a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]

accountTargeting -> (string)

Indicates whether this test run targets a single account or multiple accounts.

Possible values:

  • SINGLE_ACCOUNT
  • MULTI_ACCOUNT
© Copyright 2026, Amazon Web Services. Created using Sphinx.