CreateDeploymentJob - AWS RoboMaker

Aviso de fin del soporte: el 10 de septiembre de 2025, AWS dejaremos de ofrecer soporte a AWS RoboMaker. Después del 10 de septiembre de 2025, ya no podrás acceder a la AWS RoboMaker consola ni a AWS RoboMaker los recursos. Para obtener más información sobre la transición para ayudar AWS Batch a ejecutar simulaciones en contenedores, visite esta entrada de blog.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

CreateDeploymentJob

Esta acción ya no está disponible.

importante

Aviso de fin de soporte: el 10 de septiembre de 2025, AWS suspenderemos el soporte para AWS RoboMaker. Después del 10 de septiembre de 2025, ya no podrás acceder a la AWS RoboMaker consola ni a AWS RoboMaker los recursos. Para obtener más información sobre la transición para ayudar AWS Batch a ejecutar simulaciones en contenedores, visite esta entrada de blog.

importante

Esto ya no API es compatible y generará un error si se utiliza. Para más información, consulte la actualización del 31 de enero de 2022 en la página Política de soporte.

Implementa una versión específica de una aplicación de robot para los robots de una flota.

Por motivos de coherencia, la aplicación debe tener un valor numérico de applicationVersion. Para crear una nueva versión, utilice CreateRobotApplicationVersion o consulte Creación de una versión de aplicación de robot.

nota

Después de 90 días, los trabajos de implementación caducan y se eliminarán. Dejarán de estar disponibles.

Sintaxis de la solicitud

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" } }

URIParámetros de solicitud

La solicitud no utiliza ningún URI parámetro.

Cuerpo de la solicitud

La solicitud acepta los siguientes datos en JSON formato.

clientRequestToken

Identificador único con distinción entre mayúsculas y minúsculas que se proporciona para garantizar la idempotencia de la solicitud.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.

Patrón: [a-zA-Z0-9_\-=]*

Obligatorio: sí

deploymentApplicationConfigs

La configuración de la aplicación de implementación.

Tipo: matriz de objetos DeploymentApplicationConfig

Miembros de la matriz: número fijo de 1 artículo.

Obligatorio: sí

deploymentConfig

La configuración de implementación solicitada.

Tipo: objeto DeploymentConfig

Obligatorio: no

fleet

El nombre del recurso de Amazon (ARN) de la flota que se va a implementar.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1224.

Patrón: arn:.*

Obligatorio: sí

tags

Un mapa que contiene las claves y los valores de las etiquetas que se asocian al trabajo de implementación.

Tipo: mapa de cadena a cadena

Entradas de mapa: número mínimo de 0 elementos. Número máximo de 50 artículos.

Limitaciones de longitud de la clave: longitud mínima de 1. Longitud máxima de 128.

Patrón de clave: [a-zA-Z0-9 _.\-\/+=:]*

Limitaciones de longitud de los valores: longitud mínima de 0. La longitud máxima es de 256 caracteres.

Patrón de valores: [a-zA-Z0-9 _.\-\/+=:]*

Obligatorio: no

Sintaxis de la respuesta

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" } }

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta de HTTP 200.

El servicio devuelve los siguientes datos en JSON formato.

arn

El nombre del recurso de Amazon (ARN) del trabajo de despliegue.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1224.

Patrón: arn:.*

createdAt

El tiempo en milisegundos, desde la fecha de inicio, en que se creó la flota.

Tipo: marca temporal

deploymentApplicationConfigs

La configuración de la aplicación de implementación.

Tipo: matriz de objetos DeploymentApplicationConfig

Miembros de la matriz: número fijo de 1 artículo.

deploymentConfig

La configuración de la implementación.

Tipo: objeto DeploymentConfig

failureCode

El código de error del trabajo de simulación en caso de error:

BadPermissionError

AWSGreengrass requiere un permiso de rol de nivel de servicio para acceder a otros servicios. El rol debe incluir la política administrada de AWSGreengrassResourceAccessRolePolicy.

ExtractingBundleFailure

No se ha podido extraer la aplicación de robot de la agrupación.

FailureThresholdBreached

El porcentaje de robots que no se han podido actualizar ha superado el porcentaje establecido para la implementación.

GreengrassDeploymentFailed

No se ha podido implementar la aplicación de robot en el robot.

GreengrassGroupVersionDoesNotExist

Falta el grupo o la versión de AWS Greengrass asociados a un robot.

InternalServerError

Se ha producido un error de servicio interno. Vuelva a intentar realizar la solicitud. Si el problema persiste, póngase en contacto con nosotros para informarnos de ello.

MissingRobotApplicationArchitecture

La aplicación de robot no tiene un origen que coincida con la arquitectura del robot.

MissingRobotDeploymentResource

Faltan uno o varios de los recursos especificados para la aplicación de robot. Por ejemplo, ¿la aplicación de robot tiene el paquete de lanzamiento y el archivo de lanzamiento correctos?

PostLaunchFileFailure

Se ha producido un error relacionado con el script posterior al lanzamiento.

PreLaunchFileFailure

Se ha producido un error relacionado con el script previo al lanzamiento.

ResourceNotFound

Faltan uno o varios recursos de implementación. Por ejemplo, ¿siguen existiendo las agrupaciones de origen de la aplicación de robot?

RobotDeploymentNoResponse

No hay respuesta del robot. Es posible que no esté encendido o conectado a Internet.

Tipo: cadena

Valores válidos: 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

El motivo del error del trabajo de implementación, si se produjo un error.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 1024 caracteres.

Patrón: .*

fleet

La flota objetivo del trabajo de implementación.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1224.

Patrón: arn:.*

status

El estado del trabajo de implementación.

Tipo: cadena

Valores válidos: Pending | Preparing | InProgress | Failed | Succeeded | Canceled

tags

La lista con todas las etiquetas añadidas al trabajo de implementación.

Tipo: mapa de cadena a cadena

Entradas de mapa: número mínimo de 0 elementos. Número máximo de 50 artículos.

Limitaciones de longitud de la clave: longitud mínima de 1. Longitud máxima de 128.

Patrón de clave: [a-zA-Z0-9 _.\-\/+=:]*

Limitaciones de longitud de los valores: longitud mínima de 0. La longitud máxima es de 256 caracteres.

Patrón de valores: [a-zA-Z0-9 _.\-\/+=:]*

Errores

Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.

ConcurrentDeploymentException

Se alcanzó el porcentaje máximo de errores.

HTTPCódigo de estado: 400

IdempotentParameterMismatchException

La solicitud utiliza el mismo token de cliente que uno anterior, pero no la misma solicitud. No reutilice un token de cliente con diferentes solicitudes, a menos que las solicitudes sean idénticas.

HTTPCódigo de estado: 400

InternalServerException

AWS RoboMaker ha sufrido un problema con el servicio. Pruebe la llamada de nuevo.

HTTPCódigo de estado: 500

InvalidParameterException

Un parámetro especificado en una solicitud no es válido, no se admite o no se puede utilizar. El mensaje devuelto proporciona una explicación del valor del error.

HTTPCódigo de estado: 400

LimitExceededException

El recurso solicitado supera el número máximo permitido o el número de solicitudes de transmisión simultáneas supera el número máximo permitido.

HTTPCódigo de estado: 400

ResourceNotFoundException

El recurso especificado no existe.

HTTPCódigo de estado: 400

ThrottlingException

AWS RoboMaker no puede procesar la solicitud temporalmente. Pruebe la llamada de nuevo.

HTTPCódigo de estado: 400

Véase también

Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente: