AWS Fault Injection Simulator 2020-12-01
- Client: Aws\FIS\FISClient
- Service ID: fis
- Version: 2020-12-01
This page describes the parameters and results for the operations of the AWS Fault Injection Simulator (2020-12-01), and shows how to use the Aws\FIS\FISClient object to call the described operations. This documentation is specific to the 2020-12-01 API version of the service.
Operation Summary
Each of the following operations can be created from a client using
$client->getCommand('CommandName')
, where "CommandName" is the
name of one of the following operations. Note: a command is a value that
encapsulates an operation and the parameters used to create an HTTP request.
You can also create and send a command immediately using the magic methods
available on a client object: $client->commandName(/* parameters */)
.
You can send the command asynchronously (returning a promise) by appending the
word "Async" to the operation name: $client->commandNameAsync(/* parameters */)
.
- CreateExperimentTemplate ( array $params = [] )
- Creates an experiment template.
- CreateTargetAccountConfiguration ( array $params = [] )
- Creates a target account configuration for the experiment template.
- DeleteExperimentTemplate ( array $params = [] )
- Deletes the specified experiment template.
- DeleteTargetAccountConfiguration ( array $params = [] )
- Deletes the specified target account configuration of the experiment template.
- GetAction ( array $params = [] )
- Gets information about the specified FIS action.
- GetExperiment ( array $params = [] )
- Gets information about the specified experiment.
- GetExperimentTargetAccountConfiguration ( array $params = [] )
- Gets information about the specified target account configuration of the experiment.
- GetExperimentTemplate ( array $params = [] )
- Gets information about the specified experiment template.
- GetTargetAccountConfiguration ( array $params = [] )
- Gets information about the specified target account configuration of the experiment template.
- GetTargetResourceType ( array $params = [] )
- Gets information about the specified resource type.
- ListActions ( array $params = [] )
- Lists the available FIS actions.
- ListExperimentResolvedTargets ( array $params = [] )
- Lists the resolved targets information of the specified experiment.
- ListExperimentTargetAccountConfigurations ( array $params = [] )
- Lists the target account configurations of the specified experiment.
- ListExperimentTemplates ( array $params = [] )
- Lists your experiment templates.
- ListExperiments ( array $params = [] )
- Lists your experiments.
- ListTagsForResource ( array $params = [] )
- Lists the tags for the specified resource.
- ListTargetAccountConfigurations ( array $params = [] )
- Lists the target account configurations of the specified experiment template.
- ListTargetResourceTypes ( array $params = [] )
- Lists the target resource types.
- StartExperiment ( array $params = [] )
- Starts running an experiment from the specified experiment template.
- StopExperiment ( array $params = [] )
- Stops the specified experiment.
- TagResource ( array $params = [] )
- Applies the specified tags to the specified resource.
- UntagResource ( array $params = [] )
- Removes the specified tags from the specified resource.
- UpdateExperimentTemplate ( array $params = [] )
- Updates the specified experiment template.
- UpdateTargetAccountConfiguration ( array $params = [] )
- Updates the target account configuration for the specified experiment template.
Paginators
Paginators handle automatically iterating over paginated API results. Paginators are associated with specific API operations, and they accept the parameters that the corresponding API operation accepts. You can get a paginator from a client class using getPaginator($paginatorName, $operationParameters). This client supports the following paginators:
- ListActions
- ListExperimentResolvedTargets
- ListExperimentTemplates
- ListExperiments
- ListTargetAccountConfigurations
- ListTargetResourceTypes
Operations
CreateExperimentTemplate
$result = $client->createExperimentTemplate
([/* ... */]); $promise = $client->createExperimentTemplateAsync
([/* ... */]);
Creates an experiment template.
An experiment template includes the following components:
-
Targets: A target can be a specific resource in your Amazon Web Services environment, or one or more resources that match criteria that you specify, for example, resources that have specific tags.
-
Actions: The actions to carry out on the target. You can specify multiple actions, the duration of each action, and when to start each action during an experiment.
-
Stop conditions: If a stop condition is triggered while an experiment is running, the experiment is automatically stopped. You can define a stop condition as a CloudWatch alarm.
For more information, see experiment templates in the Fault Injection Service User Guide.
Parameter Syntax
$result = $client->createExperimentTemplate([ 'actions' => [ // REQUIRED '<ExperimentTemplateActionName>' => [ 'actionId' => '<string>', // REQUIRED 'description' => '<string>', 'parameters' => ['<string>', ...], 'startAfter' => ['<string>', ...], 'targets' => ['<string>', ...], ], // ... ], 'clientToken' => '<string>', // REQUIRED 'description' => '<string>', // REQUIRED 'experimentOptions' => [ 'accountTargeting' => 'single-account|multi-account', 'emptyTargetResolutionMode' => 'fail|skip', ], 'logConfiguration' => [ 'cloudWatchLogsConfiguration' => [ 'logGroupArn' => '<string>', // REQUIRED ], 'logSchemaVersion' => <integer>, // REQUIRED 's3Configuration' => [ 'bucketName' => '<string>', // REQUIRED 'prefix' => '<string>', ], ], 'roleArn' => '<string>', // REQUIRED 'stopConditions' => [ // REQUIRED [ 'source' => '<string>', // REQUIRED 'value' => '<string>', ], // ... ], 'tags' => ['<string>', ...], 'targets' => [ '<ExperimentTemplateTargetName>' => [ 'filters' => [ [ 'path' => '<string>', // REQUIRED 'values' => ['<string>', ...], // REQUIRED ], // ... ], 'parameters' => ['<string>', ...], 'resourceArns' => ['<string>', ...], 'resourceTags' => ['<string>', ...], 'resourceType' => '<string>', // REQUIRED 'selectionMode' => '<string>', // REQUIRED ], // ... ], ]);
Parameter Details
Members
- actions
-
- Required: Yes
- Type: Associative array of custom strings keys (ExperimentTemplateActionName) to CreateExperimentTemplateActionInput structures
The actions for the experiment.
- clientToken
-
- Required: Yes
- Type: string
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
- description
-
- Required: Yes
- Type: string
A description for the experiment template.
- experimentOptions
-
- Type: CreateExperimentTemplateExperimentOptionsInput structure
The experiment options for the experiment template.
- logConfiguration
-
- Type: CreateExperimentTemplateLogConfigurationInput structure
The configuration for experiment logging.
- roleArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of an IAM role that grants the FIS service permission to perform service actions on your behalf.
- stopConditions
-
- Required: Yes
- Type: Array of CreateExperimentTemplateStopConditionInput structures
The stop conditions.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags to apply to the experiment template.
- targets
-
- Type: Associative array of custom strings keys (ExperimentTemplateTargetName) to CreateExperimentTemplateTargetInput structures
The targets for the experiment.
Result Syntax
[ 'experimentTemplate' => [ 'actions' => [ '<ExperimentTemplateActionName>' => [ 'actionId' => '<string>', 'description' => '<string>', 'parameters' => ['<string>', ...], 'startAfter' => ['<string>', ...], 'targets' => ['<string>', ...], ], // ... ], 'arn' => '<string>', 'creationTime' => <DateTime>, 'description' => '<string>', 'experimentOptions' => [ 'accountTargeting' => 'single-account|multi-account', 'emptyTargetResolutionMode' => 'fail|skip', ], 'id' => '<string>', 'lastUpdateTime' => <DateTime>, 'logConfiguration' => [ 'cloudWatchLogsConfiguration' => [ 'logGroupArn' => '<string>', ], 'logSchemaVersion' => <integer>, 's3Configuration' => [ 'bucketName' => '<string>', 'prefix' => '<string>', ], ], 'roleArn' => '<string>', 'stopConditions' => [ [ 'source' => '<string>', 'value' => '<string>', ], // ... ], 'tags' => ['<string>', ...], 'targetAccountConfigurationsCount' => <integer>, 'targets' => [ '<ExperimentTemplateTargetName>' => [ 'filters' => [ [ 'path' => '<string>', 'values' => ['<string>', ...], ], // ... ], 'parameters' => ['<string>', ...], 'resourceArns' => ['<string>', ...], 'resourceTags' => ['<string>', ...], 'resourceType' => '<string>', 'selectionMode' => '<string>', ], // ... ], ], ]
Result Details
Members
- experimentTemplate
-
- Type: ExperimentTemplate structure
Information about the experiment template.
Errors
- ValidationException:
The specified input is not valid, or fails to satisfy the constraints for the request.
- ConflictException:
The request could not be processed because of a conflict.
- ResourceNotFoundException:
The specified resource cannot be found.
- ServiceQuotaExceededException:
You have exceeded your service quota.
CreateTargetAccountConfiguration
$result = $client->createTargetAccountConfiguration
([/* ... */]); $promise = $client->createTargetAccountConfigurationAsync
([/* ... */]);
Creates a target account configuration for the experiment template. A target account configuration is required when accountTargeting
of experimentOptions
is set to multi-account
. For more information, see experiment options in the Fault Injection Service User Guide.
Parameter Syntax
$result = $client->createTargetAccountConfiguration([ 'accountId' => '<string>', // REQUIRED 'clientToken' => '<string>', 'description' => '<string>', 'experimentTemplateId' => '<string>', // REQUIRED 'roleArn' => '<string>', // REQUIRED ]);
Parameter Details
Members
- accountId
-
- Required: Yes
- Type: string
The Amazon Web Services account ID of the target account.
- clientToken
-
- Type: string
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
- description
-
- Type: string
The description of the target account.
- experimentTemplateId
-
- Required: Yes
- Type: string
The experiment template ID.
- roleArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of an IAM role for the target account.
Result Syntax
[ 'targetAccountConfiguration' => [ 'accountId' => '<string>', 'description' => '<string>', 'roleArn' => '<string>', ], ]
Result Details
Members
- targetAccountConfiguration
-
- Type: TargetAccountConfiguration structure
Information about the target account configuration.
Errors
- ValidationException:
The specified input is not valid, or fails to satisfy the constraints for the request.
- ConflictException:
The request could not be processed because of a conflict.
- ResourceNotFoundException:
The specified resource cannot be found.
- ServiceQuotaExceededException:
You have exceeded your service quota.
DeleteExperimentTemplate
$result = $client->deleteExperimentTemplate
([/* ... */]); $promise = $client->deleteExperimentTemplateAsync
([/* ... */]);
Deletes the specified experiment template.
Parameter Syntax
$result = $client->deleteExperimentTemplate([ 'id' => '<string>', // REQUIRED ]);
Parameter Details
Members
- id
-
- Required: Yes
- Type: string
The ID of the experiment template.
Result Syntax
[ 'experimentTemplate' => [ 'actions' => [ '<ExperimentTemplateActionName>' => [ 'actionId' => '<string>', 'description' => '<string>', 'parameters' => ['<string>', ...], 'startAfter' => ['<string>', ...], 'targets' => ['<string>', ...], ], // ... ], 'arn' => '<string>', 'creationTime' => <DateTime>, 'description' => '<string>', 'experimentOptions' => [ 'accountTargeting' => 'single-account|multi-account', 'emptyTargetResolutionMode' => 'fail|skip', ], 'id' => '<string>', 'lastUpdateTime' => <DateTime>, 'logConfiguration' => [ 'cloudWatchLogsConfiguration' => [ 'logGroupArn' => '<string>', ], 'logSchemaVersion' => <integer>, 's3Configuration' => [ 'bucketName' => '<string>', 'prefix' => '<string>', ], ], 'roleArn' => '<string>', 'stopConditions' => [ [ 'source' => '<string>', 'value' => '<string>', ], // ... ], 'tags' => ['<string>', ...], 'targetAccountConfigurationsCount' => <integer>, 'targets' => [ '<ExperimentTemplateTargetName>' => [ 'filters' => [ [ 'path' => '<string>', 'values' => ['<string>', ...], ], // ... ], 'parameters' => ['<string>', ...], 'resourceArns' => ['<string>', ...], 'resourceTags' => ['<string>', ...], 'resourceType' => '<string>', 'selectionMode' => '<string>', ], // ... ], ], ]
Result Details
Members
- experimentTemplate
-
- Type: ExperimentTemplate structure
Information about the experiment template.
Errors
- ValidationException:
The specified input is not valid, or fails to satisfy the constraints for the request.
- ResourceNotFoundException:
The specified resource cannot be found.
DeleteTargetAccountConfiguration
$result = $client->deleteTargetAccountConfiguration
([/* ... */]); $promise = $client->deleteTargetAccountConfigurationAsync
([/* ... */]);
Deletes the specified target account configuration of the experiment template.
Parameter Syntax
$result = $client->deleteTargetAccountConfiguration([ 'accountId' => '<string>', // REQUIRED 'experimentTemplateId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- accountId
-
- Required: Yes
- Type: string
The Amazon Web Services account ID of the target account.
- experimentTemplateId
-
- Required: Yes
- Type: string
The ID of the experiment template.
Result Syntax
[ 'targetAccountConfiguration' => [ 'accountId' => '<string>', 'description' => '<string>', 'roleArn' => '<string>', ], ]
Result Details
Members
- targetAccountConfiguration
-
- Type: TargetAccountConfiguration structure
Information about the target account configuration.
Errors
- ValidationException:
The specified input is not valid, or fails to satisfy the constraints for the request.
- ResourceNotFoundException:
The specified resource cannot be found.
GetAction
$result = $client->getAction
([/* ... */]); $promise = $client->getActionAsync
([/* ... */]);
Gets information about the specified FIS action.
Parameter Syntax
$result = $client->getAction([ 'id' => '<string>', // REQUIRED ]);
Parameter Details
Members
- id
-
- Required: Yes
- Type: string
The ID of the action.
Result Syntax
[ 'action' => [ 'arn' => '<string>', 'description' => '<string>', 'id' => '<string>', 'parameters' => [ '<ActionParameterName>' => [ 'description' => '<string>', 'required' => true || false, ], // ... ], 'tags' => ['<string>', ...], 'targets' => [ '<ActionTargetName>' => [ 'resourceType' => '<string>', ], // ... ], ], ]
Result Details
Members
- action
-
- Type: Action structure
Information about the action.
Errors
- ValidationException:
The specified input is not valid, or fails to satisfy the constraints for the request.
- ResourceNotFoundException:
The specified resource cannot be found.
GetExperiment
$result = $client->getExperiment
([/* ... */]); $promise = $client->getExperimentAsync
([/* ... */]);
Gets information about the specified experiment.
Parameter Syntax
$result = $client->getExperiment([ 'id' => '<string>', // REQUIRED ]);
Parameter Details
Members
- id
-
- Required: Yes
- Type: string
The ID of the experiment.
Result Syntax
[ 'experiment' => [ 'actions' => [ '<ExperimentActionName>' => [ 'actionId' => '<string>', 'description' => '<string>', 'endTime' => <DateTime>, 'parameters' => ['<string>', ...], 'startAfter' => ['<string>', ...], 'startTime' => <DateTime>, 'state' => [ 'reason' => '<string>', 'status' => 'pending|initiating|running|completed|cancelled|stopping|stopped|failed|skipped', ], 'targets' => ['<string>', ...], ], // ... ], 'arn' => '<string>', 'creationTime' => <DateTime>, 'endTime' => <DateTime>, 'experimentOptions' => [ 'accountTargeting' => 'single-account|multi-account', 'actionsMode' => 'skip-all|run-all', 'emptyTargetResolutionMode' => 'fail|skip', ], 'experimentTemplateId' => '<string>', 'id' => '<string>', 'logConfiguration' => [ 'cloudWatchLogsConfiguration' => [ 'logGroupArn' => '<string>', ], 'logSchemaVersion' => <integer>, 's3Configuration' => [ 'bucketName' => '<string>', 'prefix' => '<string>', ], ], 'roleArn' => '<string>', 'startTime' => <DateTime>, 'state' => [ 'error' => [ 'accountId' => '<string>', 'code' => '<string>', 'location' => '<string>', ], 'reason' => '<string>', 'status' => 'pending|initiating|running|completed|stopping|stopped|failed', ], 'stopConditions' => [ [ 'source' => '<string>', 'value' => '<string>', ], // ... ], 'tags' => ['<string>', ...], 'targetAccountConfigurationsCount' => <integer>, 'targets' => [ '<ExperimentTargetName>' => [ 'filters' => [ [ 'path' => '<string>', 'values' => ['<string>', ...], ], // ... ], 'parameters' => ['<string>', ...], 'resourceArns' => ['<string>', ...], 'resourceTags' => ['<string>', ...], 'resourceType' => '<string>', 'selectionMode' => '<string>', ], // ... ], ], ]
Result Details
Members
- experiment
-
- Type: Experiment structure
Information about the experiment.
Errors
- ValidationException:
The specified input is not valid, or fails to satisfy the constraints for the request.
- ResourceNotFoundException:
The specified resource cannot be found.
GetExperimentTargetAccountConfiguration
$result = $client->getExperimentTargetAccountConfiguration
([/* ... */]); $promise = $client->getExperimentTargetAccountConfigurationAsync
([/* ... */]);
Gets information about the specified target account configuration of the experiment.
Parameter Syntax
$result = $client->getExperimentTargetAccountConfiguration([ 'accountId' => '<string>', // REQUIRED 'experimentId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- accountId
-
- Required: Yes
- Type: string
The Amazon Web Services account ID of the target account.
- experimentId
-
- Required: Yes
- Type: string
The ID of the experiment.
Result Syntax
[ 'targetAccountConfiguration' => [ 'accountId' => '<string>', 'description' => '<string>', 'roleArn' => '<string>', ], ]
Result Details
Members
- targetAccountConfiguration
-
- Type: ExperimentTargetAccountConfiguration structure
Information about the target account configuration.
Errors
- ResourceNotFoundException:
The specified resource cannot be found.
- ValidationException:
The specified input is not valid, or fails to satisfy the constraints for the request.
GetExperimentTemplate
$result = $client->getExperimentTemplate
([/* ... */]); $promise = $client->getExperimentTemplateAsync
([/* ... */]);
Gets information about the specified experiment template.
Parameter Syntax
$result = $client->getExperimentTemplate([ 'id' => '<string>', // REQUIRED ]);
Parameter Details
Members
- id
-
- Required: Yes
- Type: string
The ID of the experiment template.
Result Syntax
[ 'experimentTemplate' => [ 'actions' => [ '<ExperimentTemplateActionName>' => [ 'actionId' => '<string>', 'description' => '<string>', 'parameters' => ['<string>', ...], 'startAfter' => ['<string>', ...], 'targets' => ['<string>', ...], ], // ... ], 'arn' => '<string>', 'creationTime' => <DateTime>, 'description' => '<string>', 'experimentOptions' => [ 'accountTargeting' => 'single-account|multi-account', 'emptyTargetResolutionMode' => 'fail|skip', ], 'id' => '<string>', 'lastUpdateTime' => <DateTime>, 'logConfiguration' => [ 'cloudWatchLogsConfiguration' => [ 'logGroupArn' => '<string>', ], 'logSchemaVersion' => <integer>, 's3Configuration' => [ 'bucketName' => '<string>', 'prefix' => '<string>', ], ], 'roleArn' => '<string>', 'stopConditions' => [ [ 'source' => '<string>', 'value' => '<string>', ], // ... ], 'tags' => ['<string>', ...], 'targetAccountConfigurationsCount' => <integer>, 'targets' => [ '<ExperimentTemplateTargetName>' => [ 'filters' => [ [ 'path' => '<string>', 'values' => ['<string>', ...], ], // ... ], 'parameters' => ['<string>', ...], 'resourceArns' => ['<string>', ...], 'resourceTags' => ['<string>', ...], 'resourceType' => '<string>', 'selectionMode' => '<string>', ], // ... ], ], ]
Result Details
Members
- experimentTemplate
-
- Type: ExperimentTemplate structure
Information about the experiment template.
Errors
- ValidationException:
The specified input is not valid, or fails to satisfy the constraints for the request.
- ResourceNotFoundException:
The specified resource cannot be found.
GetTargetAccountConfiguration
$result = $client->getTargetAccountConfiguration
([/* ... */]); $promise = $client->getTargetAccountConfigurationAsync
([/* ... */]);
Gets information about the specified target account configuration of the experiment template.
Parameter Syntax
$result = $client->getTargetAccountConfiguration([ 'accountId' => '<string>', // REQUIRED 'experimentTemplateId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- accountId
-
- Required: Yes
- Type: string
The Amazon Web Services account ID of the target account.
- experimentTemplateId
-
- Required: Yes
- Type: string
The ID of the experiment template.
Result Syntax
[ 'targetAccountConfiguration' => [ 'accountId' => '<string>', 'description' => '<string>', 'roleArn' => '<string>', ], ]
Result Details
Members
- targetAccountConfiguration
-
- Type: TargetAccountConfiguration structure
Information about the target account configuration.
Errors
- ResourceNotFoundException:
The specified resource cannot be found.
- ValidationException:
The specified input is not valid, or fails to satisfy the constraints for the request.
GetTargetResourceType
$result = $client->getTargetResourceType
([/* ... */]); $promise = $client->getTargetResourceTypeAsync
([/* ... */]);
Gets information about the specified resource type.
Parameter Syntax
$result = $client->getTargetResourceType([ 'resourceType' => '<string>', // REQUIRED ]);
Parameter Details
Members
- resourceType
-
- Required: Yes
- Type: string
The resource type.
Result Syntax
[ 'targetResourceType' => [ 'description' => '<string>', 'parameters' => [ '<TargetResourceTypeParameterName>' => [ 'description' => '<string>', 'required' => true || false, ], // ... ], 'resourceType' => '<string>', ], ]
Result Details
Members
- targetResourceType
-
- Type: TargetResourceType structure
Information about the resource type.
Errors
- ValidationException:
The specified input is not valid, or fails to satisfy the constraints for the request.
- ResourceNotFoundException:
The specified resource cannot be found.
ListActions
$result = $client->listActions
([/* ... */]); $promise = $client->listActionsAsync
([/* ... */]);
Lists the available FIS actions.
Parameter Syntax
$result = $client->listActions([ 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- maxResults
-
- Type: int
The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned
nextToken
value. - nextToken
-
- Type: string
The token for the next page of results.
Result Syntax
[ 'actions' => [ [ 'arn' => '<string>', 'description' => '<string>', 'id' => '<string>', 'tags' => ['<string>', ...], 'targets' => [ '<ActionTargetName>' => [ 'resourceType' => '<string>', ], // ... ], ], // ... ], 'nextToken' => '<string>', ]
Result Details
Members
- actions
-
- Type: Array of ActionSummary structures
The actions.
- nextToken
-
- Type: string
The token to use to retrieve the next page of results. This value is
null
when there are no more results to return.
Errors
- ValidationException:
The specified input is not valid, or fails to satisfy the constraints for the request.
ListExperimentResolvedTargets
$result = $client->listExperimentResolvedTargets
([/* ... */]); $promise = $client->listExperimentResolvedTargetsAsync
([/* ... */]);
Lists the resolved targets information of the specified experiment.
Parameter Syntax
$result = $client->listExperimentResolvedTargets([ 'experimentId' => '<string>', // REQUIRED 'maxResults' => <integer>, 'nextToken' => '<string>', 'targetName' => '<string>', ]);
Parameter Details
Members
- experimentId
-
- Required: Yes
- Type: string
The ID of the experiment.
- maxResults
-
- Type: int
The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned nextToken value.
- nextToken
-
- Type: string
The token for the next page of results.
- targetName
-
- Type: string
The name of the target.
Result Syntax
[ 'nextToken' => '<string>', 'resolvedTargets' => [ [ 'resourceType' => '<string>', 'targetInformation' => ['<string>', ...], 'targetName' => '<string>', ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: string
The token to use to retrieve the next page of results. This value is null when there are no more results to return.
- resolvedTargets
-
- Type: Array of ResolvedTarget structures
The resolved targets.
Errors
- ValidationException:
The specified input is not valid, or fails to satisfy the constraints for the request.
- ResourceNotFoundException:
The specified resource cannot be found.
ListExperimentTargetAccountConfigurations
$result = $client->listExperimentTargetAccountConfigurations
([/* ... */]); $promise = $client->listExperimentTargetAccountConfigurationsAsync
([/* ... */]);
Lists the target account configurations of the specified experiment.
Parameter Syntax
$result = $client->listExperimentTargetAccountConfigurations([ 'experimentId' => '<string>', // REQUIRED 'nextToken' => '<string>', ]);
Parameter Details
Members
- experimentId
-
- Required: Yes
- Type: string
The ID of the experiment.
- nextToken
-
- Type: string
The token for the next page of results.
Result Syntax
[ 'nextToken' => '<string>', 'targetAccountConfigurations' => [ [ 'accountId' => '<string>', 'description' => '<string>', 'roleArn' => '<string>', ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: string
The token to use to retrieve the next page of results. This value is null when there are no more results to return.
- targetAccountConfigurations
-
- Type: Array of ExperimentTargetAccountConfigurationSummary structures
The target account configurations.
Errors
- ValidationException:
The specified input is not valid, or fails to satisfy the constraints for the request.
- ResourceNotFoundException:
The specified resource cannot be found.
ListExperimentTemplates
$result = $client->listExperimentTemplates
([/* ... */]); $promise = $client->listExperimentTemplatesAsync
([/* ... */]);
Lists your experiment templates.
Parameter Syntax
$result = $client->listExperimentTemplates([ 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- maxResults
-
- Type: int
The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned
nextToken
value. - nextToken
-
- Type: string
The token for the next page of results.
Result Syntax
[ 'experimentTemplates' => [ [ 'arn' => '<string>', 'creationTime' => <DateTime>, 'description' => '<string>', 'id' => '<string>', 'lastUpdateTime' => <DateTime>, 'tags' => ['<string>', ...], ], // ... ], 'nextToken' => '<string>', ]
Result Details
Members
- experimentTemplates
-
- Type: Array of ExperimentTemplateSummary structures
The experiment templates.
- nextToken
-
- Type: string
The token to use to retrieve the next page of results. This value is
null
when there are no more results to return.
Errors
- ValidationException:
The specified input is not valid, or fails to satisfy the constraints for the request.
ListExperiments
$result = $client->listExperiments
([/* ... */]); $promise = $client->listExperimentsAsync
([/* ... */]);
Lists your experiments.
Parameter Syntax
$result = $client->listExperiments([ 'experimentTemplateId' => '<string>', 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- experimentTemplateId
-
- Type: string
The ID of the experiment template.
- maxResults
-
- Type: int
The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned
nextToken
value. - nextToken
-
- Type: string
The token for the next page of results.
Result Syntax
[ 'experiments' => [ [ 'arn' => '<string>', 'creationTime' => <DateTime>, 'experimentOptions' => [ 'accountTargeting' => 'single-account|multi-account', 'actionsMode' => 'skip-all|run-all', 'emptyTargetResolutionMode' => 'fail|skip', ], 'experimentTemplateId' => '<string>', 'id' => '<string>', 'state' => [ 'error' => [ 'accountId' => '<string>', 'code' => '<string>', 'location' => '<string>', ], 'reason' => '<string>', 'status' => 'pending|initiating|running|completed|stopping|stopped|failed', ], 'tags' => ['<string>', ...], ], // ... ], 'nextToken' => '<string>', ]
Result Details
Members
- experiments
-
- Type: Array of ExperimentSummary structures
The experiments.
- nextToken
-
- Type: string
The token to use to retrieve the next page of results. This value is
null
when there are no more results to return.
Errors
- ValidationException:
The specified input is not valid, or fails to satisfy the constraints for the request.
ListTagsForResource
$result = $client->listTagsForResource
([/* ... */]); $promise = $client->listTagsForResourceAsync
([/* ... */]);
Lists the tags for the specified resource.
Parameter Syntax
$result = $client->listTagsForResource([ 'resourceArn' => '<string>', // REQUIRED ]);
Parameter Details
Members
- resourceArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the resource.
Result Syntax
[ 'tags' => ['<string>', ...], ]
Result Details
Members
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags for the resource.
Errors
There are no errors described for this operation.
ListTargetAccountConfigurations
$result = $client->listTargetAccountConfigurations
([/* ... */]); $promise = $client->listTargetAccountConfigurationsAsync
([/* ... */]);
Lists the target account configurations of the specified experiment template.
Parameter Syntax
$result = $client->listTargetAccountConfigurations([ 'experimentTemplateId' => '<string>', // REQUIRED 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- experimentTemplateId
-
- Required: Yes
- Type: string
The ID of the experiment template.
- maxResults
-
- Type: int
The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned nextToken value.
- nextToken
-
- Type: string
The token for the next page of results.
Result Syntax
[ 'nextToken' => '<string>', 'targetAccountConfigurations' => [ [ 'accountId' => '<string>', 'description' => '<string>', 'roleArn' => '<string>', ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: string
The token to use to retrieve the next page of results. This value is null when there are no more results to return.
- targetAccountConfigurations
-
- Type: Array of TargetAccountConfigurationSummary structures
The target account configurations.
Errors
- ValidationException:
The specified input is not valid, or fails to satisfy the constraints for the request.
- ResourceNotFoundException:
The specified resource cannot be found.
ListTargetResourceTypes
$result = $client->listTargetResourceTypes
([/* ... */]); $promise = $client->listTargetResourceTypesAsync
([/* ... */]);
Lists the target resource types.
Parameter Syntax
$result = $client->listTargetResourceTypes([ 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- maxResults
-
- Type: int
The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned
nextToken
value. - nextToken
-
- Type: string
The token for the next page of results.
Result Syntax
[ 'nextToken' => '<string>', 'targetResourceTypes' => [ [ 'description' => '<string>', 'resourceType' => '<string>', ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: string
The token to use to retrieve the next page of results. This value is
null
when there are no more results to return. - targetResourceTypes
-
- Type: Array of TargetResourceTypeSummary structures
The target resource types.
Errors
- ValidationException:
The specified input is not valid, or fails to satisfy the constraints for the request.
StartExperiment
$result = $client->startExperiment
([/* ... */]); $promise = $client->startExperimentAsync
([/* ... */]);
Starts running an experiment from the specified experiment template.
Parameter Syntax
$result = $client->startExperiment([ 'clientToken' => '<string>', // REQUIRED 'experimentOptions' => [ 'actionsMode' => 'skip-all|run-all', ], 'experimentTemplateId' => '<string>', // REQUIRED 'tags' => ['<string>', ...], ]);
Parameter Details
Members
- clientToken
-
- Required: Yes
- Type: string
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
- experimentOptions
-
- Type: StartExperimentExperimentOptionsInput structure
The experiment options for running the experiment.
- experimentTemplateId
-
- Required: Yes
- Type: string
The ID of the experiment template.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags to apply to the experiment.
Result Syntax
[ 'experiment' => [ 'actions' => [ '<ExperimentActionName>' => [ 'actionId' => '<string>', 'description' => '<string>', 'endTime' => <DateTime>, 'parameters' => ['<string>', ...], 'startAfter' => ['<string>', ...], 'startTime' => <DateTime>, 'state' => [ 'reason' => '<string>', 'status' => 'pending|initiating|running|completed|cancelled|stopping|stopped|failed|skipped', ], 'targets' => ['<string>', ...], ], // ... ], 'arn' => '<string>', 'creationTime' => <DateTime>, 'endTime' => <DateTime>, 'experimentOptions' => [ 'accountTargeting' => 'single-account|multi-account', 'actionsMode' => 'skip-all|run-all', 'emptyTargetResolutionMode' => 'fail|skip', ], 'experimentTemplateId' => '<string>', 'id' => '<string>', 'logConfiguration' => [ 'cloudWatchLogsConfiguration' => [ 'logGroupArn' => '<string>', ], 'logSchemaVersion' => <integer>, 's3Configuration' => [ 'bucketName' => '<string>', 'prefix' => '<string>', ], ], 'roleArn' => '<string>', 'startTime' => <DateTime>, 'state' => [ 'error' => [ 'accountId' => '<string>', 'code' => '<string>', 'location' => '<string>', ], 'reason' => '<string>', 'status' => 'pending|initiating|running|completed|stopping|stopped|failed', ], 'stopConditions' => [ [ 'source' => '<string>', 'value' => '<string>', ], // ... ], 'tags' => ['<string>', ...], 'targetAccountConfigurationsCount' => <integer>, 'targets' => [ '<ExperimentTargetName>' => [ 'filters' => [ [ 'path' => '<string>', 'values' => ['<string>', ...], ], // ... ], 'parameters' => ['<string>', ...], 'resourceArns' => ['<string>', ...], 'resourceTags' => ['<string>', ...], 'resourceType' => '<string>', 'selectionMode' => '<string>', ], // ... ], ], ]
Result Details
Members
- experiment
-
- Type: Experiment structure
Information about the experiment.
Errors
- ValidationException:
The specified input is not valid, or fails to satisfy the constraints for the request.
- ConflictException:
The request could not be processed because of a conflict.
- ResourceNotFoundException:
The specified resource cannot be found.
- ServiceQuotaExceededException:
You have exceeded your service quota.
StopExperiment
$result = $client->stopExperiment
([/* ... */]); $promise = $client->stopExperimentAsync
([/* ... */]);
Stops the specified experiment.
Parameter Syntax
$result = $client->stopExperiment([ 'id' => '<string>', // REQUIRED ]);
Parameter Details
Members
- id
-
- Required: Yes
- Type: string
The ID of the experiment.
Result Syntax
[ 'experiment' => [ 'actions' => [ '<ExperimentActionName>' => [ 'actionId' => '<string>', 'description' => '<string>', 'endTime' => <DateTime>, 'parameters' => ['<string>', ...], 'startAfter' => ['<string>', ...], 'startTime' => <DateTime>, 'state' => [ 'reason' => '<string>', 'status' => 'pending|initiating|running|completed|cancelled|stopping|stopped|failed|skipped', ], 'targets' => ['<string>', ...], ], // ... ], 'arn' => '<string>', 'creationTime' => <DateTime>, 'endTime' => <DateTime>, 'experimentOptions' => [ 'accountTargeting' => 'single-account|multi-account', 'actionsMode' => 'skip-all|run-all', 'emptyTargetResolutionMode' => 'fail|skip', ], 'experimentTemplateId' => '<string>', 'id' => '<string>', 'logConfiguration' => [ 'cloudWatchLogsConfiguration' => [ 'logGroupArn' => '<string>', ], 'logSchemaVersion' => <integer>, 's3Configuration' => [ 'bucketName' => '<string>', 'prefix' => '<string>', ], ], 'roleArn' => '<string>', 'startTime' => <DateTime>, 'state' => [ 'error' => [ 'accountId' => '<string>', 'code' => '<string>', 'location' => '<string>', ], 'reason' => '<string>', 'status' => 'pending|initiating|running|completed|stopping|stopped|failed', ], 'stopConditions' => [ [ 'source' => '<string>', 'value' => '<string>', ], // ... ], 'tags' => ['<string>', ...], 'targetAccountConfigurationsCount' => <integer>, 'targets' => [ '<ExperimentTargetName>' => [ 'filters' => [ [ 'path' => '<string>', 'values' => ['<string>', ...], ], // ... ], 'parameters' => ['<string>', ...], 'resourceArns' => ['<string>', ...], 'resourceTags' => ['<string>', ...], 'resourceType' => '<string>', 'selectionMode' => '<string>', ], // ... ], ], ]
Result Details
Members
- experiment
-
- Type: Experiment structure
Information about the experiment.
Errors
- ValidationException:
The specified input is not valid, or fails to satisfy the constraints for the request.
- ResourceNotFoundException:
The specified resource cannot be found.
TagResource
$result = $client->tagResource
([/* ... */]); $promise = $client->tagResourceAsync
([/* ... */]);
Applies the specified tags to the specified resource.
Parameter Syntax
$result = $client->tagResource([ 'resourceArn' => '<string>', // REQUIRED 'tags' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- resourceArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the resource.
- tags
-
- Required: Yes
- Type: Associative array of custom strings keys (TagKey) to strings
The tags for the resource.
Result Syntax
[]
Result Details
Errors
There are no errors described for this operation.
UntagResource
$result = $client->untagResource
([/* ... */]); $promise = $client->untagResourceAsync
([/* ... */]);
Removes the specified tags from the specified resource.
Parameter Syntax
$result = $client->untagResource([ 'resourceArn' => '<string>', // REQUIRED 'tagKeys' => ['<string>', ...], ]);
Parameter Details
Members
- resourceArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the resource.
- tagKeys
-
- Type: Array of strings
The tag keys to remove.
Result Syntax
[]
Result Details
Errors
There are no errors described for this operation.
UpdateExperimentTemplate
$result = $client->updateExperimentTemplate
([/* ... */]); $promise = $client->updateExperimentTemplateAsync
([/* ... */]);
Updates the specified experiment template.
Parameter Syntax
$result = $client->updateExperimentTemplate([ 'actions' => [ '<ExperimentTemplateActionName>' => [ 'actionId' => '<string>', 'description' => '<string>', 'parameters' => ['<string>', ...], 'startAfter' => ['<string>', ...], 'targets' => ['<string>', ...], ], // ... ], 'description' => '<string>', 'experimentOptions' => [ 'emptyTargetResolutionMode' => 'fail|skip', ], 'id' => '<string>', // REQUIRED 'logConfiguration' => [ 'cloudWatchLogsConfiguration' => [ 'logGroupArn' => '<string>', // REQUIRED ], 'logSchemaVersion' => <integer>, 's3Configuration' => [ 'bucketName' => '<string>', // REQUIRED 'prefix' => '<string>', ], ], 'roleArn' => '<string>', 'stopConditions' => [ [ 'source' => '<string>', // REQUIRED 'value' => '<string>', ], // ... ], 'targets' => [ '<ExperimentTemplateTargetName>' => [ 'filters' => [ [ 'path' => '<string>', // REQUIRED 'values' => ['<string>', ...], // REQUIRED ], // ... ], 'parameters' => ['<string>', ...], 'resourceArns' => ['<string>', ...], 'resourceTags' => ['<string>', ...], 'resourceType' => '<string>', // REQUIRED 'selectionMode' => '<string>', // REQUIRED ], // ... ], ]);
Parameter Details
Members
- actions
-
- Type: Associative array of custom strings keys (ExperimentTemplateActionName) to UpdateExperimentTemplateActionInputItem structures
The actions for the experiment.
- description
-
- Type: string
A description for the template.
- experimentOptions
-
- Type: UpdateExperimentTemplateExperimentOptionsInput structure
The experiment options for the experiment template.
- id
-
- Required: Yes
- Type: string
The ID of the experiment template.
- logConfiguration
-
- Type: UpdateExperimentTemplateLogConfigurationInput structure
The configuration for experiment logging.
- roleArn
-
- Type: string
The Amazon Resource Name (ARN) of an IAM role that grants the FIS service permission to perform service actions on your behalf.
- stopConditions
-
- Type: Array of UpdateExperimentTemplateStopConditionInput structures
The stop conditions for the experiment.
- targets
-
- Type: Associative array of custom strings keys (ExperimentTemplateTargetName) to UpdateExperimentTemplateTargetInput structures
The targets for the experiment.
Result Syntax
[ 'experimentTemplate' => [ 'actions' => [ '<ExperimentTemplateActionName>' => [ 'actionId' => '<string>', 'description' => '<string>', 'parameters' => ['<string>', ...], 'startAfter' => ['<string>', ...], 'targets' => ['<string>', ...], ], // ... ], 'arn' => '<string>', 'creationTime' => <DateTime>, 'description' => '<string>', 'experimentOptions' => [ 'accountTargeting' => 'single-account|multi-account', 'emptyTargetResolutionMode' => 'fail|skip', ], 'id' => '<string>', 'lastUpdateTime' => <DateTime>, 'logConfiguration' => [ 'cloudWatchLogsConfiguration' => [ 'logGroupArn' => '<string>', ], 'logSchemaVersion' => <integer>, 's3Configuration' => [ 'bucketName' => '<string>', 'prefix' => '<string>', ], ], 'roleArn' => '<string>', 'stopConditions' => [ [ 'source' => '<string>', 'value' => '<string>', ], // ... ], 'tags' => ['<string>', ...], 'targetAccountConfigurationsCount' => <integer>, 'targets' => [ '<ExperimentTemplateTargetName>' => [ 'filters' => [ [ 'path' => '<string>', 'values' => ['<string>', ...], ], // ... ], 'parameters' => ['<string>', ...], 'resourceArns' => ['<string>', ...], 'resourceTags' => ['<string>', ...], 'resourceType' => '<string>', 'selectionMode' => '<string>', ], // ... ], ], ]
Result Details
Members
- experimentTemplate
-
- Type: ExperimentTemplate structure
Information about the experiment template.
Errors
- ValidationException:
The specified input is not valid, or fails to satisfy the constraints for the request.
- ResourceNotFoundException:
The specified resource cannot be found.
- ServiceQuotaExceededException:
You have exceeded your service quota.
UpdateTargetAccountConfiguration
$result = $client->updateTargetAccountConfiguration
([/* ... */]); $promise = $client->updateTargetAccountConfigurationAsync
([/* ... */]);
Updates the target account configuration for the specified experiment template.
Parameter Syntax
$result = $client->updateTargetAccountConfiguration([ 'accountId' => '<string>', // REQUIRED 'description' => '<string>', 'experimentTemplateId' => '<string>', // REQUIRED 'roleArn' => '<string>', ]);
Parameter Details
Members
- accountId
-
- Required: Yes
- Type: string
The Amazon Web Services account ID of the target account.
- description
-
- Type: string
The description of the target account.
- experimentTemplateId
-
- Required: Yes
- Type: string
The ID of the experiment template.
- roleArn
-
- Type: string
The Amazon Resource Name (ARN) of an IAM role for the target account.
Result Syntax
[ 'targetAccountConfiguration' => [ 'accountId' => '<string>', 'description' => '<string>', 'roleArn' => '<string>', ], ]
Result Details
Members
- targetAccountConfiguration
-
- Type: TargetAccountConfiguration structure
Information about the target account configuration.
Errors
- ValidationException:
The specified input is not valid, or fails to satisfy the constraints for the request.
- ResourceNotFoundException:
The specified resource cannot be found.
Shapes
Action
Description
Describes an action. For more information, see FIS actions in the Fault Injection Service User Guide.
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the action.
- description
-
- Type: string
The description for the action.
- id
-
- Type: string
The ID of the action.
- parameters
-
- Type: Associative array of custom strings keys (ActionParameterName) to ActionParameter structures
The action parameters, if applicable.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags for the action.
- targets
-
- Type: Associative array of custom strings keys (ActionTargetName) to ActionTarget structures
The supported targets for the action.
ActionParameter
Description
Describes a parameter for an action.
Members
- description
-
- Type: string
The parameter description.
- required
-
- Type: boolean
Indicates whether the parameter is required.
ActionSummary
Description
Provides a summary of an action.
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the action.
- description
-
- Type: string
The description for the action.
- id
-
- Type: string
The ID of the action.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags for the action.
- targets
-
- Type: Associative array of custom strings keys (ActionTargetName) to ActionTarget structures
The targets for the action.
ActionTarget
Description
Describes a target for an action.
Members
- resourceType
-
- Type: string
The resource type of the target.
ConflictException
Description
The request could not be processed because of a conflict.
Members
- message
-
- Type: string
CreateExperimentTemplateActionInput
Description
Specifies an action for an experiment template.
For more information, see Actions in the Fault Injection Service User Guide.
Members
- actionId
-
- Required: Yes
- Type: string
The ID of the action. The format of the action ID is: aws:service-name:action-type.
- description
-
- Type: string
A description for the action.
- parameters
-
- Type: Associative array of custom strings keys (ExperimentTemplateActionParameterName) to strings
The parameters for the action, if applicable.
- startAfter
-
- Type: Array of strings
The name of the action that must be completed before the current action starts. Omit this parameter to run the action at the start of the experiment.
- targets
-
- Type: Associative array of custom strings keys (ExperimentTemplateActionTargetName) to strings
The targets for the action.
CreateExperimentTemplateExperimentOptionsInput
Description
Specifies experiment options for an experiment template.
Members
- accountTargeting
-
- Type: string
Specifies the account targeting setting for experiment options.
- emptyTargetResolutionMode
-
- Type: string
Specifies the empty target resolution mode for experiment options.
CreateExperimentTemplateLogConfigurationInput
Description
Specifies the configuration for experiment logging.
Members
- cloudWatchLogsConfiguration
-
- Type: ExperimentTemplateCloudWatchLogsLogConfigurationInput structure
The configuration for experiment logging to Amazon CloudWatch Logs.
- logSchemaVersion
-
- Required: Yes
- Type: int
The schema version.
- s3Configuration
-
- Type: ExperimentTemplateS3LogConfigurationInput structure
The configuration for experiment logging to Amazon S3.
CreateExperimentTemplateStopConditionInput
Description
Specifies a stop condition for an experiment template.
Members
- source
-
- Required: Yes
- Type: string
The source for the stop condition. Specify
aws:cloudwatch:alarm
if the stop condition is defined by a CloudWatch alarm. Specifynone
if there is no stop condition. - value
-
- Type: string
The Amazon Resource Name (ARN) of the CloudWatch alarm. This is required if the source is a CloudWatch alarm.
CreateExperimentTemplateTargetInput
Description
Specifies a target for an experiment. You must specify at least one Amazon Resource Name (ARN) or at least one resource tag. You cannot specify both ARNs and tags.
For more information, see Targets in the Fault Injection Service User Guide.
Members
- filters
-
- Type: Array of ExperimentTemplateTargetInputFilter structures
The filters to apply to identify target resources using specific attributes.
- parameters
-
- Type: Associative array of custom strings keys (ExperimentTemplateTargetParameterName) to strings
The resource type parameters.
- resourceArns
-
- Type: Array of strings
The Amazon Resource Names (ARNs) of the resources.
- resourceTags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags for the target resources.
- resourceType
-
- Required: Yes
- Type: string
The resource type. The resource type must be supported for the specified action.
- selectionMode
-
- Required: Yes
- Type: string
Scopes the identified resources to a specific count of the resources at random, or a percentage of the resources. All identified resources are included in the target.
-
ALL - Run the action on all identified targets. This is the default.
-
COUNT(n) - Run the action on the specified number of targets, chosen from the identified targets at random. For example, COUNT(1) selects one of the targets.
-
PERCENT(n) - Run the action on the specified percentage of targets, chosen from the identified targets at random. For example, PERCENT(25) selects 25% of the targets.
Experiment
Description
Describes an experiment.
Members
- actions
-
- Type: Associative array of custom strings keys (ExperimentActionName) to ExperimentAction structures
The actions for the experiment.
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the experiment.
- creationTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time that the experiment was created.
- endTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time that the experiment ended.
- experimentOptions
-
- Type: ExperimentOptions structure
The experiment options for the experiment.
- experimentTemplateId
-
- Type: string
The ID of the experiment template.
- id
-
- Type: string
The ID of the experiment.
- logConfiguration
-
- Type: ExperimentLogConfiguration structure
The configuration for experiment logging.
- roleArn
-
- Type: string
The Amazon Resource Name (ARN) of an IAM role that grants the FIS service permission to perform service actions on your behalf.
- startTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time that the experiment started.
- state
-
- Type: ExperimentState structure
The state of the experiment.
- stopConditions
-
- Type: Array of ExperimentStopCondition structures
The stop conditions for the experiment.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags for the experiment.
- targetAccountConfigurationsCount
-
- Type: long (int|float)
The count of target account configurations for the experiment.
- targets
-
- Type: Associative array of custom strings keys (ExperimentTargetName) to ExperimentTarget structures
The targets for the experiment.
ExperimentAction
Description
Describes the action for an experiment.
Members
- actionId
-
- Type: string
The ID of the action.
- description
-
- Type: string
The description for the action.
- endTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time that the action ended.
- parameters
-
- Type: Associative array of custom strings keys (ExperimentActionParameterName) to strings
The parameters for the action.
- startAfter
-
- Type: Array of strings
The name of the action that must be completed before this action starts.
- startTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time that the action started.
- state
-
- Type: ExperimentActionState structure
The state of the action.
- targets
-
- Type: Associative array of custom strings keys (ExperimentActionTargetName) to strings
The targets for the action.
ExperimentActionState
Description
Describes the state of an action.
Members
- reason
-
- Type: string
The reason for the state.
- status
-
- Type: string
The state of the action.
ExperimentCloudWatchLogsLogConfiguration
Description
Describes the configuration for experiment logging to Amazon CloudWatch Logs.
Members
- logGroupArn
-
- Type: string
The Amazon Resource Name (ARN) of the destination Amazon CloudWatch Logs log group.
ExperimentError
Description
Describes the error when an experiment has failed
.
Members
- accountId
-
- Type: string
The Amazon Web Services Account ID where the experiment failure occurred.
- code
-
- Type: string
The error code for the failed experiment.
- location
-
- Type: string
Context for the section of the experiment template that failed.
ExperimentLogConfiguration
Description
Describes the configuration for experiment logging.
Members
- cloudWatchLogsConfiguration
-
- Type: ExperimentCloudWatchLogsLogConfiguration structure
The configuration for experiment logging to Amazon CloudWatch Logs.
- logSchemaVersion
-
- Type: int
The schema version.
- s3Configuration
-
- Type: ExperimentS3LogConfiguration structure
The configuration for experiment logging to Amazon S3.
ExperimentOptions
Description
Describes the options for an experiment.
Members
- accountTargeting
-
- Type: string
The account targeting setting for an experiment.
- actionsMode
-
- Type: string
The actions mode of the experiment that is set from the StartExperiment API command.
- emptyTargetResolutionMode
-
- Type: string
The empty target resolution mode for an experiment.
ExperimentS3LogConfiguration
Description
Describes the configuration for experiment logging to Amazon S3.
Members
- bucketName
-
- Type: string
The name of the destination bucket.
- prefix
-
- Type: string
The bucket prefix.
ExperimentState
Description
Describes the state of an experiment.
Members
- error
-
- Type: ExperimentError structure
The error information of the experiment when the action has
failed
. - reason
-
- Type: string
The reason for the state.
- status
-
- Type: string
The state of the experiment.
ExperimentStopCondition
Description
Describes the stop condition for an experiment.
Members
- source
-
- Type: string
The source for the stop condition.
- value
-
- Type: string
The Amazon Resource Name (ARN) of the CloudWatch alarm, if applicable.
ExperimentSummary
Description
Provides a summary of an experiment.
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the experiment.
- creationTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time that the experiment was created.
- experimentOptions
-
- Type: ExperimentOptions structure
The experiment options for the experiment.
- experimentTemplateId
-
- Type: string
The ID of the experiment template.
- id
-
- Type: string
The ID of the experiment.
- state
-
- Type: ExperimentState structure
The state of the experiment.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags for the experiment.
ExperimentTarget
Description
Describes a target for an experiment.
Members
- filters
-
- Type: Array of ExperimentTargetFilter structures
The filters to apply to identify target resources using specific attributes.
- parameters
-
- Type: Associative array of custom strings keys (ExperimentTargetParameterName) to strings
The resource type parameters.
- resourceArns
-
- Type: Array of strings
The Amazon Resource Names (ARNs) of the resources.
- resourceTags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags for the target resources.
- resourceType
-
- Type: string
The resource type.
- selectionMode
-
- Type: string
Scopes the identified resources to a specific count or percentage.
ExperimentTargetAccountConfiguration
Description
Describes a target account configuration for an experiment.
Members
- accountId
-
- Type: string
The Amazon Web Services account ID of the target account.
- description
-
- Type: string
The description of the target account.
- roleArn
-
- Type: string
The Amazon Resource Name (ARN) of an IAM role for the target account.
ExperimentTargetAccountConfigurationSummary
Description
Provides a summary of a target account configuration.
Members
- accountId
-
- Type: string
The Amazon Web Services account ID of the target account.
- description
-
- Type: string
The description of the target account.
- roleArn
-
- Type: string
The Amazon Resource Name (ARN) of an IAM role for the target account.
ExperimentTargetFilter
Description
Describes a filter used for the target resources in an experiment.
Members
- path
-
- Type: string
The attribute path for the filter.
- values
-
- Type: Array of strings
The attribute values for the filter.
ExperimentTemplate
Description
Describes an experiment template.
Members
- actions
-
- Type: Associative array of custom strings keys (ExperimentTemplateActionName) to ExperimentTemplateAction structures
The actions for the experiment.
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the experiment template.
- creationTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time the experiment template was created.
- description
-
- Type: string
The description for the experiment template.
- experimentOptions
-
- Type: ExperimentTemplateExperimentOptions structure
The experiment options for an experiment template.
- id
-
- Type: string
The ID of the experiment template.
- lastUpdateTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time the experiment template was last updated.
- logConfiguration
-
- Type: ExperimentTemplateLogConfiguration structure
The configuration for experiment logging.
- roleArn
-
- Type: string
The Amazon Resource Name (ARN) of an IAM role.
- stopConditions
-
- Type: Array of ExperimentTemplateStopCondition structures
The stop conditions for the experiment.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags for the experiment template.
- targetAccountConfigurationsCount
-
- Type: long (int|float)
The count of target account configurations for the experiment template.
- targets
-
- Type: Associative array of custom strings keys (ExperimentTemplateTargetName) to ExperimentTemplateTarget structures
The targets for the experiment.
ExperimentTemplateAction
Description
Describes an action for an experiment template.
Members
- actionId
-
- Type: string
The ID of the action.
- description
-
- Type: string
A description for the action.
- parameters
-
- Type: Associative array of custom strings keys (ExperimentTemplateActionParameterName) to strings
The parameters for the action.
- startAfter
-
- Type: Array of strings
The name of the action that must be completed before the current action starts.
- targets
-
- Type: Associative array of custom strings keys (ExperimentTemplateActionTargetName) to strings
The targets for the action.
ExperimentTemplateCloudWatchLogsLogConfiguration
Description
Describes the configuration for experiment logging to Amazon CloudWatch Logs.
Members
- logGroupArn
-
- Type: string
The Amazon Resource Name (ARN) of the destination Amazon CloudWatch Logs log group.
ExperimentTemplateCloudWatchLogsLogConfigurationInput
Description
Specifies the configuration for experiment logging to Amazon CloudWatch Logs.
Members
- logGroupArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the destination Amazon CloudWatch Logs log group.
ExperimentTemplateExperimentOptions
Description
Describes the experiment options for an experiment template.
Members
- accountTargeting
-
- Type: string
The account targeting setting for an experiment template.
- emptyTargetResolutionMode
-
- Type: string
The empty target resolution mode for an experiment template.
ExperimentTemplateLogConfiguration
Description
Describes the configuration for experiment logging.
Members
- cloudWatchLogsConfiguration
-
- Type: ExperimentTemplateCloudWatchLogsLogConfiguration structure
The configuration for experiment logging to Amazon CloudWatch Logs.
- logSchemaVersion
-
- Type: int
The schema version.
- s3Configuration
-
- Type: ExperimentTemplateS3LogConfiguration structure
The configuration for experiment logging to Amazon S3.
ExperimentTemplateS3LogConfiguration
Description
Describes the configuration for experiment logging to Amazon S3.
Members
- bucketName
-
- Type: string
The name of the destination bucket.
- prefix
-
- Type: string
The bucket prefix.
ExperimentTemplateS3LogConfigurationInput
Description
Specifies the configuration for experiment logging to Amazon S3.
Members
- bucketName
-
- Required: Yes
- Type: string
The name of the destination bucket.
- prefix
-
- Type: string
The bucket prefix.
ExperimentTemplateStopCondition
Description
Describes a stop condition for an experiment template.
Members
- source
-
- Type: string
The source for the stop condition.
- value
-
- Type: string
The Amazon Resource Name (ARN) of the CloudWatch alarm, if applicable.
ExperimentTemplateSummary
Description
Provides a summary of an experiment template.
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the experiment template.
- creationTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time that the experiment template was created.
- description
-
- Type: string
The description of the experiment template.
- id
-
- Type: string
The ID of the experiment template.
- lastUpdateTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time that the experiment template was last updated.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags for the experiment template.
ExperimentTemplateTarget
Description
Describes a target for an experiment template.
Members
- filters
-
- Type: Array of ExperimentTemplateTargetFilter structures
The filters to apply to identify target resources using specific attributes.
- parameters
-
- Type: Associative array of custom strings keys (ExperimentTemplateTargetParameterName) to strings
The resource type parameters.
- resourceArns
-
- Type: Array of strings
The Amazon Resource Names (ARNs) of the targets.
- resourceTags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags for the target resources.
- resourceType
-
- Type: string
The resource type.
- selectionMode
-
- Type: string
Scopes the identified resources to a specific count or percentage.
ExperimentTemplateTargetFilter
Description
Describes a filter used for the target resources in an experiment template.
Members
- path
-
- Type: string
The attribute path for the filter.
- values
-
- Type: Array of strings
The attribute values for the filter.
ExperimentTemplateTargetInputFilter
Description
Specifies a filter used for the target resource input in an experiment template.
For more information, see Resource filters in the Fault Injection Service User Guide.
Members
- path
-
- Required: Yes
- Type: string
The attribute path for the filter.
- values
-
- Required: Yes
- Type: Array of strings
The attribute values for the filter.
ResolvedTarget
Description
Describes a resolved target.
Members
- resourceType
-
- Type: string
The resource type of the target.
- targetInformation
-
- Type: Associative array of custom strings keys (TargetInformationKey) to strings
Information about the target.
- targetName
-
- Type: string
The name of the target.
ResourceNotFoundException
Description
The specified resource cannot be found.
Members
- message
-
- Type: string
ServiceQuotaExceededException
Description
You have exceeded your service quota.
Members
- message
-
- Type: string
StartExperimentExperimentOptionsInput
Description
Specifies experiment options for running an experiment.
Members
- actionsMode
-
- Type: string
Specifies the actions mode for experiment options.
TargetAccountConfiguration
Description
Describes a target account configuration.
Members
- accountId
-
- Type: string
The Amazon Web Services account ID of the target account.
- description
-
- Type: string
The description of the target account.
- roleArn
-
- Type: string
The Amazon Resource Name (ARN) of an IAM role for the target account.
TargetAccountConfigurationSummary
Description
Provides a summary of a target account configuration.
Members
- accountId
-
- Type: string
The Amazon Web Services account ID of the target account.
- description
-
- Type: string
The description of the target account.
- roleArn
-
- Type: string
The Amazon Resource Name (ARN) of an IAM role for the target account.
TargetResourceType
Description
Describes a resource type.
Members
- description
-
- Type: string
A description of the resource type.
- parameters
-
- Type: Associative array of custom strings keys (TargetResourceTypeParameterName) to TargetResourceTypeParameter structures
The parameters for the resource type.
- resourceType
-
- Type: string
The resource type.
TargetResourceTypeParameter
Description
Describes the parameters for a resource type. Use parameters to determine which tasks are identified during target resolution.
Members
- description
-
- Type: string
A description of the parameter.
- required
-
- Type: boolean
Indicates whether the parameter is required.
TargetResourceTypeSummary
Description
Describes a resource type.
Members
- description
-
- Type: string
A description of the resource type.
- resourceType
-
- Type: string
The resource type.
UpdateExperimentTemplateActionInputItem
Description
Specifies an action for an experiment template.
Members
- actionId
-
- Type: string
The ID of the action.
- description
-
- Type: string
A description for the action.
- parameters
-
- Type: Associative array of custom strings keys (ExperimentTemplateActionParameterName) to strings
The parameters for the action, if applicable.
- startAfter
-
- Type: Array of strings
The name of the action that must be completed before the current action starts. Omit this parameter to run the action at the start of the experiment.
- targets
-
- Type: Associative array of custom strings keys (ExperimentTemplateActionTargetName) to strings
The targets for the action.
UpdateExperimentTemplateExperimentOptionsInput
Description
Specifies an experiment option for an experiment template.
Members
- emptyTargetResolutionMode
-
- Type: string
The empty target resolution mode of the experiment template.
UpdateExperimentTemplateLogConfigurationInput
Description
Specifies the configuration for experiment logging.
Members
- cloudWatchLogsConfiguration
-
- Type: ExperimentTemplateCloudWatchLogsLogConfigurationInput structure
The configuration for experiment logging to Amazon CloudWatch Logs.
- logSchemaVersion
-
- Type: int
The schema version.
- s3Configuration
-
- Type: ExperimentTemplateS3LogConfigurationInput structure
The configuration for experiment logging to Amazon S3.
UpdateExperimentTemplateStopConditionInput
Description
Specifies a stop condition for an experiment. You can define a stop condition as a CloudWatch alarm.
Members
- source
-
- Required: Yes
- Type: string
The source for the stop condition. Specify
aws:cloudwatch:alarm
if the stop condition is defined by a CloudWatch alarm. Specifynone
if there is no stop condition. - value
-
- Type: string
The Amazon Resource Name (ARN) of the CloudWatch alarm.
UpdateExperimentTemplateTargetInput
Description
Specifies a target for an experiment. You must specify at least one Amazon Resource Name (ARN) or at least one resource tag. You cannot specify both.
Members
- filters
-
- Type: Array of ExperimentTemplateTargetInputFilter structures
The filters to apply to identify target resources using specific attributes.
- parameters
-
- Type: Associative array of custom strings keys (ExperimentTemplateTargetParameterName) to strings
The resource type parameters.
- resourceArns
-
- Type: Array of strings
The Amazon Resource Names (ARNs) of the targets.
- resourceTags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags for the target resources.
- resourceType
-
- Required: Yes
- Type: string
The resource type. The resource type must be supported for the specified action.
- selectionMode
-
- Required: Yes
- Type: string
Scopes the identified resources to a specific count or percentage.
ValidationException
Description
The specified input is not valid, or fails to satisfy the constraints for the request.
Members
- message
-
- Type: string