

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.

# Amazon EBS


 AWS Systems Manager Automation stellt vordefinierte Runbooks für Amazon Elastic Block Store bereit. Ausführliche Informationen zum Anzeigen von Runbook-Inhalten finden Sie unter [Working with runbooks](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-documents.html). Informationen zum Anzeigen von Runbook-Inhalten finden Sie unter. [Runbook-Inhalte anzeigen](automation-runbook-reference.md#view-automation-json) 

**Topics**
+ [

# `AWSSupport-AnalyzeEBSResourceUsage`
](automation-aws-analyze-ebs-resource-usage.md)
+ [

# `AWS-ArchiveEBSSnapshots`
](aws-archiveebssnapshots.md)
+ [

# `AWS-AttachEBSVolume`
](automation-aws-attachebsvolume.md)
+ [

# `AWSSupport-CalculateEBSPerformanceMetrics`
](automation-calculate-ebs-performance-metrics.md)
+ [

# `AWS-CopySnapshot`
](automation-aws-copysnapshot.md)
+ [

# `AWS-CreateSnapshot`
](automation-aws-createsnapshot.md)
+ [

# `AWS-DeleteSnapshot`
](automation-aws-deletesnapshot.md)
+ [

# `AWSConfigRemediation-DeleteUnusedEBSVolume`
](automation-aws-delete-ebs-volume.md)
+ [

# `AWS-DeregisterAMIs`
](aws-deregisteramis.md)
+ [

# `AWS-DetachEBSVolume`
](automation-aws-detachebsvolume.md)
+ [

# `AWSConfigRemediation-EnableEbsEncryptionByDefault`
](automation-aws-enable-ebs-encryption.md)
+ [

# `AWS-ExtendEbsVolume`
](aws-extendebsvolume.md)
+ [

# `AWSSupport-ModifyEBSSnapshotPermission`
](automation-awssupport-modifyebssnapshotpermission.md)
+ [

# `AWSConfigRemediation-ModifyEBSVolumeType`
](automation-aws-modify-ebs-type.md)

# `AWSSupport-AnalyzeEBSResourceUsage`


 **Beschreibung** 

 Das `AWSSupport-AnalyzeEBSResourceUsage` Automation Runbook wird verwendet, um die Ressourcennutzung im Amazon Elastic Block Store (Amazon EBS) zu analysieren. Es analysiert die Datenträgernutzung und identifiziert aufgegebene Volumes, Bilder und Snapshots in einer bestimmten Region. AWS 

 **Wie funktioniert es?** 

Das Runbook führt die folgenden vier Aufgaben aus:

1. Überprüft, ob ein Amazon Simple Storage Service (Amazon S3) -Bucket existiert, oder erstellt einen neuen Amazon S3-Bucket.

1. Sammelt alle Amazon EBS-Volumes im verfügbaren Status.

1. Sammelt alle Amazon EBS-Snapshots, für die das Quellvolume gelöscht wurde.

1. Sammelt alle Amazon Machine Images (AMIs), die nicht von nicht terminierten Amazon Elastic Compute Cloud (Amazon EC2) -Instances verwendet werden.

 Das Runbook generiert CSV-Berichte und speichert sie in einem vom Benutzer bereitgestellten Amazon S3 S3-Bucket. Der bereitgestellte Bucket sollte gemäß den am Ende beschriebenen bewährten AWS Sicherheitsmethoden gesichert werden. Wenn der vom Benutzer angegebene Amazon S3 S3-Bucket nicht im Konto vorhanden ist, erstellt das Runbook einen neuen Amazon S3 S3-Bucket im Namensformat`<User-provided-name>-awssupport-YYYY-MM-DD`, verschlüsselt mit einem benutzerdefinierten Schlüssel AWS Key Management Service (AWS KMS), mit aktivierter Objektversionierung, blockiertem öffentlichen Zugriff und erfordert Anfragen zur Verwendung von SSL/TLS. 

 Wenn Sie Ihren eigenen Amazon S3 S3-Bucket angeben möchten, stellen Sie bitte sicher, dass er gemäß den folgenden bewährten Methoden konfiguriert ist: 
+ Sperren Sie den öffentlichen Zugriff auf den Bucket (eingestellt `IsPublic` auf`False`).
+ Aktivieren Sie die Amazon S3 S3-Zugriffsprotokollierung.
+ [Erlauben Sie nur SSL-Anfragen an Ihren Bucket](https://repost.aws/knowledge-center/s3-bucket-policy-for-config-rule).
+ Aktivieren Sie die Objektversionierung.
+ Verwenden Sie einen Schlüssel AWS Key Management Service (AWS KMS), um Ihren Bucket zu verschlüsseln.

**Wichtig**  
Bei der Verwendung dieses Runbooks können zusätzliche Gebühren für Ihr Konto für die Erstellung von Amazon S3 S3-Buckets und -Objekten anfallen. Weitere Informationen zu den möglicherweise anfallenden Gebühren finden Sie unter [Amazon S3 S3-Preise](https://aws.amazon.com/s3/pricing/).

**Art des Dokuments**

Automatisierung

**Eigentümer**

Amazon

**Plattformen**

Linux,macOS, Windows

**Parameter**
+ AutomationAssumeRole

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, mit der Systems Manager Automation die Aktionen in Ihrem Namen ausführen kann. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.
+ S3 BucketName

  Typ: `AWS::S3::Bucket::Name`

  Beschreibung: (Erforderlich) Der Amazon S3 S3-Bucket in Ihrem Konto, in den der Bericht hochgeladen werden soll. Stellen Sie sicher, dass die Bucket-Richtlinie Parteien, die keinen Zugriff auf die gesammelten Protokolle benötigen, keine unnötigen read/write Berechtigungen gewährt. Wenn der angegebene Bucket nicht im Konto vorhanden ist, erstellt die Automatisierung einen neuen Bucket in der Region, in der die Automatisierung initiiert wird, mit dem Namensformat`<User-provided-name>-awssupport-YYYY-MM-DD`, verschlüsselt mit einem benutzerdefinierten AWS KMS Schlüssel.

  Zulässiges Muster: `$|^(?!(^(([0-9]{1,3}[.]){3}[0-9]{1,3}$)))^((?!xn—)(?!.*-s3alias))[a-z0-9][-.a-z0-9]{1,61}[a-z0-9]$` 
+ CustomerManagedKmsKeyArn

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der benutzerdefinierte AWS KMS Schlüssel Amazon Resource Name (ARN) zur Verschlüsselung des neuen Amazon S3 S3-Buckets, der erstellt wird, wenn der angegebene Bucket nicht im Konto vorhanden ist. Die Automatisierung schlägt fehl, wenn versucht wird, einen Bucket ohne Angabe eines benutzerdefinierten AWS KMS Schlüssel-ARN zu erstellen.

  Zulässiges Muster: `(^$|^arn:aws:kms:[-a-z0-9]:[0-9]:key/[-a-z0-9]*$)` 

**Erforderliche IAM-Berechtigungen**

Der `AutomationAssumeRole` Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.
+ `ec2:DescribeImages`
+ `ec2:DescribeInstances`
+ `ec2:DescribeSnapshots`
+ `ec2:DescribeVolumes`
+ `kms:Decrypt`
+ `kms:GenerateDataKey`
+ `s3:CreateBucket`
+ `s3:GetBucketAcl`
+ `s3:GetBucketPolicyStatus`
+ `s3:GetBucketPublicAccessBlock`
+ `s3:ListBucket`
+ `s3:ListAllMyBuckets`
+ `s3:PutObject`
+ `s3:PutBucketLogging`
+ `s3:PutBucketPolicy`
+ `s3:PutBucketPublicAccessBlock`
+ `s3:PutBucketTagging`
+ `s3:PutBucketVersioning`
+ `s3:PutEncryptionConfiguration`
+ `ssm:DescribeAutomationExecutions`

 **Beispielrichtlinie mit mindestens erforderlichen IAM-Berechtigungen zum Ausführen dieses Runbooks:** 

------
#### [ JSON ]

****  

```
        {
            "Version":"2012-10-17",		 	 	 
            "Statement": [{
                "Sid": "ReadOnlyPermissions",
                "Effect": "Allow",
                "Action": [
                    "ec2:DescribeImages",
                    "ec2:DescribeInstances",
                    "ec2:DescribeSnapshots",
                    "ec2:DescribeVolumes",
                    "ssm:DescribeAutomationExecutions"
                ],
                "Resource": "*"
            }, {
                "Sid": "KMSGeneratePermissions",
                "Effect": "Allow",
                "Action": ["kms:GenerateDataKey", "kms:Decrypt"],
                "Resource": "arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"
            }, {
                "Sid": "S3ReadOnlyPermissions",
                "Effect": "Allow",
                "Action": [
                    "s3:GetBucketAcl",
                    "s3:GetBucketPolicyStatus",
                    "s3:GetBucketPublicAccessBlock",
                    "s3:ListBucket"
                ],
                "Resource": [
                    "arn:aws:s3:::amzn-s3-demo-bucket1",
                    "arn:aws:s3:::amzn-s3-demo-bucket2/"
                ]
            }, {
                "Sid": "S3CreatePermissions",
                "Effect": "Allow",
                "Action": [
                    "s3:CreateBucket",
                    "s3:PutObject",
                    "s3:PutBucketLogging",
                    "s3:PutBucketPolicy",
                    "s3:PutBucketPublicAccessBlock",
                    "s3:PutBucketTagging",
                    "s3:PutBucketVersioning",
                    "s3:PutEncryptionConfiguration"
                ],
                "Resource": "*"
            }]
        }
```

------

 **Anweisungen** 

Gehen Sie wie folgt vor, um die Automatisierung zu konfigurieren:

1. Navigieren Sie [AWSSupport-AnalyzeEBSResourceUsage](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-AnalyzeEBSResourceUsage/description)in der AWS Systems Manager Konsole zum.

1. Geben Sie für die Eingabeparameter Folgendes ein:
   + **AutomationAssumeRole (Fakultativ):**

     Der Amazon-Ressourcenname (ARN) der Rolle AWS Identity and Access Management (IAM), der es Systems Manager Automation ermöglicht, die Aktionen in Ihrem Namen durchzuführen. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.
   + **S3 BucketName (erforderlich):**

     Der Amazon S3 S3-Bucket in Ihrem Konto, in den Sie den Bericht hochladen möchten.
   + **CustomerManagedKmsKeyArn(Fakultativ):**

     Der benutzerdefinierte AWS KMS Schlüssel Amazon Resource Name (ARN) für die Verschlüsselung des neuen Amazon S3 S3-Buckets, der erstellt wird, wenn der angegebene Bucket nicht im Konto vorhanden ist.  
![\[Input parameters for S3 bucket configuration, including bucket name and KMS key ARN.\]](http://docs.aws.amazon.com/de_de/systems-manager-automation-runbooks/latest/userguide/images/awssupport-analyze-ebs-resource-usage_input_parameters.png)

1. Wählen Sie **Ausführen aus**.

1. Die Automatisierung wird initiiert.

1. Das Automatisierungs-Runbook führt die folgenden Schritte aus:
   + **Parallelität prüfen:**

     Stellt sicher, dass dieses Runbook in der Region nur einmal initiiert wird. Wenn das Runbook feststellt, dass gerade eine weitere Ausführung ausgeführt wird, gibt es einen Fehler zurück und wird beendet.
   + **verifyOrCreateS3-Bucket:**

     Überprüft, ob der Amazon S3 S3-Bucket existiert. Wenn nicht, erstellt es einen neuen Amazon S3 S3-Bucket in der Region, in der die Automatisierung initiiert wird, mit dem Namensformat`<User-provided-name>-awssupport-YYYY-MM-DD`, verschlüsselt mit einem benutzerdefinierten AWS KMS Schlüssel.
   + **gatherAmiDetails:**

     Sucht nach AMIs, die von keiner Amazon EC2 EC2-Instance verwendet werden, generiert den Bericht im Namensformat `<region>-images.csv` und lädt ihn in den Amazon S3 S3-Bucket hoch.
   + **gatherVolumeDetails:**

     Überprüft Amazon EBS-Volumes im verfügbaren Status, generiert den Bericht im Namensformat `<region>-volume.csv` und lädt ihn in einen Amazon S3 S3-Bucket hoch.
   + **gatherSnapshotDetails:**

     Sucht nach den Amazon EBS-Snapshots der Amazon EBS-Volumes, die bereits gelöscht wurden, generiert den Bericht mit dem Namensformat und lädt ihn in den Amazon `<region>-snapshot.csv` S3 S3-Bucket hoch.

1. Wenn der Vorgang abgeschlossen ist, finden Sie im Abschnitt Ausgaben die detaillierten Ergebnisse der Ausführung.  
![\[Output details showing volume, AMI, and snapshot information for AWS resources.\]](http://docs.aws.amazon.com/de_de/systems-manager-automation-runbooks/latest/userguide/images/awssupport-analyze-ebs-resource-usage_outputs.png)

 **Referenzen** 

Systems Manager Automation
+ [Führen Sie diese Automatisierung aus (Konsole)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-AnalyzeEBSResourceUsage)
+ [Führen Sie eine Automatisierung aus](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html)
+ [Eine Automatisierung einrichten](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-setup.html)
+ [Landingpage für Support-Automatisierungsworkflows](https://aws.amazon.com/premiumsupport/technology/saw/)

# `AWS-ArchiveEBSSnapshots`


 **Beschreibung** 

 Das `AWS-ArchiveEBSSnapshots` Runbook hilft Ihnen beim Archivieren von Snapshots für Amazon Elastic Block Store (Amazon EBS) -Volumes, indem es das Tag angibt, das Sie auf Ihre Snapshots angewendet haben. Alternativ können Sie die ID eines Volumes angeben, wenn Ihre Snapshots nicht markiert sind.

 [Führen Sie diese Automatisierung aus (Konsole)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-ArchiveEBSSnapshots) 

**Art des Dokuments**

Automatisierung

**Eigentümer**

Amazon

**Plattformen**

LinuxmacOS, Windows

**Parameter**
+ AutomationAssumeRole

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, mit der Systems Manager Automation die Aktionen in Ihrem Namen ausführen kann. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.
+ Description

  Typ: Zeichenfolge

  Beschreibung: (Optional) Eine Beschreibung für den Amazon EBS-Snapshot.
+ DryRun

  Typ: Zeichenfolge

  Gültige Werte: Ja \$1 Nein

  Beschreibung: (Erforderlich) Überprüft, ob Sie über die erforderlichen Berechtigungen für die Aktion verfügen, ohne die Anfrage tatsächlich zu stellen, und gibt eine Fehlermeldung aus.
+ RetentionCount

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die Anzahl der Snapshots, die Sie archivieren möchten. Geben Sie keinen Wert für diesen Parameter an, wenn Sie einen Wert für `RetentionDays` angeben.
+ RetentionDays

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die Anzahl der Snapshots aus früheren Tagen, die Sie archivieren möchten. Geben Sie keinen Wert für diesen Parameter an, wenn Sie einen Wert für `RetentionCount` angeben.
+ SnapshotWithTag

  Typ: Zeichenfolge

  Gültige Werte: Ja \$1 Nein

  Beschreibung: (Erforderlich) Gibt an, ob die Snapshots, die Sie archivieren möchten, markiert sind.
+ TagKey

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der Schlüssel des Tags, das den Snapshots zugewiesen ist, die Sie archivieren möchten.
+ TagValue

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der Wert des Tags, das den Snapshots zugewiesen ist, die Sie archivieren möchten.
+ VolumeId

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die ID des Volumes, dessen Snapshots Sie archivieren möchten. Verwenden Sie diesen Parameter, wenn Ihre Snapshots nicht markiert sind.

**Erforderliche IAM-Berechtigungen**

Der `AutomationAssumeRole` Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.
+  `ec2:ArchiveSnapshots` 
+  `ec2:DescribeSnapshots` 

 **Dokumentschritte** 

`aws:executeScript`- Archiviert Schnappschüsse mit dem Tag, den Sie mit den `TagValue` Parametern `TagKey` und oder dem `VolumeId` Parameter angeben.

# `AWS-AttachEBSVolume`


 **Beschreibung** 

Hängen Sie ein Amazon Elastic Block Store (Amazon EBS) -Volume an eine Amazon Elastic Compute Cloud (Amazon EC2) -Instance an.

 [Führen Sie diese Automatisierung (Konsole) aus](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-AttachEBSVolume) 

**Art des Dokuments**

Automatisierung

**Eigentümer**

Amazon

**Plattformen**

LinuxmacOS, Windows

**Parameter**
+ AutomationAssumeRole

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, mit der Systems Manager Automation die Aktionen in Ihrem Namen ausführen kann. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.
+ Gerät

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Der Gerätename (z. B. dev/sdh oder xvdh).
+ InstanceId

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Die ID der Instance, der Sie das Volume anfügen möchten.
+ VolumeId

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Die ID des Amazon EBS-Volumes. Volume und Instance müssen sich in derselben Availability Zone befinden.

# `AWSSupport-CalculateEBSPerformanceMetrics`


 **Beschreibung** 

 Das `AWSSupport-CalculateEBSPerformanceMetrics` Runbook hilft bei der Diagnose von Amazon EBS-Leistungsproblemen, indem es Leistungskennzahlen berechnet und in einem CloudWatch Dashboard veröffentlicht. Das Dashboard zeigt die geschätzten durchschnittlichen IOPS und den geschätzten Durchsatz für ein Amazon EBS-Zielvolume oder alle Volumes an, die an die Amazon Elastic Compute Cloud (Amazon EC2) -Zielinstanz angehängt sind. Für Amazon EC2 EC2-Instances werden auch die durchschnittlichen IOPS und der Durchsatz der Instance angezeigt. Das Runbook gibt den Link zum neu erstellten CloudWatch Dashboard aus, in dem die relevanten berechneten Metriken angezeigt werden. CloudWatch Das CloudWatch Dashboard wird in Ihrem Konto mit dem Namen erstellt:`AWSSupport-<ResourceId>-EBS-Performance-<automation:EXECUTION_ID>`. 

 **Wie funktioniert es?** 

 Das Runbook führt die folgenden Schritte aus: 
+ Stellt sicher, dass die angegebenen Zeitstempel gültig sind.
+ Überprüft, ob die Ressourcen-ID (Amazon EBS Volume oder Amazon EC2 EC2-Instance) gültig ist.
+ Wenn Sie eine Amazon EC2 als ResourceID angeben, wird ein CloudWatch Dashboard mit der tatsächlichen Gesamtsumme IOPS/Throughput für diese Amazon EC2 EC2-Instance und dem Diagramm mit dem geschätzten durchschnittlichen IOPS/Durchsatz für alle Amazon EBS-Volumes erstellt, die an eine Amazon EC2 EC2-Instance angehängt sind.
+ Wenn Sie ein Amazon EBS-Volumen als ResourceID angeben, wird ein CloudWatch Dashboard mit dem IOPS/Throughput Diagramm „Geschätzter Durchschnitt“ für dieses Volumen erstellt.
+ Wenn nach der Generierung des CloudWatch Dashboards der geschätzte durchschnittliche IOPS oder der geschätzte durchschnittliche Durchsatz höher als der maximale IOPS bzw. der maximale Durchsatz ist, ist Microbursting für das Volume oder die Volumes möglich, die an eine Amazon EC2 EC2-Instance angehängt sind. 

**Anmerkung**  
 Bei Burst-Volumes (gp2, sc2 und st1) IOPS/throughput sollte das Maximum berücksichtigt werden, bis Sie den Burst-Balance erreicht haben. Wenn das Burst-Balancing vollständig ausgelastet ist, d. h. es Null wird, sollten Sie die Basiskennzahlen berücksichtigen. IOPS/throughput 

**Wichtig**  
 Die Erstellung des CloudWatch Dashboards kann zu zusätzlichen Gebühren für Ihr Konto führen. Weitere Informationen finden Sie im [ CloudWatchAmazon-Preisleitfaden](https://aws.amazon.com/cloudwatch/pricing). 

 [Führen Sie diese Automatisierung aus (Konsole)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-CalculateEBSPerformanceMetrics) 

**Art des Dokuments**

Automatisierung

**Eigentümer**

Amazon

**Plattformen**

LinuxmacOS, Windows

**Parameter**

**Erforderliche IAM-Berechtigungen**

Der `AutomationAssumeRole` Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.
+ `ec2:DescribeVolumes`
+ `ec2:DescribeInstances`
+ `ec2:DescribeInstanceTypes`
+ `cloudwatch:PutDashboard`

Beispiel für eine Richtlinie

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": "cloudwatch:PutDashboard",
            "Resource": "arn:aws:cloudwatch::111122223333:dashboard/*-EBS-Performance-*"
        },
        {
            "Sid": "VisualEditor1",
            "Effect": "Allow",
            "Action": [
                "ec2:DescribeInstances",
                "ec2:DescribeVolumes",
                "ec2:DescribeInstanceTypes"
            ],
            "Resource": "*"
        }
    ]
}
```

------

 **Anweisungen** 

Gehen Sie wie folgt vor, um die Automatisierung zu konfigurieren:

1. Navigieren Sie [https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CalculateEBSPerformanceMetrics/description](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CalculateEBSPerformanceMetrics/description)im Systems Manager unter Dokumente zu.

1. Wählen Sie Execute automation (Automatisierung ausführen).

1. Geben Sie für die Eingabeparameter Folgendes ein:
   + **AutomationAssumeRole (Fakultativ):**

     Der Amazon-Ressourcenname (ARN) der Rolle AWS AWS Identity and Access Management (IAM), der es Systems Manager Automation ermöglicht, die Aktionen in Ihrem Namen durchzuführen. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.
   + **ResourceID (erforderlich):**

     Die ID der Amazon EC2 EC2-Instance oder des Amazon EBS-Volumes.
   + **Startzeit (erforderlich):**

     Die Startzeit, in der die Daten angezeigt werden sollen CloudWatch. Die Uhrzeit muss im Format `yyyy-mm-ddThh:mm:ss` und in UTC angegeben werden.
   + **Endzeit (erforderlich):**

     Die Endzeit, in der die Daten angezeigt werden sollen CloudWatch. Die Uhrzeit muss im Format `yyyy-mm-ddThh:mm:ss` und in UTC angegeben werden.  
![\[Input parameters form for AWS Systems Manager Automation with fields for role, resource ID, and time range.\]](http://docs.aws.amazon.com/de_de/systems-manager-automation-runbooks/latest/userguide/images/awssupport-calculate-ebs-performance-metrics_input_parameters.png)

1. Wählen Sie Ausführen aus.

1. Die Automatisierung wird eingeleitet.

1. Das Dokument führt die folgenden Schritte aus:
   + **CheckResourceIdAndTimeStamps:**

     Überprüft, ob die Endzeit um mindestens eine Minute länger als die Startzeit ist und ob die angegebene Ressource vorhanden ist.
   + **CreateCloudWatchDashboard:**

     Berechnet die Amazon EBS-Leistung und zeigt ein Diagramm auf der Grundlage Ihrer Ressourcen-ID an. Wenn Sie eine Amazon EBS-Volume-ID für den Parameter Resource ID angeben, erstellt dieses Runbook ein CloudWatch Dashboard mit geschätzten durchschnittlichen IOPS und dem geschätzten durchschnittlichen Durchsatz für das Amazon EBS-Volume. Wenn Sie eine Amazon EC2 EC2-Instance-ID für den Parameter Resource ID angeben, erstellt dieses Runbook ein CloudWatch Dashboard mit den durchschnittlichen Gesamt-IOPS und dem durchschnittlichen Gesamtdurchsatz für die Amazon EC2 EC2-Instance sowie mit den geschätzten durchschnittlichen IOPS und dem geschätzten durchschnittlichen Durchsatz für alle Amazon EBS-Volumes, die an die Amazon EC2 EC2-Instance angehängt sind.

1. Wenn Sie den Vorgang abgeschlossen haben, finden Sie im Abschnitt Outputs die detaillierten Ergebnisse der Ausführung:  
![\[CloudWatch dashboard creation output showing a URL link and a message with instructions.\]](http://docs.aws.amazon.com/de_de/systems-manager-automation-runbooks/latest/userguide/images/awssupport-calculate-ebs-performance-metrics_outputs.png)

    CloudWatch Beispiel-Dashboard für Ressourcen-ID als Amazon EC2 EC2-Instance  
![\[CloudWatch dashboard showing EC2 instance metrics with graphs for IOPS, throughput, and volume performance.\]](http://docs.aws.amazon.com/de_de/systems-manager-automation-runbooks/latest/userguide/images/awssupport-calculate-ebs-performance-metrics_dashboard_ec2_instance.png)

    CloudWatch Beispiel-Dashboard für Ressourcen-ID als Amazon EBS-Volume-ID  
![\[CloudWatch dashboard showing EBS volume performance metrics with IOPS and throughput graphs.\]](http://docs.aws.amazon.com/de_de/systems-manager-automation-runbooks/latest/userguide/images/awssupport-calculate-ebs-performance-metrics_dashboard_ebs_volume.png)

 **Referenzen** 

Systems Manager Automation
+ [Führen Sie diese Automatisierung aus (Konsole)](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CalculateEBSPerformanceMetrics/description)
+ [Führen Sie eine Automatisierung aus](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html)
+ [Eine Automatisierung einrichten](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-setup.html)
+ [Landingpage für Support-Automatisierungsworkflows](https://aws.amazon.com/premiumsupport/technology/saw/)

AWS Servicedokumentation
+ [Wie kann ich feststellen, ob mein Amazon EBS-Volume ein Mikro-Bursting ist, und wie kann ich dann verhindern, dass dies passiert?](https://repost.aws/knowledge-center/ebs-identify-micro-bursting)
+ [Wie verwende ich CloudWatch , um die aggregierten Amazon EBS-Leistungsmetriken für eine EC2-Instance anzuzeigen?](https://repost.aws/knowledge-center/ebs-aggregate-cloudwatch-performance)

# `AWS-CopySnapshot`


 **Beschreibung** 

Kopiert einen point-in-time Snapshot eines Amazon Elastic Block Store (Amazon EBS) -Volumes. Sie können den Snapshot innerhalb derselben Region AWS-Region oder von einer Region in eine andere kopieren. Kopien verschlüsselter Amazon EBS-Snapshots bleiben verschlüsselt. Kopien unverschlüsselter Snapshots bleiben unverschlüsselt. Um einen verschlüsselten Snapshot zu kopieren, der von einem anderen Konto gemeinsam genutzt wurde, benötigen Sie Berechtigungen für den KMS-Schlüssel, der zum Verschlüsseln des Snapshots verwendet wurde. Snapshots, die durch Kopieren eines anderen Snapshot erstellt wurden, haben über eine per Zufallsprinzip ausgewählte Volume-ID, die nicht für andere Zwecke verwendet werden sollte.

 [Führen Sie diese Automatisierung aus (Konsole)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-CopySnapshot) 

**Art des Dokuments**

Automatisierung

**Eigentümer**

Amazon

**Plattformen**

LinuxmacOS, Windows

**Parameter**
+ AutomationAssumeRole

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, mit der Systems Manager Automation die Aktionen in Ihrem Namen ausführen kann. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.
+ Description

  Typ: Zeichenfolge

  Beschreibung: (Optional) Eine Beschreibung für den Amazon EBS-Snapshot.
+ SnapshotId

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Die ID des zu kopierenden Amazon EBS-Snapshots.
+ SourceRegion

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Die Region, in der sich der Quell-Snapshot zurzeit befindet.

 **Dokumentschritte** 

copySnapshot — Kopiert einen Snapshot eines Amazon EBS-Volumes.

 **Ausgaben** 

copySnapshot. SnapshotId - Die ID des neuen Snapshots.

# `AWS-CreateSnapshot`


 **Beschreibung** 

Erstellen Sie einen Snapshot eines Amazon EBS-Volumes.

 [Führen Sie diese Automatisierung aus (Konsole)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-CreateSnapshot) 

**Art des Dokuments**

Automatisierung

**Eigentümer**

Amazon

**Plattformen**

LinuxmacOS, Windows

**Parameter**
+ AutomationAssumeRole

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, mit der Systems Manager Automation die Aktionen in Ihrem Namen ausführen kann. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.
+ Description

  Typ: Zeichenfolge

  Beschreibung: (Optional) Eine Beschreibung für den Snapshot.
+ VolumeId

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Die ID des Volumes.

# `AWS-DeleteSnapshot`


 **Beschreibung** 

Löschen Sie einen Snapshot eines Amazon EBS-Volumes.

 [Führen Sie diese Automatisierung aus (Konsole)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-DeleteSnapshot) 

**Art des Dokuments**

Automatisierung

**Eigentümer**

Amazon

**Plattformen**

LinuxmacOS, Windows

**Parameter**
+ AutomationAssumeRole

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, mit der Systems Manager Automation die Aktionen in Ihrem Namen ausführen kann. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.
+ SnapshotId

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Die ID des EBS-Snapshots.

# `AWSConfigRemediation-DeleteUnusedEBSVolume`


 **Beschreibung** 

 Das `AWSConfigRemediation-DeleteUnusedEBSVolume` Runbook löscht ein unbenutztes Amazon Elastic Block Store (Amazon EBS) -Volume. 

 [Führen Sie diese Automatisierung (Konsole) aus](https://console.aws.amazon.com/systems-manager/automation/execute/AWSConfigRemediation-DeleteUnusedEBSVolume) 

**Art des Dokuments**

Automatisierung

**Eigentümer**

Amazon

**Plattformen**

LinuxmacOS, Windows

**Parameter**
+ AutomationAssumeRole

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, mit der Systems Manager Automation die Aktionen in Ihrem Namen ausführen kann.
+ CreateSnapshot

  Typ: Boolescher Wert

   Beschreibung: (Optional) Wenn auf gesetzt`true`, erstellt die Automatisierung einen Snapshot des Amazon EBS-Volumes, bevor es gelöscht wird. 
+ VolumeId

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Die ID des Amazon EBS-Volumes, das Sie löschen möchten.

**Erforderliche IAM-Berechtigungen**

Der `AutomationAssumeRole` Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.
+  `ssm:StartAutomationExecution` 
+  `ssm:GetAutomationExecution` 
+  `ec2:CreateSnapshot` 
+  `ec2:DeleteVolume` 
+  `ec2:DescribeSnapshots` 
+  `ec2:DescribeVolumes` 

 **Dokumentschritte** 
+  `aws:executeScript`— Überprüft, ob das Amazon EBS-Volume, das Sie im `VolumeId` Parameter angeben, nicht verwendet wird, und erstellt je nach dem Wert, den Sie für den `CreateSnapshot` Parameter wählen, einen Snapshot. 
+  `aws:branch`- Verzweigt auf der Grundlage des Werts, den Sie für den `CreateSnapshot` Parameter ausgewählt haben. 
+  `aws:waitForAwsResourceProperty`- Wartet, bis der Snapshot abgeschlossen ist. 
+  `aws:executeAwsApi`- Löscht den Snapshot, falls die Snapshot-Erstellung fehlgeschlagen ist. 
+  `aws:executeAwsApi`- Löscht das Amazon EBS-Volume, das Sie im `VolumeId` Parameter angeben. 
+  `aws:executeScript`— Überprüft, ob das Amazon EBS-Volume gelöscht wurde. 

# `AWS-DeregisterAMIs`


 **Beschreibung** 

 Das `AWS-DeregisterAMIs` Runbook hilft Ihnen beim Abmelden Amazon Machine Images (AMIs), indem es das Tag angibt, das Sie auf Ihr angewendet haben. AMIs

 [Führen Sie diese Automatisierung aus (Konsole)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-DeregisterAMIs) 

**Art des Dokuments**

Automatisierung

**Eigentümer**

Amazon

**Plattformen**

LinuxmacOS, Windows

**Parameter**
+ AutomationAssumeRole

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, mit der Systems Manager Automation die Aktionen in Ihrem Namen ausführen kann. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.
+ DryRun

  Typ: Zeichenfolge

  Gültige Werte: Ja \$1 Nein

  Beschreibung: (Erforderlich) Überprüft, ob Sie über die erforderlichen Berechtigungen für die Aktion verfügen, ohne die Anfrage tatsächlich zu stellen, und gibt eine Fehlermeldung aus.
+ RetainNumber

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die NummerAMIs, die Sie behalten möchten. Geben Sie keinen Wert für diesen Parameter an, wenn Sie einen Wert für angeben`Age`.
+ Age

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die Anzahl der vorherigen TageAMIs, die Sie behalten möchten. Geben Sie keinen Wert für diesen Parameter an, wenn Sie einen Wert für angeben`RetainNumber`.
+ TagKey

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Der Schlüssel des Tags, das dem Tag zugewiesen istAMIs, dessen Registrierung Sie aufheben möchten.
+ TagValue

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Der Wert des Tags, das dem Tag zugewiesen istAMIs, dessen Registrierung Sie aufheben möchten.

**Erforderliche IAM-Berechtigungen**

Der `AutomationAssumeRole` Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.
+  `ec2:DeregisterImage` 
+  `ec2:DescribeImages` 

 **Dokumentschritte** 
+  `aws:executeAwsApi`- Überprüft die Werte, die Sie für die Runbook-Eingabeparameter angeben. 
+  `aws:executeAwsApi`- Die Registrierung wird AMIs mit dem Tag aufgehoben, das Sie mit den Parametern und angegeben haben. `TagKey` `TagValue` 

# `AWS-DetachEBSVolume`


 **Beschreibung** 

Trennen Sie ein Amazon EBS-Volume von einer Amazon Elastic Compute Cloud (Amazon EC2) -Instance.

 [Führen Sie diese Automatisierung (Konsole) aus](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-DetachEBSVolume) 

**Art des Dokuments**

Automatisierung

**Eigentümer**

Amazon

**Plattformen**

LinuxmacOS, Windows

**Parameter**
+ AutomationAssumeRole

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, mit der Systems Manager Automation die Aktionen in Ihrem Namen ausführen kann. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.
+ LambdaAssumeRole

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der ARN der von Lambda übernommenen Rolle
+ VolumeId

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Die ID des EBS-Volumes. Volume und Instance müssen sich in derselben Availability Zone befinden.

# `AWSConfigRemediation-EnableEbsEncryptionByDefault`


 **Beschreibung** 

 Das `AWSConfigRemediation-EnableEbsEncryptionByDefault` Runbook ermöglicht die Verschlüsselung auf allen neuen Amazon Elastic Block Store (Amazon EBS) -Volumes in AWS-Region dem AWS-Konto und auf dem Sie die Automatisierung ausführen. Volumes, die vor der Ausführung der Automatisierung erstellt wurden, sind nicht verschlüsselt. 

 [Diese Automatisierung ausführen (Konsole)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSConfigRemediation-EnableEbsEncryptionByDefault) 

**Art des Dokuments**

Automatisierung

**Eigentümer**

Amazon

**Plattformen**

LinuxmacOS, Windows

**Parameter**
+ AutomationAssumeRole

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, mit der Systems Manager Automation die Aktionen in Ihrem Namen ausführen kann.

**Erforderliche IAM-Berechtigungen**

Der `AutomationAssumeRole` Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.
+  `ec2:EnableEbsEncryptionByDefault` 
+  `ec2:GetEbsEncryptionByDefault` 
+  `ssm:StartAutomationExecution` 
+  `ssm:GetAutomationExecution` 

 **Dokumentschritte** 
+  `aws:executeAwsApi`— Aktiviert die standardmäßige Amazon EBS-Verschlüsselungseinstellung für das aktuelle Konto und die Region. 
+  `aws:assertAwsResourceProperty`— Überprüft, ob die standardmäßige Amazon EBS-Verschlüsselungseinstellung aktiviert wurde. 

# `AWS-ExtendEbsVolume`


 **Beschreibung** 

Das `AWS-ExtendEbsVolume` Runbook vergrößert ein Amazon EBS-Volume und erweitert das Dateisystem. Diese Automatisierung unterstützt die `ext4` Dateisysteme `xfs` und.

 [Führen Sie diese Automatisierung aus (Konsole)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-ExtendEbsVolume) 

**Art des Dokuments**

Automatisierung

**Eigentümer**

Amazon

**Plattformen**

Linux, Windows

**Parameter**
+ AutomationAssumeRole

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, mit der Systems Manager Automation die Aktionen in Ihrem Namen ausführen kann. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.
+ DriveLetter

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der Buchstabe des Laufwerks, dessen Dateisystem Sie erweitern möchten. Dieser Parameter ist für Windows Instanzen erforderlich.
+ InstanceId

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die ID der Amazon EC2 EC2-Instance, an die das Amazon EBS-Volume angehängt ist, das Sie erweitern möchten.
+ KeepSnapshot

  Typ: Boolescher Wert

  Standard: true

  Beschreibung: (Optional) Legt fest, ob der vor der Erhöhung der Größe Ihres Amazon EBS-Volumes erstellte Snapshot beibehalten werden soll.
+ MountPoint

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der Bereitstellungspunkt des Laufwerks, dessen Dateisystem Sie erweitern möchten. Dieser Parameter ist für Linux-Instances erforderlich.
+ SizeGib

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Die Größe in GiB, auf die Sie Ihr Amazon EBS-Volume ändern möchten.
+ VolumeId

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Die ID des EBS-Volumes, das Sie erweitern möchten.

**Erforderliche IAM-Berechtigungen**

Der `AutomationAssumeRole` Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.
+  `ec2:CreateSnapshot` 
+  `ec2:CreateTags` 
+  `ec2:DeleteSnapshot` 
+  `ec2:DescribeVolumes` 
+  `ec2:ModifyVolume` 
+  `ssm:DescribeInstanceInformation` 
+  `ssm:GetCommandInvocation` 
+  `ssm:SendCommand` 

 **Dokumentschritte** 
+  `aws:executeScript`- Erhöht die Größe des Volumes auf den Wert, den Sie im `VolumeId` Parameter angeben, und erweitert das Dateisystem. 

# `AWSSupport-ModifyEBSSnapshotPermission`


 **Beschreibung** 

 Das `AWSSupport-ModifyEBSSnapshotPermission` Runbook hilft Ihnen, die Berechtigungen für mehrere Amazon Elastic Block Store (Amazon EBS) -Snapshots zu ändern. Mit diesem Runbook können Sie Schnappschüsse erstellen `Public` oder `Private` diese mit anderen teilen. AWS-Konten Mit einem Standard-KMS-Schlüssel verschlüsselte Snapshots können nicht mit anderen Konten geteilt werden, die dieses Runbook verwenden. 

 [Führen Sie diese Automatisierung aus (Konsole)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-ModifyEBSSnapshotPermissions) 

**Art des Dokuments**

Automatisierung

**Eigentümer**

Amazon

**Plattformen**

LinuxmacOS, Windows

**Parameter**
+ AutomationAssumeRole

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, mit der Systems Manager Automation die Aktionen in Ihrem Namen ausführen kann. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.
+ AccountIds

  Typ: StringList

  Standard: keiner

   Beschreibung: (Optional) Die IDs Konten, mit denen Sie Snapshots teilen möchten. Dieser Parameter ist erforderlich, wenn Sie `No` den Wert des `Private` Parameters eingeben. 
+ AccountPermissionOperation

  Typ: Zeichenfolge

  Gültige Werte: hinzufügen \$1 entfernen

  Standard: keiner

  Beschreibung: (Optional) Die Art des auszuführenden Vorgangs.
+ Privat

  Typ: Zeichenfolge

  Gültige Werte: Ja \$1 Nein

   Beschreibung: (Erforderlich) Geben Sie `No` den Wert ein, wenn Sie Snapshots mit bestimmten Konten teilen möchten. 
+ SnapshotIds

  Typ: StringList

  Beschreibung: (Erforderlich) Die IDs Amazon EBS-Snapshots, deren Berechtigungen Sie ändern möchten.

**Erforderliche IAM-Berechtigungen**

Der `AutomationAssumeRole` Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.
+  `ssm:StartAutomationExecution` 
+  `ssm:GetAutomationExecution` 
+  `ec2:DescribeSnapshots` 
+  `ec2:ModifySnapshotAttribute` 

 **Dokumentschritte** 

1.  `aws:executeScript`- Überprüft die im IDs Parameter angegebenen Schnappschüsse. `SnapshotIds` Nach der Überprüfung von sucht das IDs Skript nach verschlüsselten Snapshots und gibt eine Liste aus, falls welche gefunden wurden. 

1.  `aws:branch`- Verzweigt die Automatisierung auf der Grundlage des Werts, den Sie für den `Private` Parameter eingeben. 

1.  `aws:executeScript`- Ändert die Berechtigungen der angegebenen Snapshots, um sie für die angegebenen Konten freizugeben. 

1.  `aws:executeScript`- Ändert die Berechtigungen der Snapshots, um sie von zu zu ändern. `Public` `Private` 

 **Ausgaben** 

ValidateSnapshots.EncryptedSnapshots

SharewithOtherAccounts. Ergebnis

MakePrivate. Ergebnis

MakePrivate. Befehle

# `AWSConfigRemediation-ModifyEBSVolumeType`


 **Beschreibung** 

 Das `AWSConfigRemediation-ModifyEBSVolumeType` Runbook ändert den Volumetyp eines Amazon Elastic Block Store (Amazon EBS) -Volumes. Nachdem der Volumetyp geändert wurde, wechselt das Volume in einen Status. `optimizing` Informationen zur Überwachung des Fortschritts von Volumenänderungen finden Sie unter [Überwachen des Fortschritts von Volumenänderungen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/monitoring-volume-modifications.html) im *Amazon EC2 EC2-Benutzerhandbuch*. 

 [Führen Sie diese Automatisierung aus (Konsole)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSConfigRemediation-ModifyEBSVolumeType) 

**Art des Dokuments**

Automatisierung

**Eigentümer**

Amazon

**Plattformen**

LinuxmacOS, Windows

**Parameter**
+ AutomationAssumeRole

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, mit der Systems Manager Automation die Aktionen in Ihrem Namen ausführen kann.
+ EbsVolumeId

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Die ID des Amazon EBS-Volumes, das Sie ändern möchten.
+ EbsVolumeType

  Typ: Zeichenfolge

  Gültige Werte: standard \$1 io1 \$1 io2 \$1 gp2 \$1 gp3 \$1 sc1 \$1 st1

   Beschreibung: Der Volumetyp, auf den Sie das Amazon EBS-Volume ändern möchten. Informationen zu Amazon EBS-Volumetypen finden Sie unter [Amazon EBS-Volumetypen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-volume-types.html) im *Amazon EC2 EC2-Benutzerhandbuch*. 

**Erforderliche IAM-Berechtigungen**

Der `AutomationAssumeRole` Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.
+  `ssm:StartAutomationExecution` 
+  `ssm:GetAutomationExecution` 
+  `ec2:DescribeVolumes` 
+  `ec2:ModifyVolume` 

 **Dokumentschritte** 
+  `aws:waitForAwsResourceProperty`- Überprüft, ob der Status des Volumes oder ist`available`. `in-use` 
+  `aws:executeAwsApi`- Ändert das Amazon EBS-Volume, das Sie im `EbsVolumeId` Parameter angeben. 
+  `aws:waitForAwsResourceProperty`- Überprüft, ob der Typ des Volumes auf den Wert geändert wurde, den Sie im Parameter angegeben haben. `EbsVolumeType` 