Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# AWS FIS Beispiele mit AWS CLI
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS FIS.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `create-experiment-template`
Das folgende Codebeispiel zeigt, wie Sie`create-experiment-template`.
**AWS CLI**
**So erstellen Sie eine Experimentvorlage**
Das folgende `create-experiment-template` Beispiel erstellt eine Versuchsvorlage in Ihrem AWS FIS-Account.
```
aws fis create-experiment-template \
--cli-input-json file://myfile.json
```
Inhalt von `myfile.json`:
```
{
"description": "experimentTemplate",
"stopConditions": [
{
"source": "aws:cloudwatch:alarm",
"value": "arn:aws:cloudwatch:us-west-2:123456789012:alarm:alarmName"
}
],
"targets": {
"Instances-Target-1": {
"resourceType": "aws:ec2:instance",
"resourceArns": [
"arn:aws:ec2:us-west-2:123456789012:instance/i-12a3b4c56d78e9012"
],
"selectionMode": "ALL"
}
},
"actions": {
"reboot": {
"actionId": "aws:ec2:reboot-instances",
"description": "reboot",
"parameters": {},
"targets": {
"Instances": "Instances-Target-1"
}
}
},
"roleArn": "arn:aws:iam::123456789012:role/myRole"
}
```
Ausgabe:
```
{
"experimentTemplate": {
"id": "ABCDE1fgHIJkLmNop",
"description": "experimentTemplate",
"targets": {
"Instances-Target-1": {
"resourceType": "aws:ec2:instance",
"resourceArns": [
"arn:aws:ec2:us-west-2:123456789012:instance/i-12a3b4c56d78e9012"
],
"selectionMode": "ALL"
}
},
"actions": {
"reboot": {
"actionId": "aws:ec2:reboot-instances",
"description": "reboot",
"parameters": {},
"targets": {
"Instances": "Instances-Target-1"
}
}
},
"stopConditions": [
{
"source": "aws:cloudwatch:alarm",
"value": "arn:aws:cloudwatch:us-west-2:123456789012:alarm:alarmName"
}
],
"creationTime": 1616434850.659,
"lastUpdateTime": 1616434850.659,
"roleArn": "arn:aws:iam::123456789012:role/myRole",
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [Erstellen einer Experimentvorlage](https://docs.aws.amazon.com/fis/latest/userguide/working-with-templates.html#create-template) im *Benutzerhandbuch für AWS Fault Injection Simulator*.
+ Einzelheiten zur API finden Sie [CreateExperimentTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/create-experiment-template.html)in der *AWS CLI Befehlsreferenz.*
### `delete-experiment-template`
Das folgende Codebeispiel zeigt die Verwendung`delete-experiment-template`.
**AWS CLI**
**So löschen Sie eine Experimentvorlage**
Im folgenden Beispiel für `delete-experiment-template` wird die angegebene Experimentvorlage gelöscht.
```
aws fis delete-experiment-template \
--id ABCDE1fgHIJkLmNop
```
Ausgabe:
```
{
"experimentTemplate": {
"id": "ABCDE1fgHIJkLmNop",
"description": "myExperimentTemplate",
"targets": {
"Instances-Target-1": {
"resourceType": "aws:ec2:instance",
"resourceArns": [
"arn:aws:ec2:us-west-2:123456789012:instance/i-12a3b4c56d78e9012"
],
"selectionMode": "ALL"
}
},
"actions": {
"testaction": {
"actionId": "aws:ec2:stop-instances",
"parameters": {},
"targets": {
"Instances": "Instances-Target-1"
}
}
},
"stopConditions": [
{
"source": "none"
}
],
"creationTime": 1616017191.124,
"lastUpdateTime": 1616017859.607,
"roleArn": "arn:aws:iam::123456789012:role/FISRole"
}
}
```
Weitere Informationen finden Sie unter [Löschen einer Experimentvorlage](https://docs.aws.amazon.com/fis/latest/userguide/working-with-templates.html#delete-template) im *Benutzerhandbuch für AWS Fault Injection Simulator*.
+ Einzelheiten zur API finden Sie [DeleteExperimentTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/delete-experiment-template.html)in der *AWS CLI Befehlsreferenz*.
### `get-action`
Das folgende Codebeispiel zeigt die Verwendung`get-action`.
**AWS CLI**
**So rufen Sie Details zur Aktion ab**
Im folgenden Beispiel für `get-action` werden die Details der angegebenen Aktion abgerufen.
```
aws fis get-action \
--id aws:ec2:stop-instances
```
Ausgabe:
```
{
"action": {
"id": "aws:ec2:stop-instances",
"description": "Stop the specified EC2 instances.",
"parameters": {
"startInstancesAfterDuration": {
"description": "The time to wait before restarting the instances (ISO 8601 duration).",
"required": false
}
},
"targets": {
"Instances": {
"resourceType": "aws:ec2:instance"
}
},
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [Aktionen](https://docs.aws.amazon.com/fis/latest/userguide/actions.html) im *Benutzerhandbuch für AWS Fault Injection Simulator*.
+ Einzelheiten zur API finden Sie [GetAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/get-action.html)in der *AWS CLI Befehlsreferenz*.
### `get-experiment-template`
Das folgende Codebeispiel zeigt die Verwendung`get-experiment-template`.
**AWS CLI**
**So rufen Sie Details zur Experimentvorlage ab**
Im folgenden Beispiel für `get-experiment-template` werden die Details der angegebenen Experimentvorlage abgerufen.
```
aws fis get-experiment-template \
--id ABCDE1fgHIJkLmNop
```
Ausgabe:
```
{
"experimentTemplate": {
"id": "ABCDE1fgHIJkLmNop",
"description": "myExperimentTemplate",
"targets": {
"Instances-Target-1": {
"resourceType": "aws:ec2:instance",
"resourceArns": [
"arn:aws:ec2:us-west-2:123456789012:instance/i-12a3b4c56d78e9012"
],
"selectionMode": "ALL"
}
},
"actions": {
"testaction": {
"actionId": "aws:ec2:stop-instances",
"parameters": {},
"targets": {
"Instances": "Instances-Target-1"
}
}
},
"stopConditions": [
{
"source": "none"
}
],
"creationTime": 1616017191.124,
"lastUpdateTime": 1616017331.51,
"roleArn": "arn:aws:iam::123456789012:role/FISRole",
"tags": {
"key: "value"
}
}
}
```
Weitere Informationen finden Sie unter [Experimentvorlagen](https://docs.aws.amazon.com/fis/latest/userguide/experiment-templates.html) im *Benutzerhandbuch für AWS Fault Injection Simulator*.
+ Einzelheiten zur API finden Sie [GetExperimentTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/get-experiment-template.html)in der *AWS CLI Befehlsreferenz*.
### `get-experiment`
Das folgende Codebeispiel zeigt die Verwendung`get-experiment`.
**AWS CLI**
**So rufen Sie Details zum Experiment ab**
Im folgenden Beispiel für `get-experiment` werden die Details des angegebenen Experiments abgerufen.
```
aws fis get-experiment \
--id ABC12DeFGhI3jKLMNOP
```
Ausgabe:
```
{
"experiment": {
"id": "ABC12DeFGhI3jKLMNOP",
"experimentTemplateId": "ABCDE1fgHIJkLmNop",
"roleArn": "arn:aws:iam::123456789012:role/myRole",
"state": {
"status": "completed",
"reason": "Experiment completed."
},
"targets": {
"Instances-Target-1": {
"resourceType": "aws:ec2:instance",
"resourceArns": [
"arn:aws:ec2:us-west-2:123456789012:instance/i-12a3b4c56d78e9012"
],
"selectionMode": "ALL"
}
},
"actions": {
"reboot": {
"actionId": "aws:ec2:reboot-instances",
"parameters": {},
"targets": {
"Instances": "Instances-Target-1"
},
"state": {
"status": "completed",
"reason": "Action was completed."
}
}
},
"stopConditions": [
{
"source": "none"
}
],
"creationTime": 1616432509.662,
"startTime": 1616432509.962,
"endTime": 1616432522.307,
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [Experiments for AWS FIS im AWS Fault](https://docs.aws.amazon.com/fis/latest/userguide/experiments.html) *Injection Simulator-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [GetExperiment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/get-experiment.html)in der *AWS CLI Befehlsreferenz.*
### `list-actions`
Das folgende Codebeispiel zeigt die Verwendung`list-actions`.
**AWS CLI**
**So listen Sie Aktionen auf**
Im folgenden Beispiel für `list-actions` werden die verfügbaren Aktionen aufgelistet.
```
aws fis list-actions
```
Ausgabe:
```
{
"actions": [
{
"id": "aws:ec2:reboot-instances",
"description": "Reboot the specified EC2 instances.",
"targets": {
"Instances": {
"resourceType": "aws:ec2:instance"
}
},
"tags": {}
},
{
"id": "aws:ec2:stop-instances",
"description": "Stop the specified EC2 instances.",
"targets": {
"Instances": {
"resourceType": "aws:ec2:instance"
}
},
"tags": {}
},
{
"id": "aws:ec2:terminate-instances",
"description": "Terminate the specified EC2 instances.",
"targets": {
"Instances": {
"resourceType": "aws:ec2:instance"
}
},
"tags": {}
},
{
"id": "aws:ecs:drain-container-instances",
"description": "Drain percentage of underlying EC2 instances on an ECS cluster.",
"targets": {
"Clusters": {
"resourceType": "aws:ecs:cluster"
}
},
"tags": {}
},
{
"id": "aws:eks:terminate-nodegroup-instances",
"description": "Terminates a percentage of the underlying EC2 instances in an EKS cluster.",
"targets": {
"Nodegroups": {
"resourceType": "aws:eks:nodegroup"
}
},
"tags": {}
},
{
"id": "aws:fis:inject-api-internal-error",
"description": "Cause an AWS service to return internal error responses for specific callers and operations.",
"targets": {
"Roles": {
"resourceType": "aws:iam:role"
}
},
"tags": {}
},
{
"id": "aws:fis:inject-api-throttle-error",
"description": "Cause an AWS service to return throttled responses for specific callers and operations.",
"targets": {
"Roles": {
"resourceType": "aws:iam:role"
}
},
"tags": {}
},
{
"id": "aws:fis:inject-api-unavailable-error",
"description": "Cause an AWS service to return unavailable error responses for specific callers and operations.",
"targets": {
"Roles": {
"resourceType": "aws:iam:role"
}
},
"tags": {}
},
{
"id": "aws:fis:wait",
"description": "Wait for the specified duration. Stop condition monitoring will continue during this time.",
"tags": {}
},
{
"id": "aws:rds:failover-db-cluster",
"description": "Failover a DB Cluster to one of the replicas.",
"targets": {
"Clusters": {
"resourceType": "aws:rds:cluster"
}
},
"tags": {}
},
{
"id": "aws:rds:reboot-db-instances",
"description": "Reboot the specified DB instances.",
"targets": {
"DBInstances": {
"resourceType": "aws:rds:db"
}
},
"tags": {}
},
{
"id": "aws:ssm:send-command",
"description": "Run the specified SSM document.",
"targets": {
"Instances": {
"resourceType": "aws:ec2:instance"
}
},
"tags": {}
}
]
}
```
Weitere Informationen finden Sie unter [Aktionen](https://docs.aws.amazon.com/fis/latest/userguide/actions.html) im *Benutzerhandbuch für AWS Fault Injection Simulator*.
+ Einzelheiten zur API finden Sie [ListActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/list-actions.html)in der *AWS CLI Befehlsreferenz*.
### `list-experiment-templates`
Das folgende Codebeispiel zeigt die Verwendung`list-experiment-templates`.
**AWS CLI**
**So listen Sie Experimentvorlagen auf**
Das folgende `list-experiment-templates` Beispiel listet die Versuchsvorlagen in Ihrem AWS Konto auf.
```
aws fis list-experiment-templates
```
Ausgabe:
```
{
"experimentTemplates": [
{
"id": "ABCDE1fgHIJkLmNop",
"description": "myExperimentTemplate",
"creationTime": 1616017191.124,
"lastUpdateTime": 1616017191.124,
"tags": {
"key": "value"
}
}
]
}
```
Weitere Informationen finden Sie unter [Experimentvorlagen](https://docs.aws.amazon.com/fis/latest/userguide/experiment-templates.html) im *Benutzerhandbuch für AWS Fault Injection Simulator*.
+ Einzelheiten zur API finden Sie [ListExperimentTemplates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/list-experiment-templates.html)in der *AWS CLI Befehlsreferenz*.
### `list-experiments`
Das folgende Codebeispiel zeigt die Verwendung`list-experiments`.
**AWS CLI**
**So listen Sie Experimente auf**
Das folgende `list-experiments` Beispiel listet die Experimente in Ihrem AWS Konto auf.
```
aws fis list-experiments
```
Ausgabe:
```
{
"experiments": [
{
"id": "ABCdeF1GHiJkLM23NO",
"experimentTemplateId": "ABCDE1fgHIJkLmNop",
"state": {
"status": "running",
"reason": "Experiment is running."
},
"creationTime": 1616017341.197,
"tags": {
"key": "value"
}
}
]
}
```
Weitere Informationen finden Sie unter [Experimente](https://docs.aws.amazon.com/fis/latest/userguide/experiments.html) im *Benutzerhandbuch für AWS Fault Injection Simulator*.
+ Einzelheiten zur API finden Sie [ListExperiments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/list-experiments.html)in der *AWS CLI Befehlsreferenz*.
### `list-tags-for-resource`
Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`.
**AWS CLI**
**So listen Sie Tags für eine Ressource auf**
Im folgenden Beispiel für `list-tags-for-resource` werden die Tags für die angegebene Ressource aufgelistet.
```
aws fis list-tags-for-resource \
--resource-arn arn:aws:fis:us-west-2:123456789012:experiment/ABC12DeFGhI3jKLMNOP
```
Ausgabe:
```
{
"tags": {
"key1": "value1",
"key2": "value2"
}
}
```
Weitere Informationen finden Sie unter [Taggen Ihrer AWS FIS-Ressourcen im AWS Fault](https://docs.aws.amazon.com/fis/latest/userguide/tagging.html) *Injection Simulator-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz.*
### `start-experiment`
Das folgende Codebeispiel zeigt die Verwendung`start-experiment`.
**AWS CLI**
**So starten Sie ein Experiment**
Im folgenden Beispiel für `start-experiment` wird das angegebene Experiment gestartet.
```
aws fis start-experiment \
--experiment-template-id ABCDE1fgHIJkLmNop
```
Ausgabe:
```
{
"experiment": {
"id": "ABC12DeFGhI3jKLMNOP",
"experimentTemplateId": "ABCDE1fgHIJkLmNop",
"roleArn": "arn:aws:iam::123456789012:role/myRole",
"state": {
"status": "initiating",
"reason": "Experiment is initiating."
},
"targets": {
"Instances-Target-1": {
"resourceType": "aws:ec2:instance",
"resourceArns": [
"arn:aws:ec2:us-west-2:123456789012:instance/i-12a3b4c56d78e9012"
],
"selectionMode": "ALL"
}
},
"actions": {
"reboot": {
"actionId": "aws:ec2:reboot-instances",
"parameters": {},
"targets": {
"Instances": "Instances-Target-1"
},
"state": {
"status": "pending",
"reason": "Initial state"
}
}
},
"stopConditions": [
{
"source": "none"
}
],
"creationTime": 1616432464.025,
"startTime": 1616432464.374,
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [Experiments for AWS FIS im AWS Fault](https://docs.aws.amazon.com/fis/latest/userguide/experiments.html) *Injection Simulator-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [StartExperiment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/start-experiment.html)in der *AWS CLI Befehlsreferenz.*
### `stop-experiment`
Das folgende Codebeispiel zeigt die Verwendung`stop-experiment`.
**AWS CLI**
**So stoppen Sie ein Experiment**
Im folgenden Beispiel für `stop-experiment` wird die Ausführung des angegebenen Experiments gestoppt.
```
aws fis stop-experiment \
--id ABC12DeFGhI3jKLMNOP
```
Ausgabe:
```
{
"experiment": {
"id": "ABC12DeFGhI3jKLMNOP",
"experimentTemplateId": "ABCDE1fgHIJkLmNop",
"roleArn": "arn:aws:iam::123456789012:role/myRole",
"state": {
"status": "stopping",
"reason": "Stopping Experiment."
},
"targets": {
"Instances-Target-1": {
"resourceType": "aws:ec2:instance",
"resourceArns": [
"arn:aws:ec2:us-west-2:123456789012:instance/i-12a3b4c56d78e9012"
],
"selectionMode": "ALL"
}
},
"actions": {
"reboot": {
"actionId": "aws:ec2:reboot-instances",
"parameters": {},
"targets": {
"Instances": "Instances-Target-1"
},
"startAfter": [
"wait"
],
"state": {
"status": "pending",
"reason": "Initial state."
}
},
"wait": {
"actionId": "aws:fis:wait",
"parameters": {
"duration": "PT5M"
},
"state": {
"status": "running",
"reason": ""
}
}
},
"stopConditions": [
{
"source": "none"
}
],
"creationTime": 1616432680.927,
"startTime": 1616432681.177,
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [Experiments for AWS FIS im AWS Fault](https://docs.aws.amazon.com/fis/latest/userguide/experiments.html) *Injection Simulator-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [StopExperiment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/stop-experiment.html)in der *AWS CLI Befehlsreferenz.*
### `tag-resource`
Das folgende Codebeispiel zeigt die Verwendung`tag-resource`.
**AWS CLI**
**So taggen Sie eine Ressource**
Im folgenden Beispiel für `tag-resource` wird die angegebene Ressource mit einem Tag versehen.
```
aws fis tag-resource \
--resource-arn arn:aws:fis:us-west-2:123456789012:experiment/ABC12DeFGhI3jKLMNOP \
--tags key1=value1,key2=value2
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Taggen Ihrer AWS FIS-Ressourcen im AWS Fault](https://docs.aws.amazon.com/fis/latest/userguide/tagging.html) *Injection Simulator-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/tag-resource.html)in der *AWS CLI Befehlsreferenz.*
### `untag-resource`
Das folgende Codebeispiel zeigt die Verwendung`untag-resource`.
**AWS CLI**
**So entfernen Sie Tags von einer Ressource**
Im folgenden Beispiel für `untag-resource` werden die Tags von der angegebenen Ressource entfernt.
```
aws fis untag-resource \
--resource-arn arn:aws:fis:us-west-2:123456789012:experiment/ABC12DeFGhI3jKLMNOP
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Taggen Ihrer AWS FIS-Ressourcen im AWS Fault](https://docs.aws.amazon.com/fis/latest/userguide/tagging.html) *Injection Simulator-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/untag-resource.html)in der *AWS CLI Befehlsreferenz.*
### `update-experiment-template`
Das folgende Codebeispiel zeigt die Verwendung`update-experiment-template`.
**AWS CLI**
**So aktualisieren Sie eine Experimentvorlage**
Im folgenden Beispiel für `update-experiment-template` wird die Beschreibung der angegebenen Experimentvorlage aktualisiert.
```
aws fis update-experiment-template \
--id ABCDE1fgHIJkLmNop \
---description myExperimentTemplate
```
Ausgabe:
```
{
"experimentTemplate": {
"id": "ABCDE1fgHIJkLmNop",
"description": "myExperimentTemplate",
"targets": {
"Instances-Target-1": {
"resourceType": "aws:ec2:instance",
"resourceArns": [
"arn:aws:ec2:us-west-2:123456789012:instance/i-12a3b4c56d78e9012"
],
"selectionMode": "ALL"
}
},
"actions": {
"testaction": {
"actionId": "aws:ec2:stop-instances",
"parameters": {},
"targets": {
"Instances": "Instances-Target-1"
}
}
},
"stopConditions": [
{
"source": "none"
}
],
"creationTime": 1616017191.124,
"lastUpdateTime": 1616017859.607,
"roleArn": "arn:aws:iam::123456789012:role/FISRole",
"tags": {
"key": "value"
}
}
}
```
Weitere Informationen finden Sie unter [Aktualisieren einer Experimentvorlage](https://docs.aws.amazon.com/fis/latest/userguide/working-with-templates.html#update-template) im *Benutzerhandbuch für AWS Fault Injection Simulator*.
+ Einzelheiten zur API finden Sie [UpdateExperimentTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/update-experiment-template.html)in der *AWS CLI Befehlsreferenz*.