View a markdown version of this page

Verwenden des EC2-compatible Amazon-Endpunkts auf einem Snowball Edge - AWS Snowball Edge Entwicklerhandbuch

AWS Snowball Edge ist für Neukunden nicht mehr verfügbar. Neukunden sollten AWS DataSyncnach Online-Übertragungen, AWS Data Transfer Terminal für sichere physische Übertragungen oder AWS Partnerlösungen suchen. Erkunden Sie AWS Outposts für Edge-Computing.

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.

Verwenden des EC2-compatible Amazon-Endpunkts auf einem Snowball Edge

Im Folgenden finden Sie eine Übersicht über den EC2-compatible Amazon-Endpunkt. Mit diesem Endpunkt können Sie Ihre Amazon Machine Images (AMIs) verwalten und Instances mithilfe von Amazon EC2-compatible API-Vorgängen programmgesteuert berechnen.

Angeben des EC2-compatible Endpunkts als AWS CLI Endpunkt auf einer Snowball Edge

Wenn Sie den verwenden AWS CLI, um einen Befehl an das AWS Snowball Edge Gerät zu senden, können Sie angeben, dass der Endpunkt der EC2-compatible Amazon-Endpunkt ist. Sie können den HTTPS-Endpunkt oder einen ungesicherten HTTP-Endpunkt, wie hier gezeigt, verwenden.

Gesicherter HTTPS-Endpunkt

aws ec2 describe-instances --endpoint https://192.0.2.0:8243 --ca-bundle path/to/certificate

Ungesicherter HTTP-Endpunkt

aws ec2 describe-instances --endpoint http://192.0.2.0:8008

Wenn Sie den HTTPS-Endpunkt 8243 verwenden, werden Ihre Daten während der Übertragung verschlüsselt. Diese Verschlüsselung wird durch ein Zertifikat gewährleistet, das von Snowball Edge generiert wird, wenn es entsperrt wird. Nachdem Sie Ihr Zertifikat erhalten haben, können Sie es in einer lokalen ca-bundle.pem-Datei speichern. Anschließend können Sie Ihr AWS CLI-Profil so konfigurieren, dass der Pfad zu Ihrem Zertifikat wie unten beschrieben hinzugefügt wird.

So verknüpfen Sie Ihr Zertifikat mit dem EC2-compatible Amazon-Endpunkt
  1. Connect den Snowball Edge mit Strom und Netzwerk und schalten Sie ihn ein.

  2. Notieren Sie nach dem Entsperren des Geräts seine IP-Adresse im lokalen Netzwerk.

  3. Stellen Sie sicher, dass Sie Snowball Edge von einem Terminal in Ihrem Netzwerk aus pingen können.

  4. Führen Sie den snowballEdge get-certificate-Befehl in Ihrem Terminal aus. Weitere Informationen zu diesem Befehl finden Sie unter Verwaltung von Public-Key-Zertifikaten auf Snowball Edge.

  5. Speichern Sie die Ausgabe des snowballEdge get-certificate-Befehls in einer Datei, z. B. ca-bundle.pem.

  6. Führen Sie im Terminal den folgenden Befehl aus:

    aws configure set profile.snowballEdge.ca_bundle /path/to/ca-bundle.pem

Wenn die Vorgehensweise abgeschlossen ist, können Sie CLI-Befehle mit diesen lokalen Anmeldeinformationen, Ihrem Zertifikat und dem angegebenen Endpunkt ausführen.

Unterstütztes Amazon EC2-compatible AWS CLI Befehle auf einem Snowball Edge

Sie können Ihre Compute-Instances auf einem Snowball Edge-Gerät über einen EC2-compatible Amazon-Endpunkt verwalten. Dieser Endpunkttyp unterstützt viele der Amazon EC2 EC2-CLI-Befehle und -Aktionen der AWS SDKs. Informationen zur Installation und Einrichtung von AWS CLI, einschließlich der Angabe, gegen wen AWS-Regionen Sie AWS CLI Anrufe tätigen möchten, finden Sie im AWS Command Line Interface Benutzerhandbuch.

Liste der unterstützten EC2-compatible AWS CLI Befehle auf einem Snowball Edge

