UpdateJob - AWS Snowball
AnforderungssyntaxAnfrageparameterAntwortelementeFehlerWeitere Informationen finden Sie unter:

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.

UpdateJob

WährendJobState der StatusNew eines Auftrags in Auftrags Sobald der Job in einen anderen Auftragsstatus wechselt, normalerweise innerhalb von 60 Minuten nach der Erstellung des Jobs, ist diese Aktion nicht mehr verfügbar.

Anforderungssyntax

{
   "AddressId": "string",
   "Description": "string",
   "ForwardingAddressId": "string",
   "JobId": "string",
   "Notification": { 
      "JobStatesToNotify": [ "string" ],
      "NotifyAll": boolean,
      "SnsTopicARN": "string"
   },
   "OnDeviceServiceConfiguration": { 
      "EKSOnDeviceService": { 
         "EKSAnywhereVersion": "string",
         "KubernetesVersion": "string"
      },
      "NFSOnDeviceService": { 
         "StorageLimit": number,
         "StorageUnit": "string"
      },
      "TGWOnDeviceService": { 
         "StorageLimit": number,
         "StorageUnit": "string"
      }
   },
   "Resources": { 
      "Ec2AmiResources": [ 
         { 
            "AmiId": "string",
            "SnowballAmiId": "string"
         }
      ],
      "LambdaResources": [ 
         { 
            "EventTriggers": [ 
               { 
                  "EventResourceARN": "string"
               }
            ],
            "LambdaArn": "string"
         }
      ],
      "S3Resources": [ 
         { 
            "BucketArn": "string",
            "KeyRange": { 
               "BeginMarker": "string",
               "EndMarker": "string"
            },
            "TargetOnDeviceServices": [ 
               { 
                  "ServiceName": "string",
                  "TransferOption": "string"
               }
            ]
         }
      ]
   },
   "RoleARN": "string",
   "ShippingOption": "string",
   "SnowballCapacityPreference": "string"
}

Anfrageparameter

Informationen zu den Parametern, die allen Aktionen gemeinsam sind, finden Sie unter Allgemeine Parameter.

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

AddressId

Die ID des aktualisiertenAddress Objekts.

Typ: Zeichenfolge

Längenbeschränkungen:

Pattern: ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Erforderlich: Nein

Description

Die aktualisierte Beschreibung desJobMetadata Objekts dieses Jobs.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 1024 Zeichen.

Pattern: .*

Erforderlich: Nein

ForwardingAddressId

Dieses Feld wird in Ihrer Region nicht unterstützt.

Typ: Zeichenfolge

Längenbeschränkungen:

Pattern: ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Erforderlich: Nein

JobId

Die Job-ID des Jobs, den Sie aktualisieren möchten, zum BeispielJID123e4567-e89b-12d3-a456-426655440000.

Typ: Zeichenfolge

Längenbeschränkungen: Feste Länge von 39.

Pattern: (M|J)ID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Erforderlich: Ja

Notification

Das neue oder aktualisierteNotification Objekt.

Typ: Notification Objekt

Required: No

OnDeviceServiceConfiguration

Gibt den Dienst oder die Dienste auf dem Snow Family-Gerät an, aus denen Ihre übertragenen Daten exportiert oder in die Sie importiert werden. AWS Snow Family unterstützt Amazon S3 und NFS (Network File System) sowie denAWS Speicher-Gateway-Dienst vom Typ Tape Gateway.

Typ: OnDeviceServiceConfiguration Objekt

Required: No

Resources

Das aktualisierteJobResource Objekt oder das aktualisierteJobResource Objekt.

Typ: JobResource Objekt

Required: No

RoleARN

Die neue Rolle Amazon Resorad (ARN), die Sie dem Cluster zuordnen möchten. Verwenden Sie die API-Aktion CreateRoleAWS Identity and Access Management(IAM), um einen Rollen-ARN zu erstellen.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge von 255.

Pattern: arn:aws.*:iam::[0-9]{12}:role/.*

Erforderlich: Nein

ShippingOption

Der aktualisierte Versandoptionswert desShippingDetails Objekts dieses Auftrags.

Typ: Zeichenfolge

Zulässige Werte: SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD

Required: No

SnowballCapacityPreference

Die AktualisierungSnowballCapacityPreference desJobMetadata Objekts dieses Jobs. Die 50 TB Snowballs sind nur in den Regionen der USA.

Informationen zu den Gerätetypen von Snow Family finden Sie unter Geräte und Kapazitäten von Snow Family im Snowcone-Benutzerhandbuch oder Snow Family-Geräte und Kapazitäten im Snowball Edge-Benutzerhandbuch.

Typ: Zeichenfolge

Zulässige Werte: T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference

Required: No

Antwortelemente

Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.

Fehler

Hinweise zu den Fehlern, die allen Aktionen gemeinsam sind, finden Sie unterHäufige Fehler.

ClusterLimitExceededException

Job creation failed. Derzeit unterstützen Cluster fünf Knoten. Wenn Sie weniger als fünf Knoten für Ihren Cluster haben und Sie mehr Knoten für diesen Cluster erstellen müssen, versuchen Sie es erneut und erstellen Sie Jobs, bis Ihr Cluster genau fünf Knoten hat.

HTTP Status Code: 400

Ec2RequestFailedException

Ihrem IAM-Benutzer fehlen die erforderlichen Amazon EC2 EC2-Berechtigungen, um die versuchte Aktion auszuführen.

HTTP Status Code: 400

InvalidInputCombinationException

Job or cluster creation failed. Eine oder mehrere Eingaben waren ungültig. Vergewissern Sie sich, dass derSnowballType Wert CreateCluster: Ihren CreateJob: -Wert unterstütztJobType, und versuchen Sie es erneut.

HTTP Status Code: 400

InvalidJobStateException

Die Aktion kann nicht ausgeführt werden, da der aktuelle Status des Jobs die Ausführung dieser Aktion nicht zulässt.

HTTP Status Code: 400

InvalidResourceException

Die angegebene Ressource kann nicht gefunden werden. Überprüfen Sie die Informationen, die Sie in Ihrer letzten Anfrage angegeben

HTTP Status Code: 400

KMSRequestFailedException

Dem bereitgestelltenAWS Key Management Service Schlüssel fehlen die Berechtigungen, um die angegebeneCreateJobUpdateJob ODER-Aktion auszuführen.

HTTP Status Code: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: