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.
DescribeSimulationJob
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.
Describe un trabajo de simulación.
Sintaxis de la solicitud
POST /describeSimulationJob HTTP/1.1
Content-type: application/json
{
"job": "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.
- job
-
El nombre del recurso de Amazon (ARN) del trabajo de simulación que se va a describir.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1224.
Patrón:
arn:.*Obligatorio: sí
Sintaxis de la respuesta
HTTP/1.1 200
Content-type: application/json
{
"arn": "string",
"clientRequestToken": "string",
"compute": {
"computeType": "string",
"gpuUnitLimit": number,
"simulationUnitLimit": number
},
"dataSources": [
{
"destination": "string",
"name": "string",
"s3Bucket": "string",
"s3Keys": [
{
"etag": "string",
"s3Key": "string"
}
],
"type": "string"
}
],
"failureBehavior": "string",
"failureCode": "string",
"failureReason": "string",
"iamRole": "string",
"lastStartedAt": number,
"lastUpdatedAt": number,
"loggingConfig": {
"recordAllRosTopics": boolean
},
"maxJobDurationInSeconds": number,
"name": "string",
"networkInterface": {
"networkInterfaceId": "string",
"privateIpAddress": "string",
"publicIpAddress": "string"
},
"outputLocation": {
"s3Bucket": "string",
"s3Prefix": "string"
},
"robotApplications": [
{
"application": "string",
"applicationVersion": "string",
"launchConfig": {
"command": [ "string" ],
"environmentVariables": {
"string" : "string"
},
"launchFile": "string",
"packageName": "string",
"portForwardingConfig": {
"portMappings": [
{
"applicationPort": number,
"enableOnPublicIp": boolean,
"jobPort": number
}
]
},
"streamUI": boolean
},
"tools": [
{
"command": "string",
"exitBehavior": "string",
"name": "string",
"streamOutputToCloudWatch": boolean,
"streamUI": boolean
}
],
"uploadConfigurations": [
{
"name": "string",
"path": "string",
"uploadBehavior": "string"
}
],
"useDefaultTools": boolean,
"useDefaultUploadConfigurations": boolean
}
],
"simulationApplications": [
{
"application": "string",
"applicationVersion": "string",
"launchConfig": {
"command": [ "string" ],
"environmentVariables": {
"string" : "string"
},
"launchFile": "string",
"packageName": "string",
"portForwardingConfig": {
"portMappings": [
{
"applicationPort": number,
"enableOnPublicIp": boolean,
"jobPort": number
}
]
},
"streamUI": boolean
},
"tools": [
{
"command": "string",
"exitBehavior": "string",
"name": "string",
"streamOutputToCloudWatch": boolean,
"streamUI": boolean
}
],
"uploadConfigurations": [
{
"name": "string",
"path": "string",
"uploadBehavior": "string"
}
],
"useDefaultTools": boolean,
"useDefaultUploadConfigurations": boolean,
"worldConfigs": [
{
"world": "string"
}
]
}
],
"simulationTimeMillis": number,
"status": "string",
"tags": {
"string" : "string"
},
"vpcConfig": {
"assignPublicIp": boolean,
"securityGroups": [ "string" ],
"subnets": [ "string" ],
"vpcId": "string"
}
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio envía 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 simulación.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1224.
Patrón:
arn:.* - 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_\-=]* - compute
-
Información de computación para el trabajo de simulación
Tipo: objeto ComputeResponse
- dataSources
-
Los orígenes de datos para el trabajo de simulación.
Tipo: matriz de objetos DataSource
- failureBehavior
-
El comportamiento del trabajo de simulación en caso de error.
Tipo: cadena
Valores válidos:
Fail | Continue - failureCode
-
El código de error del trabajo de simulación en caso de error:
- InternalServiceError
-
Error de servicio interno.
- RobotApplicationCrash
-
La aplicación de robot se cerró de forma anómala.
- SimulationApplicationCrash
-
La aplicación de simulación se cerró de forma anómala.
- BadPermissionsRobotApplication
-
No se ha podido descargar la agrupación de aplicaciones de robot.
- BadPermissionsSimulationApplication
-
No se ha podido descargar la agrupación de aplicaciones de simulación.
- BadPermissionsSalida S3
-
No se pueden publicar los resultados en el bucket S3 proporcionado por el cliente.
- BadPermissionsCloudwatchLogs
-
No se pueden publicar los registros en el recurso de registros proporcionado por el cliente CloudWatch .
- SubnetIpLimitExceeded
-
Se ha superado el límite de IP de subred.
- ENILimitExceeded
-
ENIse ha superado el límite.
- BadPermissionsUserCredentials
-
No se puede utilizar el rol proporcionado.
- InvalidBundleRobotApplication
-
No se puede extraer la agrupación del robot (formato no válido, error de agrupación u otro problema).
- InvalidBundleSimulationApplication
-
No se puede extraer la agrupación de simulación (formato no válido, error de agrupación u otro problema).
- RobotApplicationVersionMismatchedEtag
-
La etiqueta «for» no RobotApplication coincide con el valor durante la creación de la versión.
- SimulationApplicationVersionMismatchedEtag
-
La etiqueta etag for no SimulationApplication coincide con el valor durante la creación de la versión.
Tipo: cadena
Valores válidos:
InternalServiceError | RobotApplicationCrash | SimulationApplicationCrash | RobotApplicationHealthCheckFailure | SimulationApplicationHealthCheckFailure | BadPermissionsRobotApplication | BadPermissionsSimulationApplication | BadPermissionsS3Object | BadPermissionsS3Output | BadPermissionsCloudwatchLogs | SubnetIpLimitExceeded | ENILimitExceeded | BadPermissionsUserCredentials | InvalidBundleRobotApplication | InvalidBundleSimulationApplication | InvalidS3Resource | ThrottlingError | LimitExceeded | MismatchedEtag | RobotApplicationVersionMismatchedEtag | SimulationApplicationVersionMismatchedEtag | ResourceNotFound | RequestThrottled | BatchTimedOut | BatchCanceled | InvalidInput | WrongRegionS3Bucket | WrongRegionS3Output | WrongRegionRobotApplication | WrongRegionSimulationApplication | UploadContentMismatchError - failureReason
-
Información sobre el motivo por el que se produjo un fallo en el trabajo de simulación. Para más información sobre cómo solucionar posibles problemas, consulte Solución de problemas.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 1024 caracteres.
Patrón:
.* - iamRole
-
La IAM función que permite a la instancia de simulación llamar en su nombre a las especificadas en sus políticas asociadas. AWS APIs
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 255 caracteres.
Patrón:
arn:aws:iam::\w+:role/.* - lastStartedAt
-
El tiempo, en milisegundos, desde la fecha de inicio, cuando se inició el trabajo de simulación por última vez.
Tipo: marca temporal
- lastUpdatedAt
-
El tiempo, en milisegundos, desde la fecha de inicio, cuando se actualizó el trabajo de simulación por última vez.
Tipo: marca temporal
- loggingConfig
-
Configuración de registro.
Tipo: objeto LoggingConfig
- maxJobDurationInSeconds
-
La duración máxima del trabajo en segundos. El valor debe ser igual o inferior a 8 días (691 200 segundos).
Tipo: largo
- name
-
El nombre del trabajo de simulación.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 255 caracteres.
Patrón:
[a-zA-Z0-9_\-]* - networkInterface
-
Información de la interfaz de red para el trabajo de simulación
Tipo: objeto NetworkInterface
- outputLocation
-
Ubicación de los archivos de salida generados por el trabajo de simulación.
Tipo: objeto OutputLocation
- robotApplications
-
Una lista de aplicaciones de robot.
Tipo: matriz de objetos RobotApplicationConfig
Miembros de la matriz: número fijo de 1 artículo.
- simulationApplications
-
Una lista de aplicaciones de simulación.
Tipo: matriz de objetos SimulationApplicationConfig
Miembros de la matriz: número fijo de 1 artículo.
- simulationTimeMillis
-
La duración de la ejecución del trabajo de simulación en milisegundos.
Tipo: largo
- status
-
Estado del trabajo de simulación.
Tipo: cadena
Valores válidos:
Pending | Preparing | Running | Restarting | Completed | Failed | RunningFailed | Terminating | Terminated | Canceled -
La lista de todas las etiquetas añadidas al trabajo de simulación especificado.
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 _.\-\/+=:]* - vpcConfig
-
La VPC configuración.
Tipo: objeto VPCConfigResponse
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- InternalServerException
-
AWS RoboMaker ha sufrido un problema de 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
- 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:
