Skip to content

Commit 792094a

Browse files
author
AWS
committed
AWS Fault Injection Simulator Update: This release adds support for previewing target resources before running a FIS experiment. It also adds resource ARNs for actions, experiments, and experiment templates to API responses.
1 parent dc71754 commit 792094a

File tree

2 files changed

+81
-16
lines changed

2 files changed

+81
-16
lines changed

‎.changes/next-release/feature-AWSFaultInjectionSimulator-0004973.json‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"type": "feature",
3+
"category": "AWS Fault Injection Simulator",
4+
"contributor": "",
5+
"description": "This release adds support for previewing target resources before running a FIS experiment. It also adds resource ARNs for actions, experiments, and experiment templates to API responses."
6+
}

‎services/fis/src/main/resources/codegen-resources/service-2.json‎

Lines changed: 75 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@
2828
{"shape":"ResourceNotFoundException"},
2929
{"shape":"ServiceQuotaExceededException"}
3030
],
31-
"documentation":"<p>Creates an experiment template. </p> <p>An experiment template includes the following components:</p> <ul> <li> <p> <b>Targets</b>: 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.</p> </li> <li> <p> <b>Actions</b>: 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.</p> </li> <li> <p> <b>Stop conditions</b>: 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.</p> </li> </ul> <p>For more information, see <a href=\"https://docs.aws.amazon.com/fis/latest/userguide/experiment-templates.html\">experiment templates</a> in the <i>Fault Injection Simulator User Guide</i>.</p>"
31+
"documentation":"<p>Creates an experiment template. </p> <p>An experiment template includes the following components:</p> <ul> <li> <p> <b>Targets</b>: 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.</p> </li> <li> <p> <b>Actions</b>: 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.</p> </li> <li> <p> <b>Stop conditions</b>: 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.</p> </li> </ul> <p>For more information, see <a href=\"https://docs.aws.amazon.com/fis/latest/userguide/experiment-templates.html\">experiment templates</a> in the <i>Fault Injection Service User Guide</i>.</p>"
3232
},
3333
"CreateTargetAccountConfiguration":{
3434
"name":"CreateTargetAccountConfiguration",
@@ -45,7 +45,7 @@
4545
{"shape":"ResourceNotFoundException"},
4646
{"shape":"ServiceQuotaExceededException"}
4747
],
48-
"documentation":"<p>Creates a target account configuration for the experiment template. A target account configuration is required when <code>accountTargeting</code> of <code>experimentOptions</code> is set to <code>multi-account</code>. For more information, see <a href=\"https://docs.aws.amazon.com/fis/latest/userguide/experiment-options.html\">experiment options</a> in the <i>Fault Injection Simulator User Guide</i>. </p>"
48+
"documentation":"<p>Creates a target account configuration for the experiment template. A target account configuration is required when <code>accountTargeting</code> of <code>experimentOptions</code> is set to <code>multi-account</code>. For more information, see <a href=\"https://docs.aws.amazon.com/fis/latest/userguide/experiment-options.html\">experiment options</a> in the <i>Fault Injection Service User Guide</i>. </p>"
4949
},
5050
"DeleteExperimentTemplate":{
5151
"name":"DeleteExperimentTemplate",
@@ -380,6 +380,10 @@
380380
"shape":"ActionId",
381381
"documentation":"<p>The ID of the action.</p>"
382382
},
383+
"arn":{
384+
"shape":"ResourceArn",
385+
"documentation":"<p>The Amazon Resource Name (ARN) of the action.</p>"
386+
},
383387
"description":{
384388
"shape":"ActionDescription",
385389
"documentation":"<p>The description for the action.</p>"
@@ -397,7 +401,7 @@
397401
"documentation":"<p>The tags for the action.</p>"
398402
}
399403
},
400-
"documentation":"<p>Describes an action. For more information, see <a href=\"https://docs.aws.amazon.com/fis/latest/userguide/fis-actions-reference.html\">FIS actions</a> in the <i>Fault Injection Simulator User Guide</i>.</p>"
404+
"documentation":"<p>Describes an action. For more information, see <a href=\"https://docs.aws.amazon.com/fis/latest/userguide/fis-actions-reference.html\">FIS actions</a> in the <i>Fault Injection Service User Guide</i>.</p>"
401405
},
402406
"ActionDescription":{
403407
"type":"string",
@@ -447,6 +451,10 @@
447451
"shape":"ActionId",
448452
"documentation":"<p>The ID of the action.</p>"
449453
},
454+
"arn":{
455+
"shape":"ResourceArn",
456+
"documentation":"<p>The Amazon Resource Name (ARN) of the action.</p>"
457+
},
450458
"description":{
451459
"shape":"ActionDescription",
452460
"documentation":"<p>The description for the action.</p>"
@@ -486,6 +494,13 @@
486494
"max":64,
487495
"pattern":"[\\S]+"
488496
},
497+
"ActionsMode":{
498+
"type":"string",
499+
"enum":[
500+
"skip-all",
501+
"run-all"
502+
]
503+
},
489504
"ClientToken":{
490505
"type":"string",
491506
"max":1024,
@@ -532,7 +547,7 @@
532547
"documentation":"<p>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.</p>"
533548
}
534549
},
535-
"documentation":"<p>Specifies an action for an experiment template.</p> <p>For more information, see <a href=\"https://docs.aws.amazon.com/fis/latest/userguide/actions.html\">Actions</a> in the <i>Fault Injection Simulator User Guide</i>.</p>"
550+
"documentation":"<p>Specifies an action for an experiment template.</p> <p>For more information, see <a href=\"https://docs.aws.amazon.com/fis/latest/userguide/actions.html\">Actions</a> in the <i>Fault Injection Service User Guide</i>.</p>"
536551
},
537552
"CreateExperimentTemplateActionInputMap":{
538553
"type":"map",
@@ -681,7 +696,7 @@
681696
"documentation":"<p>The resource type parameters.</p>"
682697
}
683698
},
684-
"documentation":"<p>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.</p> <p>For more information, see <a href=\"https://docs.aws.amazon.com/fis/latest/userguide/targets.html\">Targets</a> in the <i>Fault Injection Simulator User Guide</i>.</p>"
699+
"documentation":"<p>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.</p> <p>For more information, see <a href=\"https://docs.aws.amazon.com/fis/latest/userguide/targets.html\">Targets</a> in the <i>Fault Injection Service User Guide</i>.</p>"
685700
},
686701
"CreateExperimentTemplateTargetInputMap":{
687702
"type":"map",
@@ -709,7 +724,7 @@
709724
},
710725
"accountId":{
711726
"shape":"TargetAccountId",
712-
"documentation":"<p>The AWS account ID of the target account.</p>",
727+
"documentation":"<p>The Amazon Web Services account ID of the target account.</p>",
713728
"location":"uri",
714729
"locationName":"accountId"
715730
},
@@ -769,7 +784,7 @@
769784
},
770785
"accountId":{
771786
"shape":"TargetAccountId",
772-
"documentation":"<p>The AWS account ID of the target account.</p>",
787+
"documentation":"<p>The Amazon Web Services account ID of the target account.</p>",
773788
"location":"uri",
774789
"locationName":"accountId"
775790
}
@@ -803,6 +818,10 @@
803818
"shape":"ExperimentId",
804819
"documentation":"<p>The ID of the experiment.</p>"
805820
},
821+
"arn":{
822+
"shape":"ResourceArn",
823+
"documentation":"<p>The Amazon Resource Name (ARN) of the experiment.</p>"
824+
},
806825
"experimentTemplateId":{
807826
"shape":"ExperimentTemplateId",
808827
"documentation":"<p>The ID of the experiment template.</p>"
@@ -1024,6 +1043,10 @@
10241043
"emptyTargetResolutionMode":{
10251044
"shape":"EmptyTargetResolutionMode",
10261045
"documentation":"<p>The empty target resolution mode for an experiment.</p>"
1046+
},
1047+
"actionsMode":{
1048+
"shape":"ActionsMode",
1049+
"documentation":"<p>The actions mode of the experiment that is set from the StartExperiment API command.</p>"
10271050
}
10281051
},
10291052
"documentation":"<p>Describes the options for an experiment.</p>"
@@ -1099,6 +1122,10 @@
10991122
"shape":"ExperimentId",
11001123
"documentation":"<p>The ID of the experiment.</p>"
11011124
},
1125+
"arn":{
1126+
"shape":"ResourceArn",
1127+
"documentation":"<p>The Amazon Resource Name (ARN) of the experiment.</p>"
1128+
},
11021129
"experimentTemplateId":{
11031130
"shape":"ExperimentTemplateId",
11041131
"documentation":"<p>The ID of the experiment template.</p>"
@@ -1114,6 +1141,10 @@
11141141
"tags":{
11151142
"shape":"TagMap",
11161143
"documentation":"<p>The tags for the experiment.</p>"
1144+
},
1145+
"experimentOptions":{
1146+
"shape":"ExperimentOptions",
1147+
"documentation":"<p>The experiment options for the experiment.</p>"
11171148
}
11181149
},
11191150
"documentation":"<p>Provides a summary of an experiment.</p>"
@@ -1161,7 +1192,7 @@
11611192
},
11621193
"accountId":{
11631194
"shape":"TargetAccountId",
1164-
"documentation":"<p>The AWS account ID of the target account.</p>"
1195+
"documentation":"<p>The Amazon Web Services account ID of the target account.</p>"
11651196
},
11661197
"description":{
11671198
"shape":"TargetAccountConfigurationDescription",
@@ -1183,7 +1214,7 @@
11831214
},
11841215
"accountId":{
11851216
"shape":"TargetAccountId",
1186-
"documentation":"<p>The AWS account ID of the target account.</p>"
1217+
"documentation":"<p>The Amazon Web Services account ID of the target account.</p>"
11871218
},
11881219
"description":{
11891220
"shape":"TargetAccountConfigurationDescription",
@@ -1261,6 +1292,10 @@
12611292
"shape":"ExperimentTemplateId",
12621293
"documentation":"<p>The ID of the experiment template.</p>"
12631294
},
1295+
"arn":{
1296+
"shape":"ResourceArn",
1297+
"documentation":"<p>The Amazon Resource Name (ARN) of the experiment template.</p>"
1298+
},
12641299
"description":{
12651300
"shape":"ExperimentTemplateDescription",
12661301
"documentation":"<p>The description for the experiment template.</p>"
@@ -1500,6 +1535,10 @@
15001535
"shape":"ExperimentTemplateId",
15011536
"documentation":"<p>The ID of the experiment template.</p>"
15021537
},
1538+
"arn":{
1539+
"shape":"ResourceArn",
1540+
"documentation":"<p>The Amazon Resource Name (ARN) of the experiment template.</p>"
1541+
},
15031542
"description":{
15041543
"shape":"ExperimentTemplateDescription",
15051544
"documentation":"<p>The description of the experiment template.</p>"
@@ -1605,7 +1644,7 @@
16051644
"documentation":"<p>The attribute values for the filter.</p>"
16061645
}
16071646
},
1608-
"documentation":"<p>Specifies a filter used for the target resource input in an experiment template.</p> <p>For more information, see <a href=\"https://docs.aws.amazon.com/fis/latest/userguide/targets.html#target-filters\">Resource filters</a> in the <i>Fault Injection Simulator User Guide</i>.</p>"
1647+
"documentation":"<p>Specifies a filter used for the target resource input in an experiment template.</p> <p>For more information, see <a href=\"https://docs.aws.amazon.com/fis/latest/userguide/targets.html#target-filters\">Resource filters</a> in the <i>Fault Injection Service User Guide</i>.</p>"
16091648
},
16101649
"ExperimentTemplateTargetMap":{
16111650
"type":"map",
@@ -1695,7 +1734,7 @@
16951734
},
16961735
"accountId":{
16971736
"shape":"TargetAccountId",
1698-
"documentation":"<p>The AWS account ID of the target account.</p>",
1737+
"documentation":"<p>The Amazon Web Services account ID of the target account.</p>",
16991738
"location":"uri",
17001739
"locationName":"accountId"
17011740
}
@@ -1746,7 +1785,7 @@
17461785
},
17471786
"accountId":{
17481787
"shape":"TargetAccountId",
1749-
"documentation":"<p>The AWS account ID of the target account.</p>",
1788+
"documentation":"<p>The Amazon Web Services account ID of the target account.</p>",
17501789
"location":"uri",
17511790
"locationName":"accountId"
17521791
}
@@ -1955,6 +1994,12 @@
19551994
"documentation":"<p>The token for the next page of results.</p>",
19561995
"location":"querystring",
19571996
"locationName":"nextToken"
1997+
},
1998+
"experimentTemplateId":{
1999+
"shape":"ExperimentTemplateId",
2000+
"documentation":"<p>The ID of the experiment template.</p>",
2001+
"location":"querystring",
2002+
"locationName":"experimentTemplateId"
19582003
}
19592004
}
19602005
},
@@ -2147,6 +2192,16 @@
21472192
"error":{"httpStatusCode":402},
21482193
"exception":true
21492194
},
2195+
"StartExperimentExperimentOptionsInput":{
2196+
"type":"structure",
2197+
"members":{
2198+
"actionsMode":{
2199+
"shape":"ActionsMode",
2200+
"documentation":"<p>Specifies the actions mode for experiment options.</p>"
2201+
}
2202+
},
2203+
"documentation":"<p>Specifies experiment options for running an experiment.</p>"
2204+
},
21502205
"StartExperimentRequest":{
21512206
"type":"structure",
21522207
"required":[
@@ -2163,6 +2218,10 @@
21632218
"shape":"ExperimentTemplateId",
21642219
"documentation":"<p>The ID of the experiment template.</p>"
21652220
},
2221+
"experimentOptions":{
2222+
"shape":"StartExperimentExperimentOptionsInput",
2223+
"documentation":"<p>The experiment options for running the experiment.</p>"
2224+
},
21662225
"tags":{
21672226
"shape":"TagMap",
21682227
"documentation":"<p>The tags to apply to the experiment.</p>"
@@ -2263,7 +2322,7 @@
22632322
},
22642323
"accountId":{
22652324
"shape":"TargetAccountId",
2266-
"documentation":"<p>The AWS account ID of the target account.</p>"
2325+
"documentation":"<p>The Amazon Web Services account ID of the target account.</p>"
22672326
},
22682327
"description":{
22692328
"shape":"TargetAccountConfigurationDescription",
@@ -2290,7 +2349,7 @@
22902349
},
22912350
"accountId":{
22922351
"shape":"TargetAccountId",
2293-
"documentation":"<p>The AWS account ID of the target account.</p>"
2352+
"documentation":"<p>The Amazon Web Services account ID of the target account.</p>"
22942353
},
22952354
"description":{
22962355
"shape":"TargetAccountConfigurationDescription",
@@ -2610,7 +2669,7 @@
26102669
},
26112670
"accountId":{
26122671
"shape":"TargetAccountId",
2613-
"documentation":"<p>The AWS account ID of the target account.</p>",
2672+
"documentation":"<p>The Amazon Web Services account ID of the target account.</p>",
26142673
"location":"uri",
26152674
"locationName":"accountId"
26162675
},
@@ -2643,5 +2702,5 @@
26432702
"exception":true
26442703
}
26452704
},
2646-
"documentation":"<p>Fault Injection Simulator is a managed service that enables you to perform fault injection experiments on your Amazon Web Services workloads. For more information, see the <a href=\"https://docs.aws.amazon.com/fis/latest/userguide/\">Fault Injection Simulator User Guide</a>.</p>"
2705+
"documentation":"<p>Fault Injection Service is a managed service that enables you to perform fault injection experiments on your Amazon Web Services workloads. For more information, see the <a href=\"https://docs.aws.amazon.com/fis/latest/userguide/\">Fault Injection Service User Guide</a>.</p>"
26472706
}

0 commit comments

Comments
 (0)