Wie verwende ich den Befehl „describe-regions“ in AWS CLI?

Wie Verwende Ich Den Befehl Describe Regions In Aws Cli



AWS CLI ist ein einheitliches Tool, das für den Zugriff, die Steuerung und die Verwaltung von AWS-Ressourcen über das Terminal auf Ihren lokalen Computern verwendet wird. Mit AWS CLI kann ein Benutzer mit AWS-Services interagieren, indem er einfache einzeilige Befehle verwendet. Einer dieser einfachen einzeiligen Befehle der AWS CLI ist der „describe-regions“ Befehl. In AWS sind einige Regionen standardmäßig aktiv. Einige Regionen werden jedoch nur aktiviert, wenn ein Benutzer sie manuell auswählt. Daher kann dieser Befehl den AWS-Benutzern helfen, eine Liste von Regionen auf der Plattform anzuzeigen.

Kurzer Überblick,

Dieser Artikel behandelt die folgenden Aspekte:







Was ist der Befehl „describe-regions“ in AWS CLI?

Der „describe-regions“ Der Befehl in AWS CLI wird zum Auflisten und Anzeigen aller Regionen für ein bestimmtes Konto verwendet. Dieser Befehl unterstützt die Paginierung und wird häufig mit der EC2-Instanz verwendet. Im frühere AWS-Dokumentation, Die „list-regions“ Der Befehl wurde verwendet, um alle AWS-Regionen anzuzeigen. Allerdings ist die „describe-regions“ Der Befehl wird in der aktualisierten AWS CLI v2 (Version 2) und auch in der unterstützt überarbeitete Dokumentation von AWS .



Mehr lesen: Ein Überblick über die globale AWS-Infrastruktur



Wie verwende ich den Befehl „describe-regions“ in AWS CLI?

Der „describe-regions“ Der Befehl wird mit mehreren optionalen Argumenten zum Ausführen verschiedener Funktionen verwendet. Zu diesen Aktionen gehören das Filtern der Regionen oder das Anzeigen von Daten in verschiedenen Formaten. Für diesen Befehl sind keine Parameter erforderlich.





Syntax

Die Syntax für die „describe-regions“ Der Befehl ist unten angegeben:



aws ec2 beschreibende Regionen < Optionen >

Optionen

Nachfolgend finden Sie eine kurze Beschreibung der verschiedenen Optionen, die mit dem obigen Befehl verwendet werden können:

Optionen Beschreibungen
–Filter Der –Filter Die Option wird verwendet, um bestimmte Details aus den Daten zu extrahieren. Es können drei verschiedene Filter verwendet werden „describe-regions“ Befehl:
  • Endpunkt: Dieser Filtertyp zeigt nur die Regionen an, die mit dem für den Endpunkt angegebenen Wert beginnen oder diesem entsprechen.
  • Opt-in-Status: Opt-in-Regionen sind diejenigen Regionen, die vom Benutzer manuell aktiviert werden. Sie bieten eine höhere Sicherheit als herkömmliche Instanzen. Dies liegt daran, dass sie die IAM-Daten zwischen Konten in verschiedenen Opt-in-Regionen teilen. Es gibt drei verschiedene Werte dafür, z. B. Opt-in-nicht-erforderlich , Opt-in, Und nicht angemeldet.
  • Regionsname: Diese Option akzeptiert den Namen der Region und listet dann nur diese Regionen in der Antwort auf.
-Probelauf Diese Option überprüft die Berechtigung für die gewünschte Aktion. Die Antwort wird im Fehlerformat generiert. Wenn der Benutzer über die erforderlichen Berechtigungen verfügt, wird in der Ausgabe Folgendes angezeigt: „DryRunOperation“ . Andernfalls enthält die Antwort eine „UnauthorizedOperation“ Wert.
-alle Regionen Mit dieser Option werden alle AWS-Regionen für das angegebene Konto angezeigt. Es umfasst die Regionen, die für Ihr Konto deaktiviert sind. Um diese Option zu deaktivieren, verwenden Sie die Option –no-all-regions.
–cli-input-json Die Option –cli-input-json wird verwendet, um der CLI die Anweisung sofort im JSON-Format bereitzustellen. Die Werte dieser Optionen werden überschrieben, wenn die anderen Optionen im Befehl angegeben werden.
–cli-skelett generieren Diese Option akzeptiert Zeichenfolgenwerte und wird zum Erstellen einer JSON-Vorlage verwendet. Diese Vorlage wird dann von der Option –cli-input-json verwendet.

Es werden auch globale Optionen bereitgestellt, die bei jedem Befehl für AWS CLI verwendet werden. Es handelt sich hierbei nicht um Pflichtfelder. Ein Benutzer kann jedoch die Ausgabe des Befehls mithilfe der globalen Option steuern. Informationen zu den globalen Optionen finden Sie im AWS-Dokumentation .

Beispiele

In diesem Abschnitt des Artikels werden wir die folgenden Beispiele implementieren:

Beispiel 1: Wie liste ich alle aktivierten Regionen in AWS CLI auf?

Der unten angegebene Befehl listet alle aktivierten Regionen für Ihr Konto auf:

aws ec2 beschreibende Regionen

Ausgabe

Beispiel 2: Wie liste ich alle Regionen in AWS CLI auf?

Mit dem folgenden Befehl werden alle Regionen für ein bestimmtes Konto aufgelistet. Unter „Alle Regionen“ versteht man die Einbeziehung aller aktivierten, deaktivierten oder globalen Regionen auf der AWS-Plattform:

aws ec2 beschreibende Regionen --alle Regionen

Ausgabe

Zu deaktivieren Die '-alle Regionen' Parameter verwenden Sie den folgenden Befehl:

aws ec2 beschreibende Regionen --no-all-regions

Ausgabe

Beispiel 3: Wie filtere ich die Regionen in AWS CLI?

In AWS CLI können wir die Regionen mit dem folgenden Befehl nach Endpunkten, Tags, Opt-in-Status usw. filtern:

aws ec2 beschreibende Regionen --filters „Name=Endpunkt, Werte=*ap*“

Ausgabe

So filtern Sie Regionen mithilfe des Parameters „opt-in-status“.

Die Ausgabe dieses Befehls zeigt nur Regionen mit an Opt-in-nicht-erforderlich Wert:

aws ec2 beschreibende Regionen --filters „Name=Opt-In-Status, Werte=*Opt-In-nicht erforderlich*“

Notiz: Der Benutzer kann im Feld „Name“ auch andere Optionen angeben, z zugestimmt oder nicht angemeldet Optionen.

Ausgabe

So filtern Sie Regionen mithilfe des Parameters „regions-name“.

Der Befehl zum Filtern der Regionen über den Regionsnamenfilter ist unten angegeben:

aws ec2 beschreibende Regionen --filters „Name=Regionsname, Werte=*ap-southeast-1*“

Notiz: Ersetzen Sie den Wert ap-südost-1 mit jedem Name der AWS-Region. Das Sternchen bleibt jedoch gleich.

Ausgabe

Die Ausgabe des Befehls listet nur die spezifische Region auf, die mit dem im angegebenen Wert übereinstimmt 'Werte' Parameter. Der Benutzer kann auch die Regionen angeben, z. B. 'EU' im *ap* Format wie im vorherigen Abschnitt dieses Beispiels angegeben:

Beispiel 4: Wie liste ich die Regionen in verschiedenen Ausgabeformaten auf?

Im „describe-regions“ Befehl stehen mehrere Ausgabeformate zur Verfügung, z. B. Tabelle, JSON, Text oder YAML. Der Befehl zum Auflisten der Regionen im Tabellenformat ist unten angegeben:

aws ec2 beschreibende Regionen --Ausgabe Tisch

Notiz: Ersetzen Sie den Wert des Parameters –output durch JSON, YAML oder Text, um Werte in verschiedenen Formaten zu erhalten.

Ausgabe :

Beispiel 5: Wie werden die Regionen mit dem Befehl „describe-regions“ in der AWS CLI abgefragt?

Der Benutzer kann die Antwort auch mithilfe von JMESPATH filtern '-Abfrage' Parameter. Der Befehl ist unten angegeben:

aws ec2 beschreibende Regionen --Abfrage „Regionen[].{Name:RegionName}“ --Ausgabe Text

Ausgabe

Beispiel 6: Wie werden Berechtigungen für den Befehl „describe-regions“ in der AWS CLI ermittelt?

Der -Probelauf Option der „describe-regions“ Der Befehl bestimmt, ob der Benutzer über die erforderliche Berechtigung für die Aktion verfügt oder nicht. Zu diesem Zweck wird der folgende Befehl angegeben:

aws ec2 beschreibende Regionen --Probelauf

Ausgabe

Ebenso kann der Benutzer dieses Flag auch deaktivieren, um die Regionen anzuzeigen, indem er den folgenden Befehl verwendet:

aws ec2 beschreibende Regionen --kein Trockenlauf

Ausgabe

Beispiel 7: Wie liste ich bestimmte Regionen im Befehl „describe-regions“ auf?

Um die spezifischen Regionen anzuzeigen, besteht eine Methode darin, die Abfrage zu filtern, während die andere Methode darin besteht, die zu verwenden „–Regionsname“ . Der folgende Befehl verwendet die „–Regionsname“ Option mit der „describe-regions“ Befehl:

aws ec2 beschreibende Regionen --regions-names ap-südost- 1

Notiz: Ersetzen Sie den Wert ap-südost-1 im Befehl mit Ihrem Name der AWS-Region.

Ausgabe

Das ist alles aus diesem Leitfaden.

Endeffekt

Der „describe-regions“ Der Befehl in der AWS CLI listet alle oder aktivierten Regionen für ein bestimmtes Konto auf. Um EC2-Regionen aufzulisten, verwenden Sie die „aws ec2 beschreiben-Regionen“ Befehl. Es unterstützt mehrere Ausgabeformate und akzeptiert verschiedene Argumente zum Filtern oder Abfragen. Für AWS-Anfänger ist dieser Befehl hilfreich, wenn Sie regionalspezifische Ressourcen bereitstellen oder die URLs der Endpunkte ermitteln möchten. Um diese Funktionalität zu implementieren, melden Sie sich über CMD bei der AWS CLI an und geben Sie die zuvor genannten Befehle an das Terminal. In diesem Leitfaden haben wir verschiedene Beispiele Schritt für Schritt besprochen, um ein tiefgreifendes Verständnis davon zu erhalten „describe-regions“ Befehl in AWS CLI.