Benannte Profile
Die AWS CLI unterstützt die Verwendung mehrerer benannter Profile, die in den Dateien credentials
und config
gespeichert sind. Sie können zusätzliche Profile mithilfe von aws configure
mit der Option --profile
oder durch Hinzufügen von Einträgen zu den Dateien config
und credentials
konfigurieren.
Das folgende Beispiel zeigt eine credentials
-Datei mit zwei Profilen: Das erste wird verwendet, wenn Sie einen CLI-Befehl ohne
Profil ausführen. Das zweite wird verwendet, wenn Sie einen CLI-Befehl mit dem Parameter
--profile user1
ausführen.
~/.aws/credentials
(Linux und Mac) oder %USERPROFILE%\.aws\credentials
(Windows)
[default] aws_access_key_id=
AKIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
[user1] aws_access_key_id=AKIAI44QH8DHBEXAMPLE
aws_secret_access_key=je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY
Jedes Profil kann verschiedene Anmeldeinformationen angeben – möglicherweise von verschiedenen IAM-Benutzern – und kann auch verschiedene AWS-Regionen und Ausgabeformate angeben.
~/.aws/config
(Linux und Mac) oder %USERPROFILE%\.aws\config
(Windows)
[default] region=us-west-2 output=json [profile user1] region=us-east-1 output=text
Wichtig
Die Datei credentials
verwendet für benannte Profile ein anderes Namensformat als die CLI-Datei config
. Schließen Sie das Präfixwort "profile
" nur ein, wenn Sie ein benanntes Profil in der Datei config
konfigurieren. Verwenden Sie das Wort profile
nicht , wenn Sie einen Eintrag in der Datei credentials
erstellen.
Verwenden von Profilen mit der AWS CLI
Um ein benanntes Profil zu verwenden, fügen Sie dem Befehl die Option --profile
hinzu. Das folgende Beispiel listet alle Ihre Amazon EC2-Instances mit den Anmeldeinformationen
und Einstellungen auf, die im Profil profile-name
user1
aus den vorherigen Beispieldateien definiert wurden.
$
aws ec2 describe-instances --profile user1
Um ein benanntes Profil für mehrere Befehle zu verwenden, müssen Sie das Profil nicht
in jedem Befehl angeben. Legen Sie stattdessen die Umgebungsvariable AWS_PROFILE
in der Befehlszeile fest.
Linux, macOS, or Unix
$
export AWS_PROFILE=user1
Durch die Festlegung der Umgebungsvariablen wird das Standardprofil bis zum Ende der Shell-Sitzung geändert oder bis Sie einen anderen Wert für die Variable bestimmen. Sie können Umgebungsvariablen für zukünftige Sitzungen persistent machen, indem Sie sie in das Startup-Skript Ihrer Shell stellen. Weitere Informationen finden Sie unter Umgebungsvariablen.
Windows
C:\>
setx AWS_PROFILE user1
Bei Verwendung von set
zur Festlegung einer Umgebungsvariablen wird der verwendete Wert bis zum Ende der
aktuellen Eingabeaufforderungssitzung, oder bis Sie einen anderen Wert für die Variable
festlegen, verwendet.
Wenn Sie setx
zum Festlegen einer Umgebungsvariable verwenden, ändert sich der Wert in allen Befehls-Shells,
die Sie nach der Ausführung des Befehls erstellen. Befehls-Shells, die zum Zeitpunkt
der Befehlsausführung bereits ausgeführt werden, sind nicht betroffen. Schließen Sie die Befehls-Shell und starten Sie sie neu, um die Auswirkungen
der Änderung zu sehen.