Im Folgenden finden Sie eine Beschreibung der Teilmenge der AWS CLI Befehle und Optionen für Amazon EC2, die auf Snowball Edge-Geräten unterstützt werden. Wenn ein Befehl oder eine Option im Folgenden nicht aufgeführt ist, wird diese(r) nicht unterstützt. Sie können einige nicht unterstützte Optionen in Kombination mit einem Befehl angeben. Diese werden jedoch ignoriert.

  • associate-address – Verknüpft eine virtuelle IP-Adresse mit einer Instance, damit diese über eine der drei physischen Netzwerkschnittstellen auf dem Gerät verwendet werden kann:

    • --instance-id – Die ID einer einzelnen sbe-Instance.

    • --public-ip – Die virtuelle IP-Adresse, mit der Sie auf Ihre Instance zugreifen möchten.

  • attach-volume — Hängt ein Amazon EBS-Volume an eine gestoppte oder laufende Instance auf Ihrem Gerät an und macht es der Instance mit dem angegebenen Gerätenamen zugänglich.

    • --device — value Der Gerätename.

    • --instance-id — Die ID einer Amazon-Zielinstanz. EC2-compatible

    • --volume-id value — Die ID des EBS-Volumes.

  • authorize-security-group-egress — Fügt einer Sicherheitsgruppe eine oder mehrere Ausgangsregeln zur Verwendung mit einem Snowball Edge-Gerät hinzu. Insbesondere diese Aktion erlaubt Instances, Datenverkehr an eine oder mehrere IPv4-CIDR-Zieladressbereiche zu senden. Weitere Informationen finden Sie unter Steuern des Netzwerkverkehrs mit Sicherheitsgruppen auf Snowball Edge.

    • --group-id value — Die ID der Sicherheitsgruppe

    • [--ip-permissionsvalue] — Ein oder mehrere Sätze von IP-Berechtigungen.

  • authorize-security-group-ingress — Fügt einer Sicherheitsgruppe eine oder mehrere Zugangsregeln hinzu. Wenn Sie authorize-security-group-ingress aufrufen, müssen Sie entweder für group-name oder für group-id einen Wert angeben.

    • [--group-name] — value Der Name der Sicherheitsgruppe.

    • [--group-idvalue] — Die ID der Sicherheitsgruppe

    • [--ip-permissionsvalue] — Ein oder mehrere Sätze von IP-Berechtigungen.

    • [--protocol value] Das IP-Protokoll. Mögliche Werte sind tcp, udp und icmp. Das Argument --port ist erforderlich, es sei denn, es wird der Wert "alle Protokolle" (-1) angegeben.

    • [--portvalue] — Für TCP oder UDP der Bereich der Ports, die zugelassen werden sollen. Dieser Wert kann eine einzelne Ganzzahl oder ein Bereich (Minimum—Maximum) sein.

      Für ICMP eine einzelne Ganzzahl oder ein Bereich (typecode), wobei bei type die Nummer des ICMP-Typs und code die ICMP-Codenummer darstellen. Der Wert -1 steht für alle ICMP-Codes für alle ICMP-Typen. Der Wert -1 nur für type gibt alle ICMP-Codes für den angegebenen ICMP-Typ an.

    • [--cidrvalue] — Der CIDR-IP-Bereich.

  • create-launch-template — Erzeugt eine Startvorlage. Eine Startvorlage enthält die Parameter zum Starten einer Instance. Wenn Sie eine Instance über RunInstances starten, können Sie eine Startvorlage angeben, statt die Startparameter in der Anfrage bereitzustellen. Sie können bis zu 100 Vorlagen pro Gerät erstellen.

    • --launch-template-name string — Ein Name für die Startvorlage.

    • --launch-template-data — Die Informationen für die Startvorlagestructure. Folgende Attribute werden unterstützt:

      • ImageId

      • InstanceType

      • SecurityGroupIds

      • TagSpecifications

      • UserData

      JSON-Syntax:

      { "ImageId":"string", "InstanceType":"sbe-c.large", "SecurityGroupIds":["string", ...], "TagSpecifications":[{"ResourceType":"instance","Tags":[{"Key":"Name","Value":"Test"}, {"Key":"Stack","Value":"Gamma"}]}], "UserData":"this is my user data" }
    • [--version-descriptionstring] — Eine Beschreibung für die erste Version der Startvorlage.

    • --endpoint snowballEndpoint — Ein Wert, mit dem Sie Ihre Compute-Instances mithilfe von EC2-compatible Amazon-API-Vorgängen programmgesteuert verwalten können. Weitere Informationen finden Sie unter Angeben des EC2-compatible Endpunkts als AWS CLI Endpunkt auf einer Snowball Edge.

  • create-launch-template-version — Erstellt eine neue Version für eine Startvorlage. Sie können eine vorhandene Version einer Startvorlage angeben, auf der die neue Version basieren soll. Die Startvorlagenversionen werden in der Reihenfolge markiert, in der sie erstellt werden. Sie können die Nummerierung von Startvorlagenversionen nicht angeben, ändern oder ersetzen. Sie können bis zu 100 Versionen jeder Startvorlage erstellen.

    Geben Sie in der Anfrage entweder die Startvorlagen-ID oder den Startvorlagennamen an.

    • string--launch-template-id — Die ID der Startvorlage.

    • --launch-template-name — Ein Name für die Startvorlagestring.

    • --launch-template-data — Die Informationen für die Startvorlagestructure. Folgende Attribute werden unterstützt:

      • ImageId

      • InstanceType

      • SecurityGroupIds

      • TagSpecifications

      • UserData

      JSON-Syntax:

      { "ImageId":"string", "InstanceType":"sbe-c.large", "SecurityGroupIds":["string", ...], "TagSpecifications":[{"ResourceType":"instance","Tags":[{"Key":"Name","Value":"Test"}, {"Key":"Stack","Value":"Gamma"}]}], "UserData":"this is my user data" }
    • [--source-versionstring] — Die Versionsnummer der Startvorlage, auf der die neue Version basieren soll. Die neue Version übernimmt alle Startparameter der Quellversion, ausgenommen der von Ihnen in launch-template-data angegebenen Parameter.

    • [--version-descriptionstring] — Eine Beschreibung für die erste Version der Startvorlage.

    • --endpoint snowballEndpoint — Ein Wert, mit dem Sie Ihre Compute-Instances mithilfe von EC2-compatible Amazon-API-Vorgängen programmgesteuert verwalten können. Weitere Informationen finden Sie unter Angeben des EC2-compatible Endpunkts als AWS CLI Endpunkt auf einer Snowball Edge.

  • create-tags — Fügt ein oder mehrere Tags für die angegebene Ressource hinzu oder überschreibt es. Jede Ressource kann maximal 50 Tags haben. Jedes Tag besteht aus einem Schlüssel und einem optionalen Wert. Tag-Schlüssel müssen für eine Ressource eindeutig sein. Folgende Ressourcen werden unterstützt:

    • AMI

    • Instance

    • Startvorlage

    • Sicherheitsgruppe

    • Schlüsselpaar

  • create-security-group — Erstellt eine Sicherheitsgruppe auf Ihrem Snowball Edge. Sie können bis zu 50 Sicherheitsgruppen erstellen. Wenn Sie eine Sicherheitsgruppe erstellen, geben Sie einen Anzeigenamen Ihrer Wahl an:

    • --group-name — Der Name value der Sicherheitsgruppe.

    • --description value — Eine Beschreibung der Sicherheitsgruppe. Dies dient nur zu Informationszwecken. Dieser Wert kann bis zu 255 Zeichen lang sein.

  • create-volume — Erstellt ein Amazon EBS-Volume, das an eine Instance auf Ihrem Gerät angehängt werden kann.

    • [--sizevalue] — Die Größe des Volumes in GiBs, die zwischen 1 GiB und 1 TB (1000 GiBs) liegen kann.

    • [--snapshot-idvalue] — Der Snapshot, aus dem das Volume erstellt werden soll.

    • [--volume-type] — Der Volume-Typvalue. Wenn kein Wert angegeben wird, lautet der Standardwert sbg1. Die folgenden Werte sind möglich:

      • sbg1 für magnetische Volumes

      • sbp1 für SSD-Volumes

    • [--tag-specificationvalue] — Eine Liste von Tags, die bei der Erstellung auf das Volume angewendet werden sollen.

  • delete-launch-template — Löscht eine Startvorlage. Beim Löschen einer Startvorlage werden alle ihre Versionen gelöscht.

    Geben Sie in der Anfrage entweder die Startvorlagen-ID oder den Startvorlagennamen an.

    • string--launch-template-id — Die ID der Startvorlage.

    • --launch-template-name — Ein Name für die Startvorlagestring.

    • --endpoint snowballEndpoint — Ein Wert, mit dem Sie Ihre Compute-Instances mithilfe von EC2-compatible Amazon-API-Vorgängen programmgesteuert verwalten können. Weitere Informationen finden Sie unter Angeben des EC2-compatible Endpunkts als AWS CLI Endpunkt auf einer Snowball Edge.

  • delete-launch-template-version — Löscht eine oder mehrere Versionen einer Startvorlage. Sie können die Standardversion einer Startvorlage erst löschen, nachdem Sie eine andere Version als Standardversion festgelegt haben. Wenn die Standardversion die einzige Version der Startvorlage ist, löschen Sie die gesamte Startvorlage, indem Sie den Befehl delete-launch-template verwenden.

    Geben Sie in der Anfrage entweder die Startvorlagen-ID oder den Startvorlagennamen an.

    • --launch-template-id — string Die ID der Startvorlage.

    • --launch-template-name — Ein Name für die Startvorlagestring.

    • --versions (Liste) "string" "string" — Die Versionsnummern einer oder mehrerer Versionen der Startvorlage, die gelöscht werden sollen.

    • --endpoint snowballEndpoint — Ein Wert, mit dem Sie Ihre Compute-Instances mithilfe von EC2-compatible Amazon-API-Vorgängen programmgesteuert verwalten können. Weitere Informationen finden Sie unter Angeben des EC2-compatible Endpunkts als AWS CLI Endpunkt auf einer Snowball Edge.

  • delete-security-group — Löscht eine Sicherheitsgruppe.

    Wenn Sie versuchen, eine Sicherheitsgruppe zu löschen, die mit einer Instance verknüpft ist, oder auf die von einer anderen Sicherheitsgruppe verwiesen wird, schlägt die Operation mit DependencyViolation fehl.

    • --group-name — value Der Name der Sicherheitsgruppe.

    • --description value — Eine Beschreibung der Sicherheitsgruppe. Dies dient nur zu Informationszwecken. Dieser Wert kann bis zu 255 Zeichen lang sein.

  • delete-tags — Löscht den angegebenen Satz von Tags aus der angegebenen Ressource (AMI, Compute-Instance, Startvorlage oder Sicherheitsgruppe).

  • delete-volume — Löscht das angegebene Amazon EBS-Volume. Das Volume muss den available-Status aufweisen (nicht an eine Instance angefügt).

    • value--volume-id — Die ID des Volumes.

  • describe-addresses — Beschreibt eine oder mehrere Ihrer virtuellen IP-Adressen, die derselben Anzahl von sbe Instanzen auf Ihrem Gerät zugeordnet sind.

    • --public-ips – Eine oder mehrere der virtuellen IP-Adressen, die Ihren Instances zugeordnet sind.

  • describe-images — Beschreibt eines oder mehrere der Images (AMIs), die Ihnen zur Verfügung stehen. Ihnen zur Verfügung stehende Bilder werden dem Snowball Edge-Gerät bei der Auftragserstellung hinzugefügt.

    • --image-id — Die Snowball-AMI-ID des AMI.

  • describe-instance-attribute — Beschreibt das angegebene Attribut der angegebenen Instance. Sie können jeweils nur ein Attribut angeben. Folgende Attribute werden unterstützt:

    • instanceInitiatedShutdownBehavior

    • instanceType

    • userData

  • describe-instances – Beschreibt eine oder mehrere Ihrer Instances. Die Antwort gibt alle Sicherheitsgruppen zurück, die den Instances zugeordnet sind.

    • --instance-ids – Die IDs einer oder mehrerer sbe-Instances, die auf dem Gerät gestoppt wurden.

    • --page-size — Die Größe jeder Seite, die im Aufruf abgerufen werden soll. Dieser Wert hat keinerlei Auswirkung auf die Anzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben wurden. Das Festlegen einer kleineren Seitengröße führt zu mehr Aufrufen an das Gerät, wodurch bei jedem Anruf weniger Elemente abgerufen werden. Auf diese Weise kann die Zeitüberschreitung von Aufrufen verhindert werden.

    • --max-items — Die Gesamtzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben werden sollen. Ist die Gesamtzahl der verfügbaren Elemente größer als der angegebene Wert, wird ein NextToken in der Ausgabe des Befehls bereitgestellt. Um die Seitennummerierung fortzusetzen, geben Sie den NextToken-Wert im starting-token-Argument eines nachfolgenden Befehls an.

    • --starting-token — Ein Token, um anzugeben, wo mit der Paginierung begonnen werden soll. Dieses Token ist der NextToken-Wert aus einer zuvor abgeschnittenen Antwort.

  • describe-instance-status — Beschreibt den Status der angegebenen Instances oder all Ihrer Instances. Standardmäßig werden nur laufende Instances beschrieben, es sei denn, Sie geben ausdrücklich an, dass der Status aller Instances zurückgegeben werden soll. Der Instanzstatus umfasst die folgenden Komponenten:

    • Statuschecks — Das Snow-Gerät führt Statusprüfungen für laufende EC2-compatible Amazon-Instances durch, um Hardware- und Softwareprobleme zu identifizieren.

    • Instance-Status — Sie können Ihre Instances vom Start bis zu ihrer Kündigung verwalten.

    Mit diesem Befehl werden die folgenden Filter unterstützt.

    • [--filters](Liste)

      Die Filter.

      • instance-state-code— Der Code für den Instanzstatus als 16-Bit-Ganzzahl ohne Vorzeichen. Das High-Byte wird für interne Serviceberichte verwendet und sollte ignoriert werden. Das Low-Byte wird auf der Grundlage des dargestellten Zustands festgelegt. Die gültigen Werte sind 0 (ausstehend), 16 (läuft), 32 (Herunterfahren), 48 (beendet), 64 (Stopp) und 80 (gestoppt).

      • instance-state-name— Der Status der Instanz (pending| | | running | shutting-down terminated stopping |stopped).

      • instance-status.reachability— Filtert nach dem Instanzstatus, wobei der Name reachability (passed| failed | initializing |insufficient-data) lautet.

      • instance-status.status— Der Status der Instanz (ok| impaired | initializing | insufficient-data |not-applicable).

      • system-status.reachability— Filtert nach dem Systemstatus, wobei der Name Erreichbarkeit (passed| | failed initializing |insufficient-data) lautet.

      • system-status.status— Der Systemstatus der Instanz (ok| | | impaired initializing insufficient-data |not-applicable).

    • JSON-Syntax:

      [ { "Name": "string", "Values": ["string", ...] } ... ]
    • [--instance-ids](Liste)

      Die Instanz-IDs.

      Standard: Beschreibt alle Ihre Instances.

    • [--dry-run|--no-dry-run](boolescher Wert)

      Ü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. Wenn Sie über die erforderlichen Berechtigungen verfügen, lautet die FehlerantwortDryRunOperation.

      Andernfalls ist es UnauthorizedOperation.

    • [--include-all-instances | --no-include-all-instances](boolescher Wert)

      Wanntrue, beinhaltet den Integritätsstatus für alle Instanzen. Wannfalse, beinhaltet nur den Integritätsstatus für laufende Instances.

      Standard: false

    • [--page-size](Ganzzahl) — Die Größe jeder Seite, die im Aufruf abgerufen werden soll. Dieser Wert hat keinerlei Auswirkung auf die Anzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben wurden. Das Festlegen einer kleineren Seitengröße führt zu mehr Aufrufen an das Gerät, wodurch bei jedem Anruf weniger Elemente abgerufen werden. Auf diese Weise kann die Zeitüberschreitung von Aufrufen verhindert werden.

    • [--max-items](integer) — Die Gesamtzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben werden sollen. Ist die Gesamtzahl der verfügbaren Elemente größer als der angegebene Wert, wird ein NextToken in der Ausgabe des Befehls bereitgestellt. Um die Seitennummerierung fortzusetzen, geben Sie den NextToken-Wert im starting-token-Argument eines nachfolgenden Befehls an.

    • [--starting-token](string) — Ein Token, um anzugeben, wo mit der Paginierung begonnen werden soll. Dieses Token ist der NextToken-Wert aus einer zuvor abgeschnittenen Antwort.

  • describe-launch-templates — Beschreibt eine oder mehrere Startvorlagen. Beim Befehl describe-launch-templates handelt es sich um eine paginierte Operation. Sie können mehrere Aufrufe ausführen, um den gesamten Ergebnisdatensatz abzurufen.

    Geben Sie in der Anfrage entweder die Startvorlagen-IDs oder die Startvorlagennamen an.

    • --launch-template-ids (Liste) "string" "string" — Eine Liste von IDs der Startvorlagen.

    • --launch-template-names (list) "string" "string" — Eine Liste mit Namen für die Startvorlagen.

    • --page-size — Die Größe jeder Seite, die im Aufruf abgerufen werden soll. Dieser Wert hat keinerlei Auswirkung auf die Anzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben wurden. Das Festlegen einer kleineren Seitengröße führt zu mehr Aufrufen an das Gerät, wodurch bei jedem Anruf weniger Elemente abgerufen werden. Auf diese Weise kann die Zeitüberschreitung von Aufrufen verhindert werden.

    • --max-items — Die Gesamtzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben werden sollen. Ist die Gesamtzahl der verfügbaren Elemente größer als der angegebene Wert, wird ein NextToken in der Ausgabe des Befehls bereitgestellt. Um die Seitennummerierung fortzusetzen, geben Sie den NextToken-Wert im starting-token-Argument eines nachfolgenden Befehls an.

    • --starting-token — Ein Token, um anzugeben, wo mit der Paginierung begonnen werden soll. Dieses Token ist der NextToken-Wert aus einer zuvor abgeschnittenen Antwort.

    • --endpoint snowballEndpoint — Ein Wert, mit dem Sie Ihre Compute-Instances mithilfe von EC2-compatible Amazon-API-Vorgängen programmgesteuert verwalten können. Weitere Informationen finden Sie unter Angeben des EC2-compatible Endpunkts als AWS CLI Endpunkt auf einer Snowball Edge.

  • describe-launch-template-versions — Beschreibt eine oder mehrere Versionen einer bestimmten Startvorlage. Sie können alle Versionen, einzelne Versionen oder eine Reihe von Versionen beschreiben. Beim Befehl describe-launch-template-versions handelt es sich um eine paginierte Operation. Sie können mehrere Aufrufe ausführen, um den gesamten Ergebnisdatensatz abzurufen.

    Geben Sie in der Anfrage entweder die Startvorlagen-IDs oder die Startvorlagennamen an.

    • string--launch-template-id — Die ID der Startvorlage.

    • --launch-template-name — Ein Name für die Startvorlagestring.

    • [--versions (Liste)"string" "string"] — Die Versionsnummern einer oder mehrerer Versionen der Startvorlage, die gelöscht werden sollen.

    • [--min-versionstring] — Die Versionsnummer, nach der die Versionen der Startvorlagen beschrieben werden sollen.

    • [--max-versionstring] — Die Versionsnummer, bis zu der die Versionen der Startvorlagen beschrieben werden sollen.

    • --page-size — Die Größe jeder Seite, die im Aufruf abgerufen werden soll. Dieser Wert hat keinerlei Auswirkung auf die Anzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben wurden. Das Festlegen einer kleineren Seitengröße führt zu mehr Aufrufen an das Gerät, wodurch bei jedem Anruf weniger Elemente abgerufen werden. Auf diese Weise kann die Zeitüberschreitung von Aufrufen verhindert werden.

    • --max-items — Die Gesamtzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben werden sollen. Ist die Gesamtzahl der verfügbaren Elemente größer als der angegebene Wert, wird ein NextToken in der Ausgabe des Befehls bereitgestellt. Um die Seitennummerierung fortzusetzen, geben Sie den NextToken-Wert im starting-token-Argument eines nachfolgenden Befehls an.

    • --starting-token — Ein Token, um anzugeben, wo mit der Paginierung begonnen werden soll. Dieses Token ist der NextToken-Wert aus einer zuvor abgeschnittenen Antwort.

    • --endpoint snowballEndpoint — Ein Wert, mit dem Sie Ihre Compute-Instances mithilfe von EC2-compatible Amazon-API-Vorgängen programmgesteuert verwalten können. Weitere Informationen finden Sie unter Angeben des EC2-compatible Endpunkts als AWS CLI Endpunkt auf einer Snowball Edge.

  • describe-security-groups — Beschreibt eine oder mehrere Ihrer Sicherheitsgruppen.

    Beim Befehl describe-security-groups handelt es sich um eine paginierte Operation. Sie können mehrere API-Aufrufe ausführen, um den gesamten Ergebnisdatensatz abzurufen.

    • [--group-namevalue] — Der Name der Sicherheitsgruppe.

    • [--group-idvalue] — Die ID der Sicherheitsgruppe.

    • [--page-sizevalue] — Die Größe jeder Seite, die beim Serviceaufruf abgerufen werden soll.AWS Diese Größe hat keinerlei Auswirkung auf die Anzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben wurden. Die Einstellung einer kleineren Seitengröße führt zu mehr Aufrufen des AWS Dienstes, wodurch bei jedem Aufruf weniger Elemente abgerufen werden. Durch diesen Ansatz kann verhindert werden, dass bei AWS Serviceaufrufen ein Timeout auftritt. Anwendungsbeispiele finden Sie unter Pagination im AWS Command Line Interface Benutzerhandbuch.

    • [--max-itemsvalue] — Die Gesamtzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben werden sollen. Ist die Gesamtzahl der verfügbaren Elemente größer als der angegebene Wert, wird ein NextToken in der Ausgabe des Befehls bereitgestellt. Um die Seitennummerierung fortzusetzen, geben Sie den NextToken-Wert im starting-token-Argument eines nachfolgenden Befehls an. Verwenden Sie das NextToken Antwortelement nicht direkt außerhalb von.AWS CLI Anwendungsbeispiele finden Sie unter Pagination im AWS Command Line Interface Benutzerhandbuch.

    • [--starting-tokenvalue] — Ein Token, das angibt, wo mit der Paginierung begonnen werden soll. Dieses Token ist der NextToken-Wert aus einer zuvor abgeschnittenen Antwort. Anwendungsbeispiele finden Sie unter Pagination im Benutzerhandbuch.AWS Command Line Interface

  • describe-tags — Beschreibt eines oder mehrere der Tags für die angegebene Ressource (image,instance, oder Sicherheitsgruppe). Mit diesem Befehl werden die folgenden Filter unterstützt:

    • launch-template

    • resource-id

    • Ressourcentyp: image oder instance

    • key

    • value

  • describe-volumes — Beschreibt die angegebenen Amazon EBS-Volumes.

    • [--max-itemsvalue] — Die Gesamtzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben werden sollen. Ist die Gesamtzahl der verfügbaren Elemente größer als der angegebene Wert, wird ein NextToken in der Ausgabe des Befehls bereitgestellt. Um die Seitennummerierung fortzusetzen, geben Sie den NextToken-Wert im starting-token-Argument eines nachfolgenden Befehls an.

    • [--starting-tokenvalue] — Ein Token, das angibt, wo mit der Paginierung begonnen werden soll. Dieses Token ist der NextToken-Wert aus einer zuvor abgeschnittenen Antwort.

    • [--volume-ids] — Eine oder mehrere Volume-IDsvalue.

  • detach-volume — Trennt ein Amazon EBS-Volume von einer gestoppten oder laufenden Instance.

    • [--device] — Der Gerätenamevalue.

    • [--instance-id] — Die ID einer Amazon EC2 EC2-Zielinstanz.

    • --volume-id — Die ID value des Volumes.

  • disassociate-address – Entfernt eine virtuelle IP-Adresse von der Instance.

    • --public-ip — Die virtuelle IP-Adresse, die Sie von Ihrer Instance trennen möchten.

  • get-launch-template-data — Ruft die Konfigurationsdaten der angegebenen Instanz ab. Sie können diese Daten verwenden, um eine Startvorlage zu erstellen.

  • modify-launch-template — Ändert eine Startvorlage. Sie können angeben, welche Version der Startvorlage als Standardversion festgelegt werden soll. Wenn Sie eine Instance ohne Angabe einer Startvorlagenversion starten, wird die Standardversion der Startvorlage angewendet.

    Geben Sie in der Anfrage entweder die Startvorlagen-ID oder den Startvorlagennamen an.

    • string--launch-template-id — Die ID der Startvorlage.

    • --launch-template-name — Ein Name für die Startvorlagestring.

    • --default-version string — Die Versionsnummer der Startvorlage, die als Standardversion festgelegt werden soll.

    • --endpoint snowballEndpoint — Ein Wert, mit dem Sie Ihre Compute-Instances mithilfe von EC2-compatible Amazon-API-Vorgängen programmgesteuert verwalten können. Weitere Informationen finden Sie unter Angeben des EC2-compatible Endpunkts als AWS CLI Endpunkt auf einer Snowball Edge.

  • modify-instance-attribute — Ändert ein Attribut der angegebenen Instance. Folgende Attribute werden unterstützt:

    • instanceInitiatedShutdownBehavior

    • userData

  • revoke-security-group-egress — Entfernt eine oder mehrere Ausgangsregeln aus einer Sicherheitsgruppe:

    • [--group-id] — Die ID der Sicherheitsgruppe value

    • [--ip-permissionsvalue] — Ein oder mehrere Sätze von IP-Berechtigungen.

  • revoke-security-group-ingress — Widerruft eine oder mehrere Regeln für den Zugriff auf eine Sicherheitsgruppe. Wenn Sie revoke-security-group-ingress aufrufen, müssen Sie entweder für group-name oder für group-id einen Wert angeben.

    • [--group-name] — Der Name der Sicherheitsgruppe. value

    • [--group-idvalue] — Die ID der Sicherheitsgruppe.

    • [--ip-permissionsvalue] — Ein oder mehrere Sätze von IP-Berechtigungen.

    • [--protocol value] Das IP-Protokoll. Mögliche Werte sind tcp, udp und icmp. Das Argument --port ist erforderlich, es sei denn, es wird der Wert "alle Protokolle" (-1) angegeben.

    • [--portvalue] — Für TCP oder UDP der Bereich der Ports, die zugelassen werden sollen. Eine einzelne Ganzzahl oder ein Bereich (Minimal—Maximum).

      Für ICMP eine einzelne Ganzzahl oder ein Bereich (typecode), wobei bei type die Nummer des ICMP-Typs und code die ICMP-Codenummer darstellen. Der Wert -1 steht für alle ICMP-Codes für alle ICMP-Typen. Der Wert -1 nur für type gibt alle ICMP-Codes für den angegebenen ICMP-Typ an.

    • [--cidrvalue] — Der CIDR-IP-Bereich.

  • run-instances — Startet eine Reihe von Compute-Instances mithilfe einer Snowball-AMI-ID für ein AMI.

    Anmerkung

    Je nach Größe und Typ der Instanz kann es bis zu anderthalb Stunden dauern, bis eine Compute-Instance auf einem Snowball Edge gestartet wird.

    • [--block-device-mappings — Die Einträge für die (list)] Blockgerätezuweisung. Die Parameter DeleteOnTermination, VolumeSize und VolumeType werden unterstützt. Start-Volumes müssen den Typ sbg1 aufweisen.

      Die JSON-Syntax für diesen Befehl lautet wie folgt.

      { "DeviceName": "/dev/sdh", "Ebs": { "DeleteOnTermination": true|false, "VolumeSize": 100, "VolumeType": "sbp1"|"sbg1" } }
    • --count — Anzahl der zu startenden Instances. Wenn Sie nur eine einzige Zahl angeben, wird davon ausgegangen, dass diese die Mindestanzahl der zu startenden Instances darstellt (der Standardwert ist 1). Wenn ein Bereich in der Form von min:max angegeben wird, wird die erste Zahl als die minimale Anzahl der zu startenden Instances und die zweite als die maximale Anzahl der zu startenden Instances interpretiert.

    • --image-id — Die Snowball-AMI-ID des AMI, die Sie durch einen Anruf abrufen können. describe-images Um eine Instance zu starten, wird ein AMI benötigt.

    • -- InstanceInitiatedShutdownBehavior — Wenn Sie von Ihrer Instance aus ein Herunterfahren einleiten (mit einem Befehl wie Shutdown oder Poweroff), wird die Instance standardmäßig gestoppt. Sie können das Verhalten stattdessen ändern, sodass sie beendet wird. Die Parameter stop und terminate werden unterstützt. Der Standardwert ist stop. Weitere Informationen finden Sie unter Ändern des Verhaltens beim initiierten Herunterfahren der Instance im Amazon EC2 EC2-Benutzerhandbuch für Linux-Instances.

    • --instance-type – Der sbe-Instance-Typ.

    • --launch-template structure — Die Startvorlage, die zum Starten der Instances verwendet werden soll. Alle Parameter, die Sie im Befehl run-instances angeben, überschreiben die entsprechenden Parameter in der Startvorlage. Sie können den Namen oder die ID einer Einführungsvorlage angeben, jedoch nicht beides.

      { "LaunchTemplateId": "string", "LaunchTemplateName": "string", "Version": "string" }
    • --security-group-ids — Eine oder mehrere Sicherheitsgruppen-IDs. Sie können eine Sicherheitsgruppe erstellen mit. CreateSecurityGroup Wenn kein Wert angegeben wird, wird die ID für die Standard-Sicherheitsgruppe den erstellten Instances zugewiesen.

    • --tag-specifications — Die Tags, die beim Start auf die Ressourcen angewendet werden sollen. Instances können nur beim Start markiert werden. Die angegebenen Tags werden auf alle Instances angewendet, die beim Start erstell werden. Um eine Ressource mit einem Tag zu versehen, nachdem sie erstellt wurde, verwenden Sie create-tags.

    • --user-data — Die Benutzerdaten, die der Instanz zur Verfügung gestellt werden sollen. Wenn Sie die verwenden AWS CLI, wird die Base64-Kodierung für Sie durchgeführt, und Sie können den Text aus einer Datei laden. Andernfalls müssen Sie einen base64-kodierten Text bereitstellen.

    • --key-name (string) — Der Name des key pair. Sie können ein key pair mit CreateKeyPair oder erstellenImportKeyPair.

      Warnung

      Wenn Sie kein key pair angeben, können Sie keine Verbindung zur Instance herstellen, es sei denn, Sie wählen ein AMI, das so konfiguriert ist, dass Benutzer sich auf andere Weise anmelden können.

  • start-instances — Startet eine sbe Instance, die Sie zuvor gestoppt haben. Alle der Instance zugeordneten Ressourcen bleiben beim Starten und Stoppen erhalten. Sie werden jedoch gelöscht, wenn die Instance beendet wird.

    • --instance-ids – Die IDs einer oder mehrerer sbe-Instances, die auf dem Gerät gestoppt wurden.

  • stop-instances — Stoppt eine sbe Instance, die gerade läuft. Alle der Instance zugeordneten Ressourcen bleiben beim Starten und Stoppen erhalten. Sie werden jedoch gelöscht, wenn die Instance beendet wird.

    • --Instance-IDs: Die IDs einer oder mehrerer sbe-Instances, die auf dem Gerät gestoppt werden sollen.

  • terminate-instances — Fährt eine oder mehrere Instances herunter. Dieser Vorgang ist idempotent. Wenn Sie eine Instance mehr als einmal beenden, ist jeder Aufruf erfolgreich. Alle der Instance zugeordneten Ressourcen bleiben beim Starten und Stoppen erhalten. Die Daten werden jedoch gelöscht, wenn die Instance beendet wird.

    Anmerkung

    Wenn Sie einen Befehl wie shutdown oder poweroff zum Starten des Herunterfahrens über Ihre Instance verwenden, wird die Instance standardmäßig angehalten. Sie können das InstanceInitiatedShutdownBehavior Attribut jedoch verwenden, um dieses Verhalten so zu ändern, dass diese Befehle Ihre Instance beenden. Weitere Informationen finden Sie unter Ändern des Verhaltens beim initiierten Herunterfahren der Instance im Amazon EC2 EC2-Benutzerhandbuch für Linux-Instances.

    • --instance-ids — Die IDs einer oder mehrerer sbe Instances, die auf dem Gerät beendet werden sollen. Alle für diese Instances gespeicherten Daten gehen verloren.

  • create-key-pair — Erzeugt ein 2048-Bit-RSA-Schlüsselpaar mit dem angegebenen Namen. Amazon EC2 speichert den öffentlichen Schlüssel und zeigt den privaten Schlüssel an, den Sie in einer Datei speichern können. Der private Schlüssel wird als unverschlüsselter privater PEM-encoded PKCS #1 -Schlüssel zurückgegeben. Wenn ein Schlüssel mit dem angegebenen Namen bereits existiert, gibt Amazon EC2 einen Fehler zurück.

    • --key-name (string) — Ein eindeutiger Name für das key pair.

      Einschränkungen: Bis zu 255 ASCII-Zeichen.

    • [--tag-specifications] (Liste) — Die Tags, die auf das neue key pair angewendet werden sollen.

    { "ResourceType": "image"|"instance"|"key-pair"|"launch-template"|"security-group", "Tags": [ { "Key": "string", "Value": "string" } ... ] } ...
  • Schlüsselpaar importieren —

    • --key-name (string) — Ein eindeutiger Name für das key pair.

      Einschränkungen: Bis zu 255 ASCII-Zeichen.

    • --public-key-material (blob) — Der öffentliche Schlüssel. Für API-Aufrufe muss der Text Base64-codiert sein. Bei Befehlszeilentools wird die Base64-Kodierung für Sie durchgeführt.

    • [--tag-specifications] (Liste) — Die Tags, die auf das neue key pair angewendet werden sollen.

    { "ResourceType": "image"|"instance"|"key-pair"|"launch-template"|"security-group", "Tags": [ { "Key": "string", "Value": "string" } ... ] }
  • Schlüsselpaare beschreiben —

    [--filters] (Liste) — Die Filter.

    • key-pair-id — Die ID des key pair.

    • Schlüsselname — Der Name des key pair.

    • tag-key — Der Schlüssel eines der Ressource zugewiesenen Tags. Verwenden Sie diesen Filter, um alle Ressourcen zu finden, denen ein Tag mit einem bestimmten Schlüssel zugewiesen wurde, unabhängig vom Tag-Wert.

    • [--tag-specifications] (Liste) — Die Tags, die auf das neue key pair angewendet werden sollen.

    • tag:key — Die key/value Kombination eines der Ressource zugewiesenen Tags. Verwenden Sie den Tag-Schlüssel im Filternamen und den Tag-Wert als Filterwert. Um beispielsweise alle Ressourcen zu finden, die ein Tag mit dem Owner-Schlüssel und dem Wert Team A haben, geben Sie tag:Owner für den Filternamen und Team A für den Filterwert an.

    { "Name": "string", "Values": ["string", ...] } ...
  • [--key-names] (list) — Die Namen der key pair.

    Standard: Beschreibt alle Ihre Schlüsselpaare.

  • [--key-pair-ids] (Liste) — Die IDs der Schlüsselpaare.

  • Schlüsselpaar löschen —

    • [--key-name] (string) — Der Name des key pair.

    • [--key-pair-id] (string) — Die ID des key pair.

Unterstützte EC2-compatible Amazon-API-Operationen auf einem Snowball Edge

Im Folgenden finden Sie EC2-compatible Amazon-API-Operationen, die Sie mit einem Snowball Edge verwenden können, mit Links zu ihren Beschreibungen in der Amazon EC2-API-Referenz. EC2-compatible Amazon-API-Aufrufe erfordern eine Signatur mit Signature Version 4 (Sigv4). Wenn Sie das AWS CLI oder ein AWS SDK verwenden, um diese API-Aufrufe zu tätigen, wird die SigV4-Signatur für Sie übernommen. Andernfalls müssen Sie Ihre eigene SigV4 Signatur-Lösung implementieren. Weitere Informationen finden Sie unter Abrufen und Verwenden lokaler Amazon S3 S3-Anmeldeinformationen auf Snowball Edge.

  • AssociateAddress— Ordnet eine Elastic IP-Adresse einer Instance oder einer Netzwerkschnittstelle zu.

  • AttachVolume— Die folgenden Anforderungsparameter werden unterstützt:

    • Device

    • InstanceId

    • VolumeId

  • AuthorizeSecurityGroupEgress— Fügt einer Sicherheitsgruppe eine oder mehrere Ausgangsregeln zur Verwendung mit einem Snowball Edge-Gerät hinzu. Insbesondere diese Aktion erlaubt Instances, Datenverkehr an eine oder mehrere IPv4-CIDR-Zieladressbereiche zu senden.

  • AuthorizeSecurityGroupIngress— Fügt einer Sicherheitsgruppe eine oder mehrere Eingangsregeln hinzu. Beim Aufrufen AuthorizeSecurityGroupIngress müssen Sie entweder einen Wert für GroupName oder GroupId angeben.

  • CreateVolume— Die folgenden Anforderungsparameter werden unterstützt:

    • SnapshotId

    • Size

    • VolumeType

    • TagSpecification.N

  • CreateLaunchTemplate— Die folgenden Anforderungsparameter werden unterstützt:

    • ImageId

    • InstanceType

    • SecurityGroupIds

    • TagSpecifications

    • UserData

  • CreateLaunchTemplateVersion

  • CreateTags— Die folgenden Anforderungsparameter werden unterstützt:

    • AMI

    • Instance

    • Launch template

    • Security group

  • CreateSecurityGroup— Erzeugt eine Sicherheitsgruppe auf Ihrem Snowball Edge. Sie können bis zu 50 Sicherheitsgruppen erstellen. Wenn Sie eine Sicherheitsgruppe erstellen, geben Sie einen Anzeigenamen Ihrer Wahl an.

  • DeleteLaunchTemplate

  • DeleteLaunchTemplateVersions

  • DeleteSecurityGroup— Löscht eine Sicherheitsgruppe. Wenn Sie versuchen, eine Sicherheitsgruppe zu löschen, die mit einer Instance verknüpft ist, oder auf die von einer anderen Sicherheitsgruppe verwiesen wird, schlägt die Operation mit DependencyViolation fehl.

  • DeleteTags— Löscht den angegebenen Satz von Tags aus dem angegebenen Satz von Ressourcen.

  • DeleteVolume— Die folgenden Anforderungsparameter werden unterstützt:

    • VolumeId

  • DescribeAddresses

  • DescribeImages

  • DescribeInstanceAttribute— Die folgenden Attribute werden unterstützt:

    • instanceType

    • userData

  • DescribeInstanceStatus

  • DescribeLaunchTemplates

  • DescribeLaunchTemplateVersions

  • DescribeInstances

  • DescribeSecurityGroups— Beschreibt eine oder mehrere Ihrer Sicherheitsgruppen. DescribeSecurityGroupsist eine paginierte Operation. Sie können mehrere API-Aufrufe ausführen, um den gesamten Ergebnisdatensatz abzurufen.

  • DescribeTags— Mit diesem Befehl werden die folgenden Filter unterstützt:

    • resource-id

    • resource-type— Nur AMI oder Compute-Instance

    • key

    • value

  • DescribeVolume— Die folgenden Anforderungsparameter werden unterstützt:

    • MaxResults

    • NextToken

    • VolumeId.N

  • DetachVolume— Die folgenden Anforderungsparameter werden unterstützt:

    • Device

    • InstanceId

    • VolumeId

  • DisassociateAddress

  • GetLaunchTemplateData

  • ModifyLaunchTemplate

  • ModifyInstanceAttribute— Nur das userData Attribut wird unterstützt.

  • RevokeSecurityGroupEgress— Entfernt eine oder mehrere Ausgangsregeln aus einer Sicherheitsgruppe.

  • RevokeSecurityGroupIngress— Widerruft eine oder mehrere Eingangsregeln für eine Sicherheitsgruppe. Beim Aufrufen RevokeSecurityGroupIngress müssen Sie entweder einen Wert für group-name oder angeben. group-id

  • RunInstances

    Anmerkung

    Je nach Größe und Typ der Instanz kann es bis zu anderthalb Stunden dauern, bis eine Compute-Instance auf einem Snowball Edge gestartet wird.

  • StartInstances

  • StopInstances— Ressourcen, die einer gestoppten Instanz zugeordnet sind, bleiben bestehen. Sie können die Instance beenden, um diese Ressourcen freizugeben. Alle zugehörigen Daten werden jedoch gelöscht.

  • TerminateInstances