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í
-
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
-
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: