Verwenden des EC2 Amazon-kompatiblen Endpunkts auf einem Snow Family-Gerät - AWS Snowball Edge Leitfaden für Entwickler

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 Amazon-kompatiblen Endpunkts auf einem Snow Family-Gerät

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

Geben Sie den EC2 -kompatiblen Endpunkt als Endpunkt auf einem Snow AWS CLI Family-Gerät an

Wenn Sie den verwenden AWS CLI , um einen Befehl an das AWS Snowball Edge Gerät zu senden, können Sie angeben, dass es sich bei dem Endpunkt um den EC2 Amazon-kompatiblen Endpunkt handelt. Sie haben die Wahl, den Endpunkt oder einen ungesicherten HTTPS HTTP Endpunkt zu verwenden, wie im Folgenden dargestellt.

HTTPSgesicherter Endpunkt

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

HTTPungesicherter Endpunkt

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

Wenn Sie den HTTPS Endpunkt von verwenden8243, 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 Amazon-kompatiblen 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 Snow Family-Geräten.

  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

Nachdem Sie das Verfahren abgeschlossen haben, können Sie CLI Befehle mit diesen lokalen Anmeldeinformationen, Ihrem Zertifikat und Ihrem angegebenen Endpunkt ausführen.

Unterstützte EC2 Amazon-kompatible AWS CLI Befehle auf einem Snow Family-Gerät

Sie können Ihre Compute-Instances auf einem Snow Family-Gerät über einen EC2 Amazon-kompatiblen Endpunkt verwalten. Dieser Endpunkttyp unterstützt viele der EC2 CLI Amazon-Befehle und -Aktionen von 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 -kompatiblen AWS CLI Befehle auf einem Snow Family-Gerät

Im Folgenden finden Sie eine Beschreibung der Teilmenge der AWS CLI Befehle und Optionen für AmazonEC2, 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 EBS Amazon-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 — Der Gerätenamevalue.

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

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

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

    • --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 Eingangsregeln 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-namevalue] — 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 oderUDP, den Bereich der Ports, die zugelassen werden sollen. Dieser Wert kann eine einzelne Ganzzahl oder ein Bereich (Minimum—Maximum) sein.

      FürICMP, eine einzelne Ganzzahl oder ein Bereich (type-code), der die type ICMP Typnummer und die Codenummer code darstellt. ICMP Der Wert -1 gibt alle ICMP Codes für alle ICMP Typen an. Ein Wert von -1 nur für type gibt alle ICMP Codes für den angegebenen ICMP Typ an.

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

  • create-launch-template— Erstellt 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 structure — Die Informationen für die Startvorlage. Folgende Attribute werden unterstützt:

      • ImageId

      • InstanceType

      • SecurityGroupIds

      • TagSpecifications

      • UserData

      JSONSyntax:

      { "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 Amazon EC2 -kompatiblen Vorgängen programmgesteuert verwalten können. API Weitere Informationen finden Sie unter Geben Sie den EC2 -kompatiblen Endpunkt als Endpunkt auf einem Snow AWS CLI Family-Gerät an.

  • 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.

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

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

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

      • ImageId

      • InstanceType

      • SecurityGroupIds

      • TagSpecifications

      • UserData

      JSONSyntax:

      { "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 Amazon EC2 -kompatiblen Vorgängen programmgesteuert verwalten können. API Weitere Informationen finden Sie unter Geben Sie den EC2 -kompatiblen Endpunkt als Endpunkt auf einem Snow AWS CLI Family-Gerät an.

  • 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— 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:

    • --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.

  • create-volume — Erstellt ein EBS Amazon-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

      • sbp1für SSD Volumen

    • [--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.

  • 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 string — Ein Name für die Startvorlage.

    • --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 Amazon EC2 -kompatiblen Vorgängen programmgesteuert verwalten können. API Weitere Informationen finden Sie unter Geben Sie den EC2 -kompatiblen Endpunkt als Endpunkt auf einem Snow AWS CLI Family-Gerät an.

  • 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, Recheninstanz, Startvorlage oder Sicherheitsgruppe).

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

    • --volume-id — Die ID value 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 Bilder (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 AMI Schneeball-ID des. AMI

  • describe-instance-attribute— Beschreibt das angegebene Attribut der angegebenen Instanz. 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 einer oder IDs mehrerer sbe Instanzen, 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 bei laufenden EC2 Amazon-kompatiblen 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 Instance (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).

    • JSONSyntax:

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

      Die InstanzIDs.

      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 Namen der Startvorlage IDs oder der Startvorlage an.

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

    • -- launch-template-names (Liste) "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 Amazon EC2 -kompatiblen Vorgängen programmgesteuert verwalten können. API Weitere Informationen finden Sie unter Geben Sie den EC2 -kompatiblen Endpunkt als Endpunkt auf einem Snow AWS CLI Family-Gerät an.

  • 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 Namen der Startvorlage IDs oder der Startvorlage an.

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

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

    • [--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 Amazon EC2 -kompatiblen Vorgängen programmgesteuert verwalten können. API Weitere Informationen finden Sie unter Geben Sie den EC2 -kompatiblen Endpunkt als Endpunkt auf einem Snow AWS CLI Family-Gerät an.

  • 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 tätigen, 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

    • Wert

  • describe-volumes — Beschreibt die angegebenen EBS Amazon-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] — Ein oder mehrere Volumesvalue. IDs

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

    • [--device] — Der value Gerätename.

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

    • --volume-id value — Die ID 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.

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

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

    • --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 Amazon EC2 -kompatiblen Vorgängen programmgesteuert verwalten können. API Weitere Informationen finden Sie unter Geben Sie den EC2 -kompatiblen Endpunkt als Endpunkt auf einem Snow AWS CLI Family-Gerät an.

  • 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-idvalue] — Die ID der Sicherheitsgruppe

    • [--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-namevalue] — 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 oderUDP, den Bereich der Ports, die zugelassen werden sollen. Eine einzelne Ganzzahl oder ein Bereich (Minimum—Maximum).

      ForICMP, eine einzelne Ganzzahl oder ein Bereich (type-code), der die type ICMP Typnummer und die Codenummer code darstellt. ICMP Der Wert -1 gibt alle ICMP Codes für alle ICMP Typen an. Ein Wert von -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 AMI Snowball-ID für eine. 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 (list)] — Die blockierten Gerätezuordnungseinträge. 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 AMI Snowball-ID vonAMI, die Sie erhalten können, indem Sie anrufen. describe-images Ein AMI ist erforderlich, um eine Instance zu starten.

    • -- 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 EC2Amazon-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 mit der Instance herstellen, es sei denn, Sie wählen eineAMI, die so konfiguriert ist, dass Benutzer sich auf andere Weise anmelden können.

  • start-instances — Startet eine sbe Instanz, 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 einer oder IDs mehrerer sbe Instanzen, die auf dem Gerät gestoppt wurden.

  • stop-instances — Stoppt eine Instanzsbe, 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 einer oder IDs mehrerer sbe Instanzen, die auf dem Gerät gestoppt werden sollen.

  • terminate-instances — Fährt eine oder mehrere Instanzen 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 EC2Amazon-Benutzerhandbuch für Linux-Instances.

    • --instance-ids — Die einer oder IDs 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 RSA 2048-Bit-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, mit PKCS #1 PEM codierter privater Schlüssel zurückgegeben. Wenn ein Schlüssel mit dem angegebenen Namen bereits existiert, gibt Amazon einen Fehler EC2 zurück.

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

      Einschränkungen: Bis zu 255 Zeichen. ASCII

    • [--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" } ... ] } ...
  • import-key-pair

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

      Einschränkungen: Bis zu 255 Zeichen. ASCII

    • -- public-key-material (blob) — Der öffentliche Schlüssel. Für API Anrufe 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" } ... ] }
  • describe-key-pairs

    [--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 Schlüssel/Wert-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) — Das IDs der Schlüsselpaare.

  • delete-key-pair

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

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

Unterstützte EC2 Amazon-kompatible API Operationen auf einem Snow Family-Gerät

Im Folgenden finden Sie EC2 Amazon-kompatible API Operationen, die Sie mit einem Snowball Edge verwenden können, mit Links zu ihren Beschreibungen in der EC2APIAmazon-Referenz.EC2Amazon-kompatible API Anrufe erfordern eine Signatur mit Signature Version 4 (Sigv4). Wenn Sie das AWS CLI oder an verwenden, um diese API Aufrufe AWS SDK 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 Snow Family-Geräten.

  • 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 ermöglicht diese Aktion Instances, Traffic an einen 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— AMI oder nur Recheninstanz

    • 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