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.
# Importieren eines VM-Images auf ein Snowball Edge-Gerät
Sie können den AWS CLI und den Import/Export VM-Dienst verwenden, um ein Image einer virtuellen Maschine (VM) als Amazon Machine Image (AMI) auf das Snowball Edge-Gerät zu importieren. Nachdem Sie ein VM-Image importiert haben, registrieren Sie das Image als AMI und starten Sie es als Amazon EC2 -kompatible Instance.
Sie können dem Gerät AMIs etwas von Amazon EC2 hinzufügen, wenn Sie einen Auftrag zur Bestellung eines Snowball Edge-Geräts erstellen. Gehen Sie wie folgt vor, nachdem Sie das Snowball Edge-Gerät erhalten haben. Weitere Informationen finden Sie unter [Wählen Sie Ihre Rechen- und Speicheroptionen](create-job-common.md#compute-storage).
Sie können es auch verwenden AWS OpsHub , um die VM-Imagedatei hochzuladen. Weitere Informationen finden Sie [in diesem Handbuch unter Importieren eines Images auf Ihr Gerät als EC2 Amazon-kompatibles AMI](https://docs.aws.amazon.com/snowball/latest/developer-guide/manage-ec2.html#ec2-ami-import).
**Topics**
+ [Schritt 1: Bereiten Sie das VM-Image vor und laden Sie es auf das Snowball Edge-Gerät hoch](#prepare-image-cli)
+ [Schritt 2: Richten Sie die erforderlichen Berechtigungen auf dem Snowball Edge ein](#setup-permission-cli)
+ [Schritt 3: Importieren Sie das VM-Image als Snapshot auf Snowball Edge](#import-snapshot-cli)
+ [Schritt 4: Registrieren Sie den Snapshot als AMI auf dem Snowball Edge](#register-snapshot-cli)
+ [Schritt 5: Starten Sie eine Instance über das AMI auf dem Snowball Edge](#launch-ami-cli)
+ [Zusätzliche AMI-Aktionen für einen Snowball Edge](#additional-ami-actions)
## Schritt 1: Bereiten Sie das VM-Image vor und laden Sie es auf das Snowball Edge-Gerät hoch
Bereiten Sie das VM-Image vor, indem Sie ein VM-Image aus einem EC2 Amazon-AMI oder einer Instance in der AWS Cloud benutzenden VM exportieren Import/Export oder indem Sie das VM-Image lokal mit der Virtualisierungsplattform Ihrer Wahl generieren.
Informationen zum Exportieren einer EC2 Amazon-Instance als VM-Image mithilfe von VM Import/Export finden Sie unter [Exportieren einer Instanz als VM mithilfe von VM Import/Export](https://docs.aws.amazon.com/vm-import/latest/userguide/vmexport.html) im VM-Benutzerhandbuch. Import/Export Informationen zum Exportieren eines Amazon EC2 AMI als VM-Image mithilfe von VM Import/Export finden Sie unter [Exportieren einer VM direkt aus einem Amazon Machine Image (AMI)](https://docs.aws.amazon.com/vm-import/latest/userguide/vmexport_image.html) im Import/Export VM-Benutzerhandbuch.
Wenn Sie ein VM-Image aus Ihrer lokalen Umgebung generieren, stellen Sie sicher, dass das Image für die Verwendung als AMI auf dem Snowball Edge-Gerät konfiguriert ist. Abhängig von Ihrer Umgebung müssen Sie möglicherweise die folgenden Elemente konfigurieren.
+ Konfigurieren und aktualisieren Sie das Betriebssystem.
+ Legen Sie einen Hostnamen fest.
+ Stellen Sie sicher, dass das Network Time Protocol (NTP) konfiguriert ist.
+ Fügen Sie, falls erforderlich, öffentliche SSH-Schlüssel hinzu. Erstellen Sie lokale Kopien der Schlüsselpaare. Weitere Informationen finden Sie unter [SSH verwenden, um eine Connect zu Ihren Compute-Instances auf einem Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/ssh-ec2-edge.html) herzustellen.
+ Installieren und konfigurieren Sie jegliche Software, die Sie auf dem Snowball Edge-Gerät verwenden möchten.
**Anmerkung**
Beachten Sie die folgenden Einschränkungen, wenn Sie einen Festplatten-Snapshot für ein Snowball Edge-Gerät vorbereiten.
Snowball Edge unterstützt derzeit nur den Import von Schnappschüssen im RAW-Bildformat.
Snowball Edge unterstützt derzeit nur den Import von Snapshots mit Größen von 1 GB bis 1 TB.
### Hochladen eines VM-Images in einen Amazon S3 S3-Bucket auf dem Snowball Edge-Gerät
Nachdem Sie ein VM-Image vorbereitet haben, laden Sie es in einen S3-Bucket auf dem Snowball Edge-Gerät oder -Cluster hoch. Sie können den S3-Adapter oder Amazon S3 S3-kompatiblen Speicher auf Snowball Edge verwenden, um den Snapshot hochzuladen.
**Um das Image der virtuellen Maschine mit dem S3-Adapter hochzuladen**
+ Verwenden Sie den `cp` Befehl, um die VM-Image-Datei in einen Bucket auf dem Gerät zu kopieren.
```
aws s3 cp image-path s3://S3-bucket-name --endpoint http://S3-object-API-endpoint:443 --profile profile-name
```
Weitere Informationen finden Sie unter [Unterstützte AWS CLI Befehle](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-adapter-cli.html) in diesem Handbuch.
**Um das VM-Image mit Amazon S3 S3-kompatiblem Speicher auf Snowball Edge hochzuladen**
+ Verwenden Sie den `put-object` Befehl, um die Snapshot-Datei in einen Bucket auf dem Gerät zu kopieren.
```
aws s3api put-object --bucket bucket-name --key path-to-snapshot-file --body snapshot-file --endpoint-url s3api-endpoint-ip --profile your-profile
```
Weitere Informationen finden Sie unter [Arbeiten mit S3-Objekten auf einem Snowball Edge-Gerät](https://docs.aws.amazon.com/snowball/latest/developer-guide/objects-s3-snow.html).
## Schritt 2: Richten Sie die erforderlichen Berechtigungen auf dem Snowball Edge ein
Damit der Import erfolgreich ist, müssen Sie Berechtigungen für VM Import/Export auf dem Snowball Edge-Gerät EC2, Amazon und dem Benutzer einrichten.
**Anmerkung**
Die Servicerollen und Richtlinien, die diese Berechtigungen bereitstellen, befinden sich auf dem Snowball Edge-Gerät.
### Erforderliche Berechtigungen für VM Import/Export auf einem Snowball Edge
Bevor Sie den Importvorgang starten können, müssen Sie eine IAM-Rolle mit einer Vertrauensrichtlinie erstellen, die es einer VM Import/Export auf dem Snowball Edge-Gerät ermöglicht, die Rolle zu übernehmen. Der Rolle werden zusätzliche Berechtigungen erteilt, damit virtuelle Maschinen Import/Export auf dem Gerät auf das Bild zugreifen können, das im S3-Bucket auf dem Gerät gespeichert ist.
**Erstellen Sie eine JSON-Datei für Vertrauensrichtlinien**
Im Folgenden finden Sie ein Beispiel für eine Vertrauensrichtlinie, die an die Rolle angehängt werden muss, damit die VM auf den Snapshot zugreifen Import/Export kann, der aus dem S3-Bucket importiert werden muss.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Principal":{
"Service":"vmie.amazonaws.com"
},
"Action":"sts:AssumeRole"
}
]
}
```
------
**Erstellen Sie eine Rolle mit der JSON-Datei für die Vertrauensrichtlinie**
Der Rollenname kann vmimport lauten. Sie können ihn ändern, indem Sie die Option --role-name im Befehl verwenden:
```
aws iam create-role --role-name role-name --assume-role-policy-document file:///trust-policy-json-path --endpoint http://snowball-ip:6078 --region snow --profile profile-name
```
Im Folgenden finden Sie ein Beispiel für die Ausgabe des Befehls. `create-role`
```
{
"Role":{
"AssumeRolePolicyDocument":{
"Version":"2012-10-17",
"Statement":[
{
"Action":"sts:AssumeRole",
"Effect":"Allow",
"Principal":{
"Service":"vmie.amazonaws.com"
}
}
]
},
"MaxSessionDuration":3600,
"RoleId":"AROACEMGEZDGNBVGY3TQOJQGEZAAAABQBB6NSGNAAAABPSVLTREPY3FPAFOLKJ3",
"CreateDate":"2022-04-19T22:17:19.823Z",
"RoleName":"vmimport",
"Path":"/",
"Arn":"arn:aws:iam::123456789012:role/vmimport"
}
}
```
**Erstellen Sie eine Richtlinie für die Rolle**
Die folgende Beispielrichtlinie enthält die erforderlichen Mindestberechtigungen für den Zugriff auf Amazon S3. Ändern Sie den Namen des Amazon S3 S3-Buckets in den Namen, der Ihre Bilder enthält. Wechseln Sie bei einem eigenständigen Snowball Edge-Gerät *snow-id* zu Ihrer Job-ID. Wechseln Sie für einen Gerätecluster *snow-id* zur Cluster-ID. Sie können auch Präfixe verwenden, um den Ort, von dem virtuelle Maschinen Snapshots importieren Import/Export können, weiter einzugrenzen. Erstellen Sie eine Richtlinien-JSON-Datei wie diese.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Action":[
"s3:GetBucketLocation",
"s3:GetObject",
"s3:ListBucket",
"s3:GetMetadata"
],
"Resource":[
"arn:aws:s3:snow:account-id:snow/snow-id/bucket/import-snapshot-bucket-name",
"arn:aws:s3:snow:account-id:snow/snow-id/bucket/import-snapshot-bucket-name/*"
]
}
]
}
```
------
**Erstellen Sie eine Richtlinie mit der Richtliniendatei:**
```
aws iam create-policy --policy-name policy-name --policy-document file:///policy-json-file-path --endpoint http://snowball-ip:6078 --region snow --profile profile-name
```
Im Folgenden finden Sie ein Ausgabebeispiel für den Befehl create-policy.
```
{
"Policy":{
"PolicyName":"vmimport-resource-policy",
"PolicyId":"ANPACEMGEZDGNBVGY3TQOJQGEZAAAABOOEE3IIHAAAABWZJPI2VW4UUTFEDBC2R",
"Arn":"arn:aws:iam::123456789012:policy/vmimport-resource-policy",
"Path":"/",
"DefaultVersionId":"v1",
"AttachmentCount":0,
"IsAttachable":true,
"CreateDate":"2020-07-25T23:27:35.690000+00:00",
"UpdateDate":"2020-07-25T23:27:35.690000+00:00"
}
}
```
****Hängen Sie die Richtlinie an die Rolle an****
Fügen Sie der vorherigen Rolle eine Richtlinie hinzu und gewähren Sie Berechtigungen für den Zugriff auf die erforderlichen Ressourcen. Dadurch kann der lokale Import/Export VM-Dienst den Snapshot von Amazon S3 auf das Gerät herunterladen.
```
aws iam attach-role-policy --role-name role-name --policy-arn arn:aws:iam::123456789012:policy/policy-name --endpoint http://snowball-ip:6078 --region snow --profile profile-name
```
### Berechtigungen, die der Anrufer auf einem Snowball Edge benötigt
Zusätzlich zu der Rolle, die die Snowball Edge-VM Import/Export übernehmen muss, müssen Sie auch sicherstellen, dass der Benutzer über die Berechtigungen verfügt, die es ihm ermöglichen, die Rolle an VMIE zu übergeben. Wenn Sie den Standard-Root-Benutzer für den Import verwenden, verfügt der Root-Benutzer bereits über alle erforderlichen Berechtigungen. Sie können diesen Schritt also überspringen und mit Schritt 3 fortfahren.
Ordnen Sie dem Benutzer, der den Import durchführt, die folgenden beiden IAM-Berechtigungen zu.
+ `pass-role`
+ `get-role`
**Erstellen Sie eine Richtlinie für die Rolle**
Im Folgenden finden Sie ein Beispiel für eine Richtlinie, mit der ein Benutzer die `pass-role` Aktionen `get-role` und für die IAM-Rolle ausführen kann.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Action": "iam:GetRole",
"Resource":"*"
},
{
"Sid": "iamPassRole",
"Effect": "Allow",
"Action": "iam:PassRole",
"Resource": "arn:aws:iam::*:role/snowball*",
"Condition": {
"StringEquals": {
"iam:PassedToService": "importexport.amazonaws.com"
}
}
}
]
}
```
------
****Erstellen Sie eine Richtlinie mit der Richtliniendatei:****
```
aws iam create-policy --policy-name policy-name --policy-document file:///policy-json-file-path --endpoint http://snowball-ip:6078 --region snow --profile profile-name
```
Im Folgenden finden Sie ein Ausgabebeispiel für den Befehl create-policy.
```
{
"Policy":{
"PolicyName":"caller-policy",
"PolicyId":"ANPACEMGEZDGNBVGY3TQOJQGEZAAAABOOOTUOE3AAAAAAPPBEUM7Q7ARPUE53C6R",
"Arn":"arn:aws:iam::123456789012:policy/caller-policy",
"Path":"/",
"DefaultVersionId":"v1",
"AttachmentCount":0,
"IsAttachable":true,
"CreateDate":"2020-07-30T00:58:25.309000+00:00",
"UpdateDate":"2020-07-30T00:58:25.309000+00:00"
}
}
```
Nachdem die Richtlinie generiert wurde, hängen Sie die Richtlinie an die IAM-Benutzer an, die die EC2 Amazon-API- oder CLI-Operation aufrufen, um den Snapshot zu importieren.
```
aws iam attach-user-policy --user-name your-user-name --policy-arn arn:aws:iam::123456789012:policy/policy-name --endpoint http://snowball-ip:6078 --region snow --profile profile-name
```
### Erforderliche Berechtigungen, um Amazon EC2 APIs auf einem Snowball Edge aufzurufen
Um einen Snapshot zu importieren, muss der IAM-Benutzer über die `ec2:ImportSnapshot` entsprechenden Berechtigungen verfügen. Wenn eine Beschränkung des Zugriffs auf den Benutzer nicht erforderlich ist, können Sie die `ec2:*` Berechtigungen verwenden, um Amazon vollen EC2 Zugriff zu gewähren. Im Folgenden sind die Berechtigungen aufgeführt, die Amazon EC2 auf Ihrem Gerät gewährt oder eingeschränkt werden können. Erstellen Sie eine Richtliniendatei mit dem angezeigten Inhalt:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Action":[
"ec2:ImportSnapshot",
"ec2:DescribeImportSnapshotTasks",
"ec2:CancelImportTask",
"ec2:DescribeSnapshots",
"ec2:DeleteSnapshot",
"ec2:RegisterImage",
"ec2:DescribeImages",
"ec2:DeregisterImage"
],
"Resource":"*"
}
]
}
```
------
**Erstellen Sie eine Richtlinie mit der Richtliniendatei:**
```
aws iam create-policy --policy-name policy-name --policy-document file:///policy-json-file-path --endpoint http://snowball-ip:6078 --region snow --profile profile-name
```
Im Folgenden finden Sie ein Ausgabebeispiel für den Befehl create-policy.
```
{
"Policy":
{
"PolicyName": "ec2-import.json",
"PolicyId": "ANPACEMGEZDGNBVGY3TQOJQGEZAAAABQBGPDQC5AAAAATYN62UNBFYTF5WVCSCZS",
"Arn": "arn:aws:iam::123456789012:policy/ec2-import.json",
"Path": "/",
"DefaultVersionId": "v1",
"AttachmentCount": 0,
"IsAttachable": true,
"CreateDate": "2022-04-21T16:25:53.504000+00:00",
"UpdateDate": "2022-04-21T16:25:53.504000+00:00"
}
}
```
Nachdem die Richtlinie generiert wurde, hängen Sie die Richtlinie an die IAM-Benutzer an, die die EC2 Amazon-API- oder CLI-Operation aufrufen, um den Snapshot zu importieren.
```
aws iam attach-user-policy --user-name your-user-name --policy-arn arn:aws:iam::123456789012:policy/policy-name --endpoint http://snowball-ip:6078 --region snow --profile profile-name
```
## Schritt 3: Importieren Sie das VM-Image als Snapshot auf Snowball Edge
Der nächste Schritt besteht darin, das VM-Image als Snapshot auf das Gerät zu importieren. Der Wert des `S3Bucket` Parameters ist der Name des Buckets, der das VM-Image enthält. Der Wert des `S3Key` Parameters ist der Pfad zur VM-Image-Datei in diesem Bucket.
```
aws ec2 import-snapshot --disk-container "Format=RAW,UserBucket={S3Bucket=bucket-name,S3Key=image-file}" --endpoint http://snowball-ip:8008 --region snow --profile profile-name
```
Weitere Informationen finden Sie unter [import-snapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/import-snapshot.html) in der AWS CLI Befehlsreferenz.
Dieser Befehl unterstützt die folgenden Optionen nicht.
+ [--client-data`value`]
+ [--client-token] `value`
+ [--Trockenlauf]
+ [--no-dry-run]
+ [--verschlüsselt]
+ [--no-verschlüsselt]
+ [--kms-key-id `value`]
+ [--tag-spezifikationen] `value`
**Example Ausgabe des Befehls `import-snapshot`**
```
{
"ImportTaskId":"s.import-snap-1234567890abc",
"SnapshotTaskDetail":{
"DiskImageSize":2.0,
"Encrypted":false,
"Format":"RAW",
"Progress":"3",
"Status":"active",
"StatusMessage":"pending",
"UserBucket":{
"S3Bucket":"bucket",
"S3Key":"vmimport/image01"
}
}
}
```
Snowball Edge erlaubt derzeit nur die Ausführung eines aktiven Importauftrags gleichzeitig pro Gerät. Um eine neue Importaufgabe zu starten, warten Sie entweder, bis die aktuelle Aufgabe abgeschlossen ist, oder wählen Sie einen anderen verfügbaren Knoten in einem Cluster aus. Sie können den aktuellen Import auch abbrechen, wenn Sie möchten. Um Verzögerungen zu vermeiden, starten Sie das Snowball Edge-Gerät nicht neu, während der Import läuft. Wenn Sie das Gerät neu starten, schlägt der Import fehl und der Fortschritt wird gelöscht, sobald auf das Gerät zugegriffen werden kann. Verwenden Sie den folgenden Befehl, um den Status Ihrer Snapshot-Importaufgabe zu überprüfen:
```
aws ec2 describe-import-snapshot-tasks --import-task-ids id --endpoint http://snowball-ip:8008 --region snow --profile profile-name
```
## Schritt 4: Registrieren Sie den Snapshot als AMI auf dem Snowball Edge
Wenn der Snapshot-Import auf das Gerät erfolgreich ist, können Sie ihn mit dem `register-image` Befehl registrieren.
**Anmerkung**
Sie können ein AMI nur registrieren, wenn alle zugehörigen Snapshots verfügbar sind.
Weitere Informationen finden Sie unter [register-image](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/register-image.html) in der AWS CLI Befehlsreferenz.
**Example des Befehls `register-image`**
```
aws ec2 register-image \
--name ami-01 \
--description my-ami-01 \
--block-device-mappings "[{\"DeviceName\": \"/dev/sda1\",\"Ebs\":{\"Encrypted\":false,\"DeleteOnTermination\":true,\"SnapshotId\":\"snapshot-id\",\"VolumeSize\":30}}]" \
--root-device-name /dev/sda1 \
--endpoint http://snowball-ip:8008 \
--region snow \
--profile profile-name
```
Im Folgenden finden Sie ein Beispiel für die Blockgerätezuweisung im JSON-Format. Weitere Informationen finden Sie unter dem [block-device-mapping Parameter von register-image](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/register-image.html) in der AWS CLI Befehlsreferenz.
```
[
{
"DeviceName": "/dev/sda",
"Ebs":
{
"Encrypted": false,
"DeleteOnTermination": true,
"SnapshotId": "snapshot-id",
"VolumeSize": 30
}
}
]
```
**Example des Befehls `register-image`**
```
{
"ImageId": "s.ami-8de47d2e397937318"
}
```
## Schritt 5: Starten Sie eine Instance über das AMI auf dem Snowball Edge
Informationen zum Starten einer Instance finden Sie unter [run-instances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/run-instances.html) in der AWS CLI Befehlsreferenz.
Der Wert des `image-id` Parameters entspricht dem Wert des `ImageId` Namens als Ausgabe des `register-image` Befehls.
```
aws ec2 run-instances --image-id image-id --instance-type instance-type --endpoint http://snowball-ip:8008 --region snow --profile profile-name
```
```
{
"Instances":[
{
"SourceDestCheck":false,
"CpuOptions":{
"CoreCount":1,
"ThreadsPerCore":2
},
"InstanceId":"s.i-12345a73123456d1",
"EnaSupport":false,
"ImageId":"s.ami-1234567890abcdefg",
"State":{
"Code":0,
"Name":"pending"
},
"EbsOptimized":false,
"SecurityGroups":[
{
"GroupName":"default",
"GroupId":"s.sg-1234567890abc"
}
],
"RootDeviceName":"/dev/sda1",
"AmiLaunchIndex":0,
"InstanceType":"sbe-c.large"
}
],
"ReservationId":"s.r-1234567890abc"
}
```
**Anmerkung**
Sie können es auch verwenden AWS OpsHub , um die Instance zu starten. Weitere Informationen finden Sie unter [Starten einer EC2 Amazon-kompatiblen Instance](https://docs.aws.amazon.com/snowball/latest/developer-guide/manage-ec2.html#launch-instance) in diesem Handbuch.
## Zusätzliche AMI-Aktionen für einen Snowball Edge
Sie können zusätzliche AWS CLI Befehle verwenden, um den Status des Snapshot-Imports zu überwachen, Details zu importierten Snapshots abzurufen, den Import eines Snapshots abzubrechen und Snapshots nach dem Import zu löschen oder deren Registrierung aufzuheben.
### Überwachen des Snapshot-Importstatus auf einem Snowball Edge
Um den aktuellen Status des Importvorgangs zu sehen, können Sie den EC2 `describe-import-snapshot-tasks` Amazon-Befehl ausführen. Dieser Befehl unterstützt Paginierung und Filterung auf dem`task-state`.
**Example des Befehls `describe-import-snapshot-tasks`**
```
aws ec2 describe-import-snapshot-tasks --import-task-ids id --endpoint http://snowball-ip:8008 --region snow --profile profile-name
```
**Example der `describe-import-snapshot-tasks` Befehlsausgabe**
```
{
"ImportSnapshotTasks": [
{
"ImportTaskId": "s.import-snap-8f6bfd7fc9ead9aca",
"SnapshotTaskDetail": {
"Description": "Created by AWS-Snowball-VMImport service for s.import-snap-8f6bfd7fc9ead9aca",
"DiskImageSize": 8.0,
"Encrypted": false,
"Format": "RAW",
"Progress": "3",
"SnapshotId": "s.snap-848a22d7518ad442b",
"Status": "active",
"StatusMessage": "pending",
"UserBucket": {
"S3Bucket": "bucket1",
"S3Key": "image1"
}
}
}
]
}
```
**Anmerkung**
Dieser Befehl zeigt nur Ausgaben für Aufgaben an, die innerhalb der letzten 7 Tage erfolgreich abgeschlossen oder als gelöscht markiert wurden. Die Filterung unterstützt nur`Name=task-state`, `Values=active | deleting | deleted | completed`
Dieser Befehl unterstützt die folgenden Parameter nicht.
+ [--dry-run]
+ [--no-dry-run]
### Abbrechen einer Importaufgabe auf einem Snowball Edge
Um eine Importaufgabe abzubrechen, führen Sie den `cancel-import-task` Befehl aus.
**Example des `cancel-import-task` Befehls**
```
aws ec2 cancel-import-task --import-task-id import-task-id --endpoint http://snowball-ip:8008 --region snow --profile profile-name
```
**Example der `cancel-import-task` Befehlsausgabe**
```
{
"ImportTaskId": "s.import-snap-8234ef2a01cc3b0c6",
"PreviousState": "active",
"State": "deleting"
}
```
Nur Aufgaben, die sich nicht in einem abgeschlossenen Zustand befinden, können storniert werden.
Dieser Befehl unterstützt die folgenden Parameter nicht.
+ [--dry-run]
+ [--no-dry-run]
### Beschreibung von Schnappschüssen auf einem Snowball Edge
Nachdem ein Snapshot importiert wurde, können Sie ihn mit diesem Befehl beschreiben. Um die Snapshots zu filtern, können Sie sie `snapshot-ids` mit der Snapshot-ID aus der vorherigen Antwort auf die Importaufgabe übergeben. Dieser Befehl unterstützt Seitennummerierung und Filterung nach `volume-id``status`, und. `start-time`
**Example des `describe-snapshots` Befehls**
```
aws ec2 describe-snapshots --snapshot-ids snapshot-id --endpoint http://snowball-ip:8008 --region snow --profile profile-name
```
**Example der `describe-snapshots` Befehlsausgabe**
```
{
"Snapshots": [
{
"Description": "Created by AWS-Snowball-VMImport service for s.import-snap-8f6bfd7fc9ead9aca",
"Encrypted": false,
"OwnerId": "123456789012",
"SnapshotId": "s.snap-848a22d7518ad442b",
"StartTime": "2020-07-30T04:31:05.032000+00:00",
"State": "completed",
"VolumeSize": 8
}
]
}
```
Dieser Befehl unterstützt die folgenden Parameter nicht.
+ [--restorable-by-user-ids `value`]
+ [--dry-run]
+ [--no-dry-run]
### Löschen eines Snapshots von einem Snowball Edge-Gerät
Um Snapshots zu entfernen, die Ihnen gehören und die Sie nicht mehr benötigen, können Sie den `delete-snapshot` Befehl verwenden.
**Example des Befehls `delete-snapshot`**
```
aws ec2 delete-snapshot --snapshot-id snapshot-id --endpoint http://snowball-ip:8008 --region snow --profile profile-name
```
**Anmerkung**
Snowball Edge unterstützt nicht das Löschen von Snapshots, die sich im Status **PENDING** befinden oder wenn sie als Root-Gerät für ein AMI vorgesehen sind.
Dieser Befehl unterstützt die folgenden Parameter nicht.
+ [--dry-run]
+ [--no-dry-run]
### Abmeldung eines AMI auf einem Snowball Edge
Um die Registrierung eines nicht mehr benötigten Produkts aufzuheben AMIs , können Sie den Befehl ausführen. `deregister-image` Das Abmelden eines AMI, das sich im Status **Ausstehend** befindet, wird derzeit nicht unterstützt.
**Example des Befehls `deregister-image`**
```
aws ec2 deregister-image --image-id image-id --endpoint http://snowball-ip:8008 --region snow --profile profile-name
```
Dieser Befehl unterstützt die folgenden Parameter nicht.
+ [--dry-run]
+ [--no-dry-run]