StartSimulationJobBatch - AWS RoboMaker
Sintaxis de la solicitudURIParámetros de solicitudCuerpo de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

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.

StartSimulationJobBatch

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.

Inicia un nuevo lote de trabajos de simulación. El lote se define mediante uno o más objetos SimulationJobRequest.

Sintaxis de la solicitud

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

{
   "batchPolicy": { 
      "maxConcurrency": number,
      "timeoutInSeconds": number
   },
   "clientRequestToken": "string",
   "createSimulationJobRequests": [ 
      { 
         "compute": { 
            "computeType": "string",
            "gpuUnitLimit": number,
            "simulationUnitLimit": number
         },
         "dataSources": [ 
            { 
               "destination": "string",
               "name": "string",
               "s3Bucket": "string",
               "s3Keys": [ "string" ],
               "type": "string"
            }
         ],
         "failureBehavior": "string",
         "iamRole": "string",
         "loggingConfig": { 
            "recordAllRosTopics": boolean
         },
         "maxJobDurationInSeconds": number,
         "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"
                  }
               ]
            }
         ],
         "tags": { 
            "string" : "string" 
         },
         "useDefaultApplications": boolean,
         "vpcConfig": { 
            "assignPublicIp": boolean,
            "securityGroups": [ "string" ],
            "subnets": [ "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.

batchPolicy

La política de lotes.

Tipo: objeto BatchPolicy

Obligatorio: no

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

createSimulationJobRequests

Una lista de solicitudes de trabajos de simulación para crear en el lote.

Tipo: matriz de objetos SimulationJobRequest

Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 1000 elementos.

Obligatorio: sí

tags

Un mapa que contiene las claves y los valores de las etiquetas que se asocian al lote de trabajos 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",
   "batchPolicy": { 
      "maxConcurrency": number,
      "timeoutInSeconds": number
   },
   "clientRequestToken": "string",
   "createdAt": number,
   "createdRequests": [ 
      { 
         "arn": "string",
         "computeType": "string",
         "dataSourceNames": [ "string" ],
         "lastUpdatedAt": number,
         "name": "string",
         "robotApplicationNames": [ "string" ],
         "simulationApplicationNames": [ "string" ],
         "status": "string"
      }
   ],
   "failedRequests": [ 
      { 
         "failedAt": number,
         "failureCode": "string",
         "failureReason": "string",
         "request": { 
            "compute": { 
               "computeType": "string",
               "gpuUnitLimit": number,
               "simulationUnitLimit": number
            },
            "dataSources": [ 
               { 
                  "destination": "string",
                  "name": "string",
                  "s3Bucket": "string",
                  "s3Keys": [ "string" ],
                  "type": "string"
               }
            ],
            "failureBehavior": "string",
            "iamRole": "string",
            "loggingConfig": { 
               "recordAllRosTopics": boolean
            },
            "maxJobDurationInSeconds": number,
            "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"
                     }
                  ]
               }
            ],
            "tags": { 
               "string" : "string" 
            },
            "useDefaultApplications": boolean,
            "vpcConfig": { 
               "assignPublicIp": boolean,
               "securityGroups": [ "string" ],
               "subnets": [ "string" ]
            }
         }
      }
   ],
   "failureCode": "string",
   "failureReason": "string",
   "pendingRequests": [ 
      { 
         "compute": { 
            "computeType": "string",
            "gpuUnitLimit": number,
            "simulationUnitLimit": number
         },
         "dataSources": [ 
            { 
               "destination": "string",
               "name": "string",
               "s3Bucket": "string",
               "s3Keys": [ "string" ],
               "type": "string"
            }
         ],
         "failureBehavior": "string",
         "iamRole": "string",
         "loggingConfig": { 
            "recordAllRosTopics": boolean
         },
         "maxJobDurationInSeconds": number,
         "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"
                  }
               ]
            }
         ],
         "tags": { 
            "string" : "string" 
         },
         "useDefaultApplications": boolean,
         "vpcConfig": { 
            "assignPublicIp": boolean,
            "securityGroups": [ "string" ],
            "subnets": [ "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 de recurso de Amazon (ARN) del lote.

Tipo: cadena

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

Patrón: arn:.*

batchPolicy

La política de lotes.

Tipo: objeto BatchPolicy

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_\-=]*

createdAt

El tiempo, en milisegundos, desde la fecha de inicio, cuando se creó el lote de trabajos de simulación.

Tipo: marca temporal

createdRequests

Una lista de los resúmenes de las solicitudes de trabajos de simulación creados.

Tipo: matriz de objetos SimulationJobSummary

Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 100 artículos.

failedRequests

Una lista de solicitudes de trabajos de simulación fallidas. No se ha podido crear la solicitud en un trabajo de simulación. Las solicitudes fallidas no tienen un ID de trabajo de simulación.

Tipo: matriz de objetos FailedCreateSimulationJobRequest

failureCode

El código de error si se produjo un error en el lote del trabajos de simulación.

Tipo: cadena

Valores válidos: InternalServiceError

failureReason

El motivo por el que se produjo un error en el lote de trabajos de simulación.

Tipo: cadena

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

Patrón: .*

pendingRequests

Lista de solicitudes de trabajos de simulación pendientes. Estas solicitudes no se han convertido todavía en trabajos de simulación.

Tipo: matriz de objetos SimulationJobRequest

Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 1000 elementos.

status

Estado del lote de trabajos de simulación.

Pendiente

Solicitud del lote de trabajos de simulación pendiente.

InProgress

El lote de trabajos de simulación está en curso.

Con error

Lote de trabajos de simulación fallido. No se pudieron completar una o más solicitudes de trabajo de simulación debido a un fallo interno (por ejemplo, InternalServiceError). Para obtener más información, consulte failureCode y failureReason.

Finalizado

Se ha completado el trabajo del lote de simulación. Un lote está completo cuando (1) no hay solicitudes de trabajos de simulación pendientes en el lote y ninguna de las solicitudes de trabajos de simulación fallidas se debe a InternalServiceError y (2) cuando todos los trabajos de simulación creados han alcanzado un estado terminal (por ejemplo, Completed o Failed).

Cancelado

Se ha cancelado el trabajo del lote de simulación.

Cancelando

Se está cancelando el lote de trabajos de simulación.

En finalización

Se está completando el lote de trabajos de simulación.

TimingOut

Se está agotando el tiempo de espera del lote de trabajos de simulación.

Si se está agotando el tiempo de espera de un lote y hay solicitudes pendientes que no se han podido procesar debido a un fallo interno (por ejemplo, InternalServiceError), el estado del lote será Failed. Si no se ha producido ningún fallo relacionado con una solicitud, el estado del lote será TimedOut.

TimedOut

Se agotó el tiempo de espera del lote de trabajos de simulación.

Tipo: cadena

Valores válidos: Pending | InProgress | Failed | Completed | Canceled | Canceling | Completing | TimingOut | TimedOut

tags

Un mapa que contiene las claves y los valores de las etiquetas que se asocian al lote de trabajos 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.

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

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: