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. # Aliase erstellen und verwenden in AWS CLI Aliase sind Abkürzungen, die Sie in AWS Command Line Interface (AWS CLI) erstellen können, um häufig verwendete Befehle oder Skripts zu kürzen. Sie erstellen Aliasse in der `alias`-Datei in Ihrem Konfigurationsordner. **Topics** + [Voraussetzungen](#cli-usage-alias-prepreqs) + [Schritt 1: Erstellen der Aliasdatei](#cli-usage-alias-create-file) + [Schritt 2: Erstellen eines Alias](#cli-usage-alias-create-alias) + [Schritt 3: Aufruf eines Alias](#cli-usage-alias-call-alias) + [Beispiele für das Alias-Repository](#cli-usage-alias-examples) + [Ressourcen](#cli-usage-alias-references) ## Voraussetzungen Um Alias-Befehle zu verwenden, führen Sie die folgenden Schritte aus: + Installieren und Konfigurieren der AWS CLI. Weitere Informationen erhalten Sie unter [Installation oder Aktualisierung auf die neueste Version von AWS CLI](getting-started-install.md) und [Authentifizierungs- und Zugangsdaten für die AWS CLI](cli-chap-authentication.md). + Verwenden Sie eine AWS CLI Mindestversion von 1.11.24 oder 2.0.0. + (Optional) Um AWS CLI Alias-Bash-Skripten zu verwenden, müssen Sie ein Bash-kompatibles Terminal verwenden. ## Schritt 1: Erstellen der Aliasdatei Um die `alias` Datei zu erstellen, können Sie Ihre Dateinavigation und einen Texteditor verwenden oder Ihr bevorzugtes Terminal verwenden, indem Sie das Verfahren verwenden. step-by-step Verwenden Sie den folgenden Befehlsblock, um schnell Ihre Aliasdatei zu erstellen. ------ #### [ Linux and macOS ] ``` $ mkdir -p ~/.aws/cli $ echo '[toplevel]' > ~/.aws/cli/alias ``` ------ #### [ Windows ] ``` C:\> md %USERPROFILE%\.aws\cli C:\> echo [toplevel] > %USERPROFILE%/.aws/cli/alias ``` ------ **So erstellen Sie die Aliasdatei** 1. Erstellen Sie einen Ordner mit dem Namen `cli` in Ihrem AWS CLI Konfigurationsordner. Standardmäßig ist der Konfigurationsordner `~/.aws/` (Linux oder macOS) und `%USERPROFILE%\.aws\` (Windows). Sie können dies über Ihre Dateinavigation oder mit dem folgenden Befehl erstellen. ------ #### [ Linux and macOS ] ``` $ mkdir -p ~/.aws/cli ``` ------ #### [ Windows ] ``` C:\> md %USERPROFILE%\.aws\cli ``` ------ Der resultierende Standardpfad des `cli`-Ordners ist `~/.aws/cli/` unter Linux oder macOS und `%USERPROFILE%\.aws\cli` unter Windows. 1. Erstellen Sie im `cli`-Ordner eine Textdatei namens `alias` ohne Erweiterung und fügen Sie `[toplevel]` in die erste Zeile ein. Sie können diese Datei über Ihren bevorzugten Texteditor erstellen oder den folgenden Befehl verwenden. ------ #### [ Linux and macOS ] ``` $ echo '[toplevel]' > ~/.aws/cli/alias ``` ------ #### [ Windows ] ``` C:\> echo [toplevel] > %USERPROFILE%/.aws/cli/alias ``` ------ ## Schritt 2: Erstellen eines Alias Sie können einen Alias mithilfe von Basisbefehlen oder Bash-Skripten erstellen. ### Erstellen eines Basisbefehls-Alias Sie können Ihren Alias erstellen, indem Sie in der `alias`-Datei, die Sie im vorherigen Schritt erstellt haben, einen Befehl mit der folgenden Syntax hinzufügen. **Syntax** ``` aliasname = command [--options] ``` *aliasname*Das nennen Sie Ihren Alias. Das *command* ist der Befehl, den Sie aufrufen möchten, der andere Aliase enthalten kann. Sie können Optionen oder Parameter in Ihren Alias aufnehmen oder sie hinzufügen, wenn Sie Ihren Alias aufrufen. Im folgenden Beispiel wird mit dem Befehl [https://docs.aws.amazon.com/cli/latest/reference/sts/get-caller-identity.html](https://docs.aws.amazon.com/cli/latest/reference/sts/get-caller-identity.html) ein Alias namens `aws whoami` erstellt. Da dieser Alias einen vorhandenen AWS CLI -Befehl aufruft, können Sie den Befehl ohne `aws`-Präfix schreiben. ``` whoami = sts get-caller-identity ``` Im folgenden Beispiel wird das vorherige `whoami`-Beispiel verwendet und die `Account`-Filter- und Textoptionen `output` hinzugefügt. ``` whoami2 = sts get-caller-identity --query Account --output text ``` ### Erstellen eines Alias für Unterbefehle **Anmerkung** Die Aliasfunktion für Unterbefehle erfordert eine AWS CLI Mindestversion von 1.11.24 oder 2.0.0 Sie können einen Alias für Unterbefehle erstellen, indem Sie in der `alias`-Datei, die Sie im vorherigen Schritt erstellt haben, einen Befehl mit der folgenden Syntax hinzufügen. **Syntax** ``` [command commandGroup] aliasname = command [--options] ``` Das *commandGroup* ist der Befehlsnamespace, z. B. Der Befehl `aws ec2 describe-regions` befindet sich unter der Befehlsgruppe. `ec2` Das *aliasname* ist das, was du deinen Alias nennst. Das *command* ist der Befehl, den Sie aufrufen möchten, der andere Aliase enthalten kann. Sie können Optionen oder Parameter in Ihren Alias aufnehmen oder sie hinzufügen, wenn Sie Ihren Alias aufrufen. Im folgenden Beispiel wird mit dem Befehl [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-regions.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-regions.html) ein Alias namens `aws ec2 regions` erstellt. Da dieser Alias einen vorhandenen AWS CLI -Befehl unter dem Befehls-Namespace `ec2` aufruft, können Sie den Befehl ohne das Präfix `aws ec2` schreiben. ``` [command ec2] regions = describe-regions --query Regions[].RegionName ``` Um Aliasse von Befehlen außerhalb des Befehls-Namespace zu erstellen, stellen Sie dem vollständigen Befehl ein Ausrufezeichen voran. Im folgenden Beispiel wird mit dem Befehl [https://docs.aws.amazon.com/cli/latest/reference/iam/list-instance-profiles.html](https://docs.aws.amazon.com/cli/latest/reference/iam/list-instance-profiles.html) ein Alias namens `aws ec2 instance-profiles` erstellt. ``` [command ec2] instance-profiles = !aws iam list-instance-profiles ``` **Anmerkung** Aliasse verwenden nur bestehende Befehls-Namespaces und Sie können keine neuen erstellen. Sie können beispielsweise keinen Alias mit dem Abschnitt `[command johnsmith]` erstellen, da der Befehls-Namespace `johnsmith` noch nicht vorhanden ist. ### Erstellen eines Bash-Scripting-Alias **Warnung** Um AWS CLI Alias-Bash-Skripten zu verwenden, müssen Sie ein Bash-kompatibles Terminal verwenden Sie können einen Alias mit Bash-Skripten für erweiterte Prozesse mit der folgenden Syntax erstellen. **Syntax** ``` aliasname = !f() { script content }; f ``` *aliasname*Das nennen Sie Ihren Alias und das Skript, *script content* das Sie ausführen möchten, wenn Sie den Alias aufrufen. Im folgenden Beispiel wird `opendns` verwendet, um Ihre aktuelle IP-Adresse auszugeben. Da Sie Aliasse in anderen Aliassen verwenden können, ist der folgende `myip`-Alias nützlich, um den Zugriff für Ihre IP-Adresse aus anderen Aliassen heraus zuzulassen oder zu widerrufen. ``` myip = !f() { dig +short myip.opendns.com @resolver1.opendns.com }; f ``` Das folgende Skriptbeispiel ruft den vorherigen `aws myip`-Alias auf, um Ihre IP-Adresse für einen eingehenden Amazon-EC2-Sicherheitsgruppen-Eingang zu autorisieren. ``` authorize-my-ip = !f() { ip=$(aws myip) aws ec2 authorize-security-group-ingress --group-id ${1} --cidr $ip/32 --protocol tcp --port 22 }; f ``` Wenn Sie Aliasse aufrufen, die Bash-Skripting verwenden, werden die Variablen immer in der Reihenfolge übergeben, in der Sie sie eingegeben haben. Beim Bash-Skripting werden die Variablennamen nicht berücksichtigt, sondern nur die Reihenfolge, in der sie erscheinen. Im folgenden `textalert`-Alias-Beispiel ist die Variable für die `--message`-Option die erste und die `--phone-number`-Option ist die zweite. ``` textalert = !f() { aws sns publish --message "${1}" --phone-number ${2} }; f ``` ## Schritt 3: Aufruf eines Alias Verwenden Sie die folgende Syntax, um den in Ihrer `alias`-Datei erstellten Alias auszuführen. Sie können zusätzliche Optionen hinzufügen, wenn Sie Ihren Alias aufrufen. **Syntax** ``` $ aws aliasname ``` Im folgenden Beispiel wird der Befehlsalias `aws whoami` verwendet. ``` $ aws whoami { "UserId": "A12BCD34E5FGHI6JKLM", "Account": "1234567890987", "Arn": "arn:aws:iam::1234567890987:user/userName" } ``` Im folgenden Beispiel wird der `aws whoami`-Alias mit zusätzlichen Optionen verwendet, um nur die `Account`-Zahl in der `text`-Ausgabe zurückzugeben. ``` $ aws whoami --query Account --output text 1234567890987 ``` Im folgenden Beispiel wird der [Unterbefehlsalias](#cli-usage-alias-create-alias-sub-command) `aws ec2 regions` verwendet. ``` $ aws ec2 regions [ "ap-south-1", "eu-north-1", "eu-west-3", "eu-west-2", ... ``` ### Aufrufen eines Alias mit Bash-Skriptvariablen Wenn Sie Aliasse aufrufen, die Bash-Skripting verwenden, werden Variablen in der Reihenfolge übergeben, in der sie eingegeben werden. Beim Bash-Skripting wird der Name der Variablen nicht berücksichtigt, sondern nur die Reihenfolge, in der sie erscheinen. Im folgenden `textalert`-Alias beispielsweise ist die Variable für die Option `--message` die erste und `--phone-number` die zweite. ``` textalert = !f() { aws sns publish --message "${1}" --phone-number ${2} }; f ``` Wenn Sie den `textalert`-Alias aufrufen, müssen Sie Variablen in der gleichen Reihenfolge übergeben, in der sie im Alias ausgeführt werden. Im folgenden Beispiel verwenden wir die Variablen `$message` und `$phone`. Die `$message`-Variable wird als `${1}` für die `--message`-Option und die `$phone`-Variable wird als `${2}` für die `--phone-number`-Option übergeben. Dies führt zu einem erfolgreichen Aufruf des `textalert`-Alias, um eine Nachricht zu senden. ``` $ aws textalert $message $phone { "MessageId": "1ab2cd3e4-fg56-7h89-i01j-2klmn34567" } ``` Im folgenden Beispiel wird die Bestellung umgeschaltet, wenn Sie den Alias in `$phone` und `$message` aufrufen. Die `$phone`-Variable wird als `${1}` für die `--message`-Option und die `$message`-Variable wird als `${2}` für die `--phone-number`-Option übergeben. Da die Variablen nicht in Ordnung sind, übergibt der Alias die Variablen falsch. Dies führt zu einem Fehler, da der Inhalt von `$message` nicht den Formatierungsanforderungen für die Telefonnummer für die Option `--phone-number` entspricht. ``` $ aws textalert $phone $message usage: aws [options] [ ...] [parameters] To see help text, you can run: aws help aws help aws help Unknown options: text ``` ## Beispiele für das Alias-Repository Das [AWS CLI Alias-Repository](https://github.com/awslabs/awscli-aliases) auf *GitHub*enthält AWS CLI Alias-Beispiele, die vom AWS CLI Entwicklerteam und der Community erstellt wurden. Sie können das gesamte `alias`-Dateibeispiel verwenden oder einzelne Aliasse für Ihren eigenen Gebrauch verwenden. **Warnung** Durch Ausführen der Befehle in diesem Abschnitt wird Ihre vorhandene `alias`-Datei gelöscht. Um das Überschreiben der vorhandenen Aliasdatei zu vermeiden, ändern Sie den Downloadort. **So verwenden Sie Aliasse aus dem Repository** 1. Installieren Sie Git. Installationsanweisungen finden Sie unter [Erste Schritte – Git installieren](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) in der *Git-Dokumentation*. 1. Installieren Sie den `jp`-Befehl. Der `jp`-Befehl wird in im `tostring`-Alias verwendet. Installationsanweisungen finden Sie in der [JMESPath (jp) README.md](https://github.com/jmespath/jp) unter. *GitHub* 1. Installieren Sie den `jq`-Befehl. Der `jq`-Befehl wird in im `tostring-with-jq`-Alias verwendet. Installationsanweisungen finden Sie unter [JSON-Prozessor (jq](https://stedolan.github.io/jq/download/)) auf. *GitHub* 1. Laden Sie die `alias`-Datei herunter, indem Sie einen der folgenden Schritte ausführen: + Führen Sie die folgenden Befehle aus, die aus dem Repository heruntergeladen werden und kopieren Sie die `alias`-Datei in Ihren Konfigurationsordner. ------ #### [ Linux and macOS ] ``` $ git clone https://github.com/awslabs/awscli-aliases.git $ mkdir -p ~/.aws/cli $ cp awscli-aliases/alias ~/.aws/cli/alias ``` ------ #### [ Windows ] ``` C:\> git clone https://github.com/awslabs/awscli-aliases.git C:\> md %USERPROFILE%\.aws\cli C:\> copy awscli-aliases\alias %USERPROFILE%\.aws\cli ``` ------ + Laden Sie es direkt aus dem Repository herunter und speichern Sie es in dem `cli` Ordner in Ihrem AWS CLI Konfigurationsordner. Standardmäßig ist der Konfigurationsordner `~/.aws/` (Linux oder macOS) und `%USERPROFILE%\.aws\` (Windows). 1. Um zu überprüfen, ob die Aliasse funktionieren, führen Sie den folgenden Alias aus. ``` $ aws whoami ``` Dies zeigt die gleiche Antwort wie der `aws sts get-caller-identity`-Befehl: ``` { "Account": "012345678901", "UserId": "AIUAINBADX2VEG2TC6HD6", "Arn": "arn:aws:iam::012345678901:user/myuser" } ``` ## Ressourcen + Das [AWS CLI Alias-Repository](https://github.com/awslabs/awscli-aliases) on *GitHub*enthält AWS CLI Alias-Beispiele, die vom AWS CLI Entwicklerteam und den Beiträgen der AWS CLI Community erstellt wurden. + Die Ankündigung der Alias-Funktion von [AWS re:Invent 2016: The Effective AWS CLI User](https://www.youtube.com/watch?t=1590&v=Xc1dHtWa9-Q) am. *YouTube* + [https://docs.aws.amazon.com/cli/latest/reference/sts/get-caller-identity.html](https://docs.aws.amazon.com/cli/latest/reference/sts/get-caller-identity.html) + [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html) + [https://docs.aws.amazon.com/cli/latest/reference/sns/publish.html](https://docs.aws.amazon.com/cli/latest/reference/sns/publish.html)