aws cli
1.0.0
Dieses Paket bietet eine einheitliche Befehlszeilenschnittstelle für Amazon Web Services.
Springe zu:
Diese README-Datei gilt für die AWS CLI-Version 1. Wenn Sie Informationen zur AWS CLI-Version 2 suchen, besuchen Sie bitte den Zweig v2.
Das aws-cli-Paket funktioniert auf Python-Versionen:
Am 30.05.2022 wurde die Unterstützung für Python 3.6 eingestellt. Dies folgt auf das Ende des Supports der Python Software Foundation für die Laufzeit am 23.12.2021.
Am 13.12.2023 wurde die Unterstützung für Python 3.7 eingestellt. Dies folgt auf das Ende des Supports der Python Software Foundation für die Laufzeit am 27.06.2023. Weitere Informationen finden Sie in diesem Blogbeitrag.
Aufmerksamkeit!
Wir empfehlen allen Kunden, die Amazon Web Services Security Bulletins-Website regelmäßig auf wichtige Sicherheitsbulletins im Zusammenhang mit aws-cli zu überprüfen.
Die AWS CLI-Version 1 wurde am 02.09.2013 allgemein verfügbar gemacht und befindet sich derzeit in der vollständigen Supportphase des Verfügbarkeitslebenszyklus.
Informationen zur Wartung und Unterstützung für SDK-Hauptversionen und deren zugrunde liegende Abhängigkeiten finden Sie im Abschnitt „Wartungsrichtlinie“ im AWS SDKs and Tools Shared Configuration and Credentials Reference Guide .
Die Installation der AWS CLI und ihrer Abhängigkeiten nutzt eine Reihe von Paketierungsfunktionen, die von pip und setuptools bereitgestellt werden. Um eine reibungslose Installation zu gewährleisten, wird die Verwendung von Folgendem empfohlen:
pip : 9.0.2 oder höhersetuptools : 36.2.0 oder höher Der sicherste Weg, die AWS CLI zu installieren, ist die Verwendung von pip in einer virtualenv :
$ python -m pip install awscli
oder, wenn Sie nicht in einer virtualenv installieren, zur globalen Installation:
$ sudo python -m pip install awscli
oder für Ihren Benutzer:
$ python -m pip install --user awscli
Wenn Sie das aws-cli-Paket installiert haben und auf die neueste Version aktualisieren möchten, können Sie Folgendes ausführen:
$ python -m pip install --upgrade awscli
Dadurch werden das aws-cli-Paket sowie alle Abhängigkeiten installiert.
Notiz
Wenn Sie unter macOS einen Fehler bezüglich der Version von six sehen, die mit distutils in El Capitan geliefert wurde, verwenden Sie die Option --ignore-installed :
$ sudo python -m pip install awscli --ignore-installed six
Unter Linux und Mac OS kann die AWS CLI mit einem gebündelten Installationsprogramm installiert werden. Die AWS CLI kann auch über einen MSI-Installer unter Windows installiert werden.
Wenn Sie den develop der AWS CLI ausführen möchten, lesen Sie den Abschnitt „Entwicklungsversion“ des beitragenden Leitfadens.
Weitere Informationen finden Sie im Installationsabschnitt des AWS CLI-Benutzerhandbuchs.
Bevor Sie die AWS CLI verwenden, müssen Sie Ihre AWS-Anmeldeinformationen konfigurieren. Sie können dies auf verschiedene Arten tun:
Der schnellste Weg, um loszulegen, besteht darin, den Befehl aws configure auszuführen:
$aws konfigurieren AWS-Zugriffsschlüssel-ID: MYACCESSKEY Geheimer AWS-Zugriffsschlüssel: MYSECRETKEY Standardregionsname [us-west-2]: us-west-2 Standardausgabeformat [Keine]: json
Gehen Sie wie folgt vor, um Umgebungsvariablen zu verwenden:
$ export AWS_ACCESS_KEY_ID=$ export AWS_SECRET_ACCESS_KEY=
Um die gemeinsame Anmeldeinformationsdatei zu verwenden, erstellen Sie eine INI-formatierte Datei wie diese:
[Standard] aws_access_key_id=MYACCESSKEY aws_secret_access_key=MYSECRETKEY [Testen] aws_access_key_id=MYACCESSKEY aws_secret_access_key=MYSECRETKEY
und platzieren Sie es in ~/.aws/credentials (oder in %UserProfile%.aws/credentials unter Windows). Wenn Sie die Datei mit den gemeinsamen Anmeldeinformationen an einem anderen Ort als dem oben angegebenen ablegen möchten, müssen Sie aws-cli mitteilen, wo sie zu finden ist. Tun Sie dies, indem Sie die entsprechende Umgebungsvariable festlegen:
$ export AWS_SHARED_CREDENTIALS_FILE=/path/to/shared_credentials_file
Um eine Konfigurationsdatei zu verwenden, erstellen Sie eine INI-formatierte Datei wie diese:
[Standard] aws_access_key_id=aws_secret_access_key= # Optional, um die Standardregion für dieses Profil zu definieren. Region=us-west-1 [Profiltest] aws_access_key_id= aws_secret_access_key= Region=us-west-2
und platzieren Sie es in ~/.aws/config (oder in %UserProfile%.awsconfig unter Windows). Wenn Sie die Konfigurationsdatei an einem anderen Ort als dem oben angegebenen ablegen möchten, müssen Sie der AWS CLI mitteilen, wo sie zu finden ist. Tun Sie dies, indem Sie die entsprechende Umgebungsvariable festlegen:
$ export AWS_CONFIG_FILE=/path/to/config_file
Wie Sie sehen, können Sie mehrere profiles sowohl in der gemeinsamen Anmeldeinformationsdatei als auch in der Konfigurationsdatei definieren. Anschließend können Sie mithilfe der Option --profile angeben, welches Profil verwendet werden soll. Wenn kein Profil angegeben ist, wird das default verwendet.
In der Konfigurationsdatei müssen Sie, mit Ausnahme des Standardprofils, jedem Konfigurationsabschnitt einer Profilgruppe das Präfix profile voranstellen. Wenn Sie beispielsweise ein Profil mit dem Namen „Testing“ haben, lautet die Abschnittsüberschrift [profile testing] .
Die letzte Option für Anmeldeinformationen wird dringend empfohlen, wenn Sie die AWS CLI auf einer EC2-Instanz verwenden. IAM-Rollen sind eine großartige Möglichkeit, Anmeldeinformationen automatisch auf Ihrer Instanz zu installieren. Wenn Sie IAM-Rollen verwenden, findet und verwendet die AWS CLI diese automatisch.
Zusätzlich zu den Anmeldeinformationen können eine Reihe anderer Variablen entweder mit Umgebungsvariablen, Konfigurationsdateieinträgen oder beidem konfiguriert werden. Weitere Informationen finden Sie im AWS Tools and SDKs Shared Configuration and Credentials Reference Guide.
Weitere Informationen zu Konfigurationsoptionen finden Sie im Thema AWS CLI-Konfigurationsvariablen. Sie können auf dieses Thema auch über die AWS CLI zugreifen, indem Sie aws help config-vars ausführen.
Ein AWS CLI-Befehl hat die folgende Struktur:
$ aws[Optionen und Parameter]
Um beispielsweise S3-Buckets aufzulisten, würde der Befehl wie folgt lauten:
$aws s3 ls
Um die Hilfedokumentation anzuzeigen, verwenden Sie eine der folgenden Möglichkeiten:
$aws-Hilfe $ awsHilfe $ aws Hilfe
So erhalten Sie die Version der AWS CLI:
$ aws --version
So aktivieren Sie die Debugging-Ausgabe:
$ aws --debug
Weitere Informationen finden Sie im Kapitel „Verwenden der AWS CLI“ im AWS CLI-Benutzerhandbuch.
Das aws-cli-Paket enthält eine Befehlsvervollständigungsfunktion für Unix-ähnliche Systeme. Diese Funktion wird nicht automatisch installiert und muss daher manuell konfiguriert werden. Weitere Informationen finden Sie im Thema zur AWS CLI-Befehlsvervollständigung.
Der beste Weg, mit unserem Team zu interagieren, ist über GitHub. Sie können ein Problem öffnen und eine unserer Vorlagen für Anleitungen, Fehlerberichte oder Funktionsanfragen auswählen.
Möglicherweise finden Sie Hilfe von der Community auf Stack Overflow mit dem Tag aws-cli oder im AWS-Diskussionsforum für CLI. Wenn Sie einen Support-Plan mit AWS Support haben, können Sie auch einen neuen Support-Fall erstellen.
Bitte prüfen Sie, ob ähnliche Probleme offen sind, bevor Sie ein anderes öffnen.
Die AWS CLI implementiert AWS-Service-APIs. Bei allgemeinen Fragen zu den Diensten oder deren Einschränkungen können die Diskussionsforen von Amazon Web Services hilfreich sein.
