CreateDeploymentJob - AWS RoboMaker
AnforderungssyntaxURIParameter anfordernAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

Ende des Supporthinweises: Am 10. September 2025 AWS wird der Support für AWS RoboMaker eingestellt. Nach dem 10. September 2025 können Sie nicht mehr auf die AWS RoboMaker Konsole oder die AWS RoboMaker Ressourcen zugreifen. Weitere Informationen AWS Batch zur Umstellung auf containerisierte Simulationen finden Sie in diesem Blogbeitrag.

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.

CreateDeploymentJob

Diese Aktion ist veraltet.

Wichtig

Hinweis zum Ende des Supports: Am 10. September 2025 AWS wird der Support für AWS RoboMaker eingestellt. Nach dem 10. September 2025 können Sie nicht mehr auf die AWS RoboMaker Konsole oder die AWS RoboMaker Ressourcen zugreifen. Weitere Informationen AWS Batch zur Umstellung auf containerisierte Simulationen finden Sie in diesem Blogbeitrag.

Wichtig

Dies API wird nicht mehr unterstützt und führt zu einem Fehler, wenn es verwendet wird. Weitere Informationen finden Sie im Update vom 31. Januar 2022 auf der Seite mit den Support-Richtlinien.

Stellt eine bestimmte Version einer Roboteranwendung für Roboter in einer Flotte bereit.

Aus Konsistenzgründen muss die Anwendung über eine nummerierte applicationVersion verfügen. Informationen zum Erstellen einer neuen Version finden Sie CreateRobotApplicationVersion unter Version einer Roboteranwendung erstellen.

Anmerkung

Nach 90 Tagen Bereitstellung verfallen Aufträge und werden gelöscht. Sie sind nicht mehr zugänglich.

Anforderungssyntax

POST /createDeploymentJob HTTP/1.1
Content-type: application/json

{
   "clientRequestToken": "string",
   "deploymentApplicationConfigs": [ 
      { 
         "application": "string",
         "applicationVersion": "string",
         "launchConfig": { 
            "environmentVariables": { 
               "string" : "string" 
            },
            "launchFile": "string",
            "packageName": "string",
            "postLaunchFile": "string",
            "preLaunchFile": "string"
         }
      }
   ],
   "deploymentConfig": { 
      "concurrentDeploymentPercentage": number,
      "downloadConditionFile": { 
         "bucket": "string",
         "etag": "string",
         "key": "string"
      },
      "failureThresholdPercentage": number,
      "robotDeploymentTimeoutInSeconds": number
   },
   "fleet": "string",
   "tags": { 
      "string" : "string" 
   }
}

URIParameter anfordern

Die Anfrage verwendet keine URI Parameter.

Anforderungstext

Die Anfrage akzeptiert die folgenden Daten im JSON Format.

clientRequestToken

Eindeutiger Bezeichner mit Berücksichtigung von Groß- und Kleinschreibung, den Sie angeben, um die Idempotenz der Anfrage sicherzustellen.

Typ: Zeichenfolge

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

Pattern: [a-zA-Z0-9_\-=]*

Erforderlich: Ja

deploymentApplicationConfigs

Die Konfiguration der Bereitstellungsanwendung.

Typ: Array von DeploymentApplicationConfig-Objekten

Array-Mitglieder: Feste Anzahl von 1 Element.

Erforderlich: Ja

deploymentConfig

Die angeforderte Bereitstellungskonfiguration.

Typ: DeploymentConfig Objekt

Erforderlich: Nein

fleet

Der Amazon-Ressourcenname (ARN) der Flotte, die bereitgestellt werden soll.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Die maximale Länge beträgt 1224.

Pattern: arn:.*

Erforderlich: Ja

tags

Eine Map, die Tag-Schlüssel und Tag-Werte enthält, die dem Deployment-Job zugeordnet sind.

Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge

Karteneinträge: Mindestanzahl von 0 Elementen. Die maximale Anzahl beträgt 50 Elemente.

Schlüssel-Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 128 Zeichen.

Schlüssel-Muster: [a-zA-Z0-9 _.\-\/+=:]*

Längenbeschränkungen für Werte: Mindestlänge von 0. Maximale Länge beträgt 256 Zeichen.

Wertemuster: [a-zA-Z0-9 _.\-\/+=:]*

Erforderlich: Nein

Antwortsyntax

HTTP/1.1 200
Content-type: application/json

{
   "arn": "string",
   "createdAt": number,
   "deploymentApplicationConfigs": [ 
      { 
         "application": "string",
         "applicationVersion": "string",
         "launchConfig": { 
            "environmentVariables": { 
               "string" : "string" 
            },
            "launchFile": "string",
            "packageName": "string",
            "postLaunchFile": "string",
            "preLaunchFile": "string"
         }
      }
   ],
   "deploymentConfig": { 
      "concurrentDeploymentPercentage": number,
      "downloadConditionFile": { 
         "bucket": "string",
         "etag": "string",
         "key": "string"
      },
      "failureThresholdPercentage": number,
      "robotDeploymentTimeoutInSeconds": number
   },
   "failureCode": "string",
   "failureReason": "string",
   "fleet": "string",
   "status": "string",
   "tags": { 
      "string" : "string" 
   }
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Dienst eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Dienst im JSON Format zurückgegeben.

arn

Der Amazon-Ressourcenname (ARN) des Bereitstellungsauftrags.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Die maximale Länge beträgt 1224.

Pattern: arn:.*

createdAt

Die Zeit in Millisekunden seit der Epoche, als die Flotte geschaffen wurde.

Typ: Zeitstempel

deploymentApplicationConfigs

Die Konfiguration der Bereitstellungsanwendung.

Typ: Array von DeploymentApplicationConfig-Objekten

Array-Mitglieder: Feste Anzahl von 1 Element.

deploymentConfig

Die Bereitstellungskonfiguration.

Typ: DeploymentConfig Objekt

failureCode

Der Fehlercode des Simulationsjobs, falls er fehlgeschlagen ist:

BadPermissionError

AWSGreengrass benötigt eine Rollenberechtigung auf Dienstebene, um auf andere Dienste zugreifen zu können. Die Rolle muss die AWSGreengrassResourceAccessRolePolicyverwaltete Richtlinie enthalten.

ExtractingBundleFailure

Die Roboteranwendung konnte nicht aus dem Paket extrahiert werden.

FailureThresholdBreached

Der Prozentsatz der Roboter, die nicht aktualisiert werden konnten, hat den für die Bereitstellung festgelegten Prozentsatz überschritten.

GreengrassDeploymentFailed

Die Roboteranwendung konnte nicht für den Roboter bereitgestellt werden.

GreengrassGroupVersionDoesNotExist

Die einem Roboter zugeordnete AWS Greengrass-Gruppe oder -Version fehlt.

InternalServerError

Ein interner Fehler ist aufgetreten. Versuchen Sie es erneut mit Ihrer Anfrage, aber wenn das Problem weiterhin besteht, kontaktieren Sie uns mit weiteren Informationen.

MissingRobotApplicationArchitecture

Die Roboteranwendung hat keine Quelle, die der Architektur des Roboters entspricht.

MissingRobotDeploymentResource

Eine oder mehrere der für die Roboteranwendung angegebenen Ressourcen fehlen. Verfügt die Roboteranwendung beispielsweise über das richtige Startpaket und die richtige Startdatei?

PostLaunchFileFailure

Das Post-Launch-Skript ist fehlgeschlagen.

PreLaunchFileFailure

Das Pre-Launch-Skript ist fehlgeschlagen.

ResourceNotFound

Eine oder mehrere Bereitstellungsressourcen fehlen. Existieren beispielsweise noch Quellpakete für Roboteranwendungen?

RobotDeploymentNoResponse

Es gibt keine Antwort vom Roboter. Er ist möglicherweise nicht eingeschaltet oder nicht mit dem Internet verbunden.

Typ: Zeichenfolge

Zulässige Werte: ResourceNotFound | EnvironmentSetupError | EtagMismatch | FailureThresholdBreached | RobotDeploymentAborted | RobotDeploymentNoResponse | RobotAgentConnectionTimeout | GreengrassDeploymentFailed | InvalidGreengrassGroup | MissingRobotArchitecture | MissingRobotApplicationArchitecture | MissingRobotDeploymentResource | GreengrassGroupVersionDoesNotExist | LambdaDeleted | ExtractingBundleFailure | PreLaunchFileFailure | PostLaunchFileFailure | BadPermissionError | DownloadConditionFailed | BadLambdaAssociated | InternalServerError | RobotApplicationDoesNotExist | DeploymentFleetDoesNotExist | FleetDeploymentTimeout

failureReason

Der Fehlergrund des Bereitstellungsauftrags, falls er fehlgeschlagen ist.

Typ: Zeichenfolge

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

Pattern: .*

fleet

Die Zielflotte für den Einsatzjob.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Die maximale Länge beträgt 1224.

Pattern: arn:.*

status

Der Status des Bereitstellungsauftrags.

Typ: Zeichenfolge

Zulässige Werte: Pending | Preparing | InProgress | Failed | Succeeded | Canceled

tags

Die Liste aller Tags, die dem Bereitstellungsauftrag hinzugefügt wurden.

Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge

Karteneinträge: Mindestanzahl von 0 Elementen. Die maximale Anzahl beträgt 50 Elemente.

Schlüssel-Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 128 Zeichen.

Schlüssel-Muster: [a-zA-Z0-9 _.\-\/+=:]*

Längenbeschränkungen für Werte: Mindestlänge von 0. Maximale Länge beträgt 256 Zeichen.

Wertemuster: [a-zA-Z0-9 _.\-\/+=:]*

Fehler

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.

ConcurrentDeploymentException

Der prozentuale Schwellenwert für den Ausfall wurde erreicht.

HTTPStatuscode: 400

IdempotentParameterMismatchException

Für die Anforderung wird das gleiche Client-Token wie für eine vorherige, aber nicht identische Anforderung verwendet. Verwenden Sie keine Client-Token für mehrere Anforderungen, es sei denn, die Anforderungen sind identisch.

HTTPStatuscode: 400

InternalServerException

AWS RoboMaker es ist ein Serviceproblem aufgetreten. Wiederholen Sie den Aufruf.

HTTPStatuscode: 500

InvalidParameterException

Ein Parameter in einer Anforderung ist nicht gültig, wird nicht unterstützt oder kann nicht verwendet werden. Die zurückgegebene Nachricht enthält eine Erläuterung des Fehlers.

HTTPStatuscode: 400

LimitExceededException

Die angeforderte Ressource überschreitet die maximal zulässige Anzahl, oder die Anzahl gleichzeitiger Stream-Anfragen überschreitet die zulässige Höchstzahl.

HTTPStatuscode: 400

ResourceNotFoundException

Die angegebene Ressource ist nicht vorhanden.

HTTPStatuscode: 400

ThrottlingException

AWS RoboMaker kann die Anfrage vorübergehend nicht bearbeiten. Wiederholen Sie den Aufruf.

HTTPStatuscode: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: