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
Esta API ya no es compatible y generará un error si se usa. 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"
}
}Parámetros de solicitud del URI
La solicitud no utiliza ningún parámetro de URI.
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- clientRequestToken
-
Identificador único con distinción entre mayúsculas y minúsculas que se proporciona para garantizar la idempotencia de la solicitud.
Tipo: string
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 de recurso de Amazon (ARN) de la flota que se va a implementar.
Tipo: string
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 HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- arn
-
El nombre de recurso de Amazon (ARN) del trabajo de implementación.
Tipo: string
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
-
AWS Greengrass necesita 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: string
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.
Código de estado HTTP: 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.
Código de estado HTTP: 400
- InternalServerException
-
AWS RoboMaker ha tenido un problema con el servicio. Pruebe la llamada de nuevo.
Código de estado HTTP: 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.
Código de estado HTTP: 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.
Código de estado HTTP: 400
- ResourceNotFoundException
-
El recurso especificado no existe.
Código de estado HTTP: 400
- ThrottlingException
-
AWS RoboMaker no puede procesar la solicitud temporalmente. Pruebe la llamada de nuevo.
Código de estado HTTP: 400
Véase también
Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulte lo siguiente:
