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
-
Connect den Snowball Edge mit Strom und Netzwerk und schalten Sie ihn ein.
-
Notieren Sie nach dem Entsperren des Geräts seine IP-Adresse im lokalen Netzwerk.
-
Stellen Sie sicher, dass Sie Snowball Edge von einem Terminal in Ihrem Netzwerk aus pingen können.
-
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. -
Speichern Sie die Ausgabe des
snowballEdge get-certificate
-Befehls in einer Datei, z. B.ca-bundle.pem
. -
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ätename
value
. -
--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-permissions
value
] — 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ürgroup-name
oder fürgroup-id
einen Wert angeben.-
[--group-name
value
] — Der Name der Sicherheitsgruppe. -
[--group-id
value
] — Die ID der Sicherheitsgruppe -
[--ip-permissions
value
] — Ein oder mehrere Sätze von IP-Berechtigungen. -
[--protocol
value
] Das IP-Protokoll. Mögliche Werte sindtcp
,udp
undicmp
. Das Argument--port
ist erforderlich, es sei denn, es wird der Wert "alle Protokolle" (-1) angegeben. -
[--port
value
] — 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 dietype
ICMP Typnummer und die Codenummercode
darstellt. ICMP Der Wert -1 gibt alle ICMP Codes für alle ICMP Typen an. Ein Wert von -1 nur fürtype
gibt alle ICMP Codes für den angegebenen ICMP Typ an. -
[--cidr
value
] — 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-description
string
] — 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-version
string
] — Die Versionsnummer der Startvorlage, auf der die neue Version basieren soll. Die neue Version übernimmt alle Startparameter der Quellversion, ausgenommen der von Ihnen inlaunch-template-data
angegebenen Parameter. -
[--version-description
string
] — 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.
-
[--size
value
] — Die Größe des Volumes in GiBs, die zwischen 1 GiB und 1 TB (1000 GiBs) liegen kann. -
[--snapshot-id
value
] — Der Snapshot, aus dem das Volume erstellt werden soll. -
[--volume-type] — Der Volume-Typ
value
. Wenn kein Wert angegeben wird, lautet der Standardwertsbg1
. Die folgenden Werte sind möglich:-
sbg1
für magnetische Volumes -
sbp1
für SSD Volumen
-
-
[--tag-specification
value
] — 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.
-
-- launch-template-id
string
— Die ID der Startvorlage. -
-- launch-template-name
string
— Ein Name für die 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.
-
-
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 denNextToken
-Wert imstarting-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 Namereachability
(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 Fehlerantwort
DryRunOperation
.Andernfalls ist es
UnauthorizedOperation
.[--include-all-instances | --no-include-all-instances]
(boolescher Wert)Wann
true
, 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 einNextToken
in der Ausgabe des Befehls bereitgestellt. Um die Seitennummerierung fortzusetzen, geben Sie denNextToken
-Wert imstarting-token
-Argument eines nachfolgenden Befehls an.[--starting-token]
(string) — Ein Token, um anzugeben, wo mit der Paginierung begonnen werden soll. Dieses Token ist derNextToken
-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 denNextToken
-Wert imstarting-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-version
string
] — Die Versionsnummer, nach der die Versionen der Startvorlagen beschrieben werden sollen. -
[--max-version
string
] — 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 denNextToken
-Wert imstarting-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-name
value
] — Der Name der Sicherheitsgruppe. -
[--group-id
value
] — Die ID der Sicherheitsgruppe. -
[--page-size
value
] — 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-items
value
] — 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 einNextToken
in der Ausgabe des Befehls bereitgestellt. Um die Seitennummerierung fortzusetzen, geben Sie denNextToken
-Wert imstarting-token
-Argument eines nachfolgenden Befehls an. Verwenden Sie dasNextToken
Antwortelement nicht direkt außerhalb von. AWS CLI Anwendungsbeispiele finden Sie unter Pagination im AWS Command Line Interface Benutzerhandbuch. -
[--starting-token
value
] — Ein Token, das angibt, wo mit der Paginierung begonnen werden soll. Dieses Token ist derNextToken
-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
oderinstance
-
key
-
Wert
-
-
describe-volumes — Beschreibt die angegebenen EBS Amazon-Volumes.
-
[--max-items
value
] — 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 einNextToken
in der Ausgabe des Befehls bereitgestellt. Um die Seitennummerierung fortzusetzen, geben Sie denNextToken
-Wert imstarting-token
-Argument eines nachfolgenden Befehls an. -
[--starting-token
value
] — Ein Token, das angibt, wo mit der Paginierung begonnen werden soll. Dieses Token ist derNextToken
-Wert aus einer zuvor abgeschnittenen Antwort. -
[--volume-ids] — Ein oder mehrere Volumes
value
. 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.
-
--instance-id – Die ID einer einzelnen
sbe
-Instance. -
--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-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-id
value
] — Die ID der Sicherheitsgruppe -
[--ip-permissions
value
] — 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ürgroup-name
oder fürgroup-id
einen Wert angeben.-
[--group-name
value
] — Der Name der Sicherheitsgruppe. -
[--group-id
value
] — Die ID der Sicherheitsgruppe. -
[--ip-permissions
value
] — Ein oder mehrere Sätze von IP-Berechtigungen. -
[--protocol
value
] Das IP-Protokoll. Mögliche Werte sindtcp
,udp
undicmp
. Das Argument--port
ist erforderlich, es sei denn, es wird der Wert "alle Protokolle" (-1) angegeben. -
[--port
value
] — 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 dietype
ICMP Typnummer und die Codenummercode
darstellt. ICMP Der Wert -1 gibt alle ICMP Codes für alle ICMP Typen an. Ein Wert von -1 nur fürtype
gibt alle ICMP Codes für den angegebenen ICMP Typ an. -
[--cidr
value
] — 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 ParameterDeleteOnTermination
,VolumeSize
undVolumeType
werden unterstützt. Start-Volumes müssen den Typsbg1
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
undterminate
werden unterstützt. Der Standardwert iststop
. 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 Befehlrun-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 Instanz
sbe
, 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
oderpoweroff
zum Starten des Herunterfahrens über Ihre Instance verwenden, wird die Instance standardmäßig angehalten. Sie können dasInstanceInitiatedShutdownBehavior
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" } ... ] } ...
-
-
-
--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" } ... ] }
-
-
[--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 WertTeam A
haben, geben Sietag:Owner
für den Filternamen undTeam 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.
-
-
[--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
oderGroupId
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
-
-
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.
-
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
-
-
DescribeInstanceAttribute— Die folgenden Attribute werden unterstützt:
-
instanceType
-
userData
-
-
DescribeSecurityGroups— Beschreibt eine oder mehrere Ihrer Sicherheitsgruppen.
DescribeSecurityGroups
ist 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
-
-
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
-
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.
-
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.