ListSimulationJobs - AWS RoboMaker
Sintaxe da SolicitaçãoURIParâmetros de solicitaçãoCorpo da SolicitaçãoSintaxe da RespostaElementos de RespostaErrosConsulte também

Aviso de fim do suporte: em 10 de setembro de 2025, AWS interromperá o suporte para AWS RoboMaker. Depois de 10 de setembro de 2025, você não poderá mais acessar o AWS RoboMaker console ou AWS RoboMaker os recursos. Para obter mais informações sobre como fazer a transição para ajudar AWS Batch a executar simulações em contêineres, visite esta postagem no blog.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

ListSimulationJobs

Importante

Aviso de fim do suporte: em 10 de setembro de 2025, AWS interromperá o suporte para AWS RoboMaker. Depois de 10 de setembro de 2025, você não poderá mais acessar o AWS RoboMaker console ou AWS RoboMaker os recursos. Para obter mais informações sobre como fazer a transição para ajudar AWS Batch a executar simulações em contêineres, visite esta postagem no blog.

Retorna uma lista de trabalhos de simulação. Opcionalmente, você pode fornecer filtros para recuperar trabalhos de simulação específicos.

Sintaxe da Solicitação

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

{
   "filters": [ 
      { 
         "name": "string",
         "values": [ "string" ]
      }
   ],
   "maxResults": number,
   "nextToken": "string"
}

URIParâmetros de solicitação

A solicitação não usa nenhum URI parâmetro.

Corpo da Solicitação

A solicitação aceita os seguintes dados no JSON formato.

filters

Filtros opcionais para limitar os resultados.

Os nomes dos filtros status e simulationApplicationName e robotApplicationName são suportados. Ao filtrar, você deve usar o valor completo do item filtrado. Você pode usar até três filtros, mas eles devem ser para o mesmo item nomeado. Por exemplo, se você estiver procurando por itens com o status Preparing ou o status Running.

Tipo: matriz de objetos Filter

Membros da matriz: número fixo de 1 item.

Obrigatório: Não

maxResults

Quando esse parâmetro é usado, ListSimulationJobs retorna resultados maxResults somente em uma única página junto com um elemento de resposta nextToken. Os resultados restantes da solicitação inicial podem ser vistos enviando outra solicitação de ListSimulationJobs com o valor nextToken retornado. Esse valor pode ser entre 1 e 1.000. Se esse parâmetro não for usado, ListSimulationJobs retornará até 1.000 resultados e um valor nextToken, se aplicável.

Tipo: número inteiro

Obrigatório: não

nextToken

Se a solicitação paginada anterior não retornou todos os resultados restantes, o valor do parâmetro nextToken do objeto de resposta será definido como um token. Para recuperar o próximo conjunto de resultados, chame ListSimulationJobs novamente e atribua esse token ao parâmetro nextToken do objeto de solicitação. Se não houver resultados restantes, o NextToken parâmetro do objeto de resposta anterior será definido como nulo.

Tipo: string

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.

Padrão: [a-zA-Z0-9_.\-\/+=]*

Obrigatório: Não

Sintaxe da Resposta

HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "simulationJobSummaries": [ 
      { 
         "arn": "string",
         "computeType": "string",
         "dataSourceNames": [ "string" ],
         "lastUpdatedAt": number,
         "name": "string",
         "robotApplicationNames": [ "string" ],
         "simulationApplicationNames": [ "string" ],
         "status": "string"
      }
   ]
}

Elementos de Resposta

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP de 200.

Os dados a seguir são retornados em JSON formato pelo serviço.

nextToken

Se a solicitação paginada anterior não retornou todos os resultados restantes, o valor do parâmetro nextToken do objeto de resposta será definido como um token. Para recuperar o próximo conjunto de resultados, chame ListSimulationJobs novamente e atribua esse token ao parâmetro nextToken do objeto de solicitação. Se não houver resultados restantes, o NextToken parâmetro do objeto de resposta anterior será definido como nulo.

Tipo: string

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.

Padrão: [a-zA-Z0-9_.\-\/+=]*

simulationJobSummaries

Uma lista de resumos de tarefas de simulação que atenderem a todas as condições na solicitação.

Tipo: matriz de objetos SimulationJobSummary

Membros da Matriz: número mínimo de 0 itens. Número máximo de 100 itens.

Erros

Para obter informações sobre os erros comuns retornados pelas ações, consulte Erros comuns.

InternalServerException

AWS RoboMaker teve um problema de serviço. Tente fazer a chamada novamente.

HTTPCódigo de status: 500

InvalidParameterException

Um parâmetro especificado em uma solicitação é inválido, não tem suporte ou não pode ser usado. A mensagem retornada fornece uma explicação do valor do erro.

HTTPCódigo de status: 400

ThrottlingException

AWS RoboMaker está temporariamente incapaz de processar a solicitação. Tente fazer a chamada novamente.

HTTPCódigo de status: 400

Consulte também

Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte: