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á.
CreateWorldGenerationJob
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.
Cria mundos usando o modelo especificado.
Sintaxe da Solicitação
POST /createWorldGenerationJob HTTP/1.1
Content-type: application/json
{
"clientRequestToken": "string",
"tags": {
"string" : "string"
},
"template": "string",
"worldCount": {
"floorplanCount": number,
"interiorCountPerFloorplan": number
},
"worldTags": {
"string" : "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.
- clientRequestToken
-
Identificador exclusivo e que diferencia maiúsculas e minúsculas que você fornece para garantir a idempotência da solicitação.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.
Padrão:
[a-zA-Z0-9_\-=]*Obrigatório: Não
-
Um mapa com as chaves e os valores de tag anexados ao trabalho gerador de mundos.
Tipo:: mapa de string para string
Entradas do mapa: número mínimo de 0 itens. Número máximo de 50 itens.
Restrições de Tamanho de Chave: Tamanho mínimo de 1. O tamanho máximo é 128.
Padrão da chave:
[a-zA-Z0-9 _.\-\/+=:]*Restrições de comprimento do valor: Comprimento mínimo de 0. Tamanho máximo de 256.
Padrão de valor:
[a-zA-Z0-9 _.\-\/+=:]*Obrigatório: Não
- template
-
O nome do recurso da Amazon (arn) do modelo do mundo que descreve os mundos que você deseja criar.
Tipo: string
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 1.224.
Padrão:
arn:.*Exigido: Sim
- worldCount
-
Informações sobre a contagem de mundos.
Tipo: objeto WorldCount
Obrigatório: Sim
- worldTags
-
Um mapa com as chaves e os valores de tag anexados aos mundos gerados.
Tipo:: mapa de string para string
Entradas do mapa: número mínimo de 0 itens. Número máximo de 50 itens.
Restrições de Tamanho de Chave: Tamanho mínimo de 1. O tamanho máximo é 128.
Padrão da chave:
[a-zA-Z0-9 _.\-\/+=:]*Restrições de comprimento do valor: Comprimento mínimo de 0. Tamanho máximo de 256.
Padrão de valor:
[a-zA-Z0-9 _.\-\/+=:]*Obrigatório: Não
Sintaxe da Resposta
HTTP/1.1 200
Content-type: application/json
{
"arn": "string",
"clientRequestToken": "string",
"createdAt": number,
"failureCode": "string",
"status": "string",
"tags": {
"string" : "string"
},
"template": "string",
"worldCount": {
"floorplanCount": number,
"interiorCountPerFloorplan": number
},
"worldTags": {
"string" : "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.
- arn
-
O nome do recurso Amazon (ARN) do trabalho do gerador mundial.
Tipo: string
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 1.224.
Padrão:
arn:.* - clientRequestToken
-
Identificador exclusivo e que diferencia maiúsculas e minúsculas que você fornece para garantir a idempotência da solicitação.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.
Padrão:
[a-zA-Z0-9_\-=]* - createdAt
-
O tempo, em milissegundos, desde o período em que o trabalho do gerador de mundos foi criado.
Tipo: carimbo de data/hora
- failureCode
-
O código de falha do trabalho do gerador de mundos, se ele falhar:
- InternalServiceError
-
Erro de serviço interno.
- LimitExceeded
-
O recurso solicitado excede o número máximo permitido ou o número de solicitações de streaming simultâneas excede o número máximo permitido.
- ResourceNotFound
-
Não foi possível encontrar o recurso especificado.
- RequestThrottled
-
A solicitação foi acelerada.
- InvalidInput
-
Um parâmetro de entrada na solicitação não é válido.
Tipo: string
Valores Válidos:
InternalServiceError | LimitExceeded | ResourceNotFound | RequestThrottled | InvalidInput | AllWorldGenerationFailed - status
-
O status do trabalho do gerador de mundos.
- Pendente
-
A solicitação de trabalho do gerador de mundos está pendente.
- Running
-
O trabalho do gerador de mundos está em execução.
- Concluído
-
O trabalho do gerador de mundos foi concluído.
- Failed (Falha)
-
O trabalho do gerador de mundos falhou. Consulte
failureCodePara mais informações. - PartialFailed
-
Alguns mundos não foram gerados.
- Cancelado
-
O trabalho do gerador de mundos foi cancelado.
- Cancelando
-
O trabalho do gerador de mundos está sendo cancelado.
Tipo: string
Valores Válidos:
Pending | Running | Completed | Failed | PartialFailed | Canceling | Canceled -
Um mapa com as chaves e os valores de tag anexados ao trabalho gerador de mundos.
Tipo:: mapa de string para string
Entradas do mapa: número mínimo de 0 itens. Número máximo de 50 itens.
Restrições de Tamanho de Chave: Tamanho mínimo de 1. O tamanho máximo é 128.
Padrão da chave:
[a-zA-Z0-9 _.\-\/+=:]*Restrições de comprimento do valor: Comprimento mínimo de 0. Tamanho máximo de 256.
Padrão de valor:
[a-zA-Z0-9 _.\-\/+=:]* - template
-
O nome do recurso da Amazon (ARN) do modelo de mundo.
Tipo: string
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 1.224.
Padrão:
arn:.* - worldCount
-
Informações sobre a contagem de mundos.
Tipo: objeto WorldCount
- worldTags
-
Um mapa com as chaves e os valores de tag anexados aos mundos gerados.
Tipo:: mapa de string para string
Entradas do mapa: número mínimo de 0 itens. Número máximo de 50 itens.
Restrições de Tamanho de Chave: Tamanho mínimo de 1. O tamanho máximo é 128.
Padrão da chave:
[a-zA-Z0-9 _.\-\/+=:]*Restrições de comprimento do valor: Comprimento mínimo de 0. Tamanho máximo de 256.
Padrão de valor:
[a-zA-Z0-9 _.\-\/+=:]*
Erros
Para obter informações sobre os erros comuns a todas as ações, consulte Erros comuns.
- IdempotentParameterMismatchException
-
A solicitação usa o mesmo token do cliente de uma solicitação anterior, mas não idêntica. Não reutilize um token do cliente com diferentes solicitações, a menos que as solicitações sejam idênticas.
HTTPCódigo de status: 400
- 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
- LimitExceededException
-
O recurso solicitado excede o número máximo permitido ou o número de solicitações de streaming simultâneas excede o número máximo permitido.
HTTPCódigo de status: 400
- ResourceNotFoundException
-
O recurso especificado não existe.
HTTPCódigo de status: 400
- ServiceUnavailableException
-
Falha na solicitação devido a um erro temporário do servidor.
HTTPCódigo de status: 503
- 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:
