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.
CreateWorldGenerationJob
Crea mundos con la plantilla especificada.
Sintaxis de la solicitud
POST /createWorldGenerationJob HTTP/1.1
Content-type: application/json
{
"clientRequestToken": "string",
"tags": {
"string" : "string"
},
"template": "string",
"worldCount": {
"floorplanCount": number,
"interiorCountPerFloorplan": number
},
"worldTags": {
"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: no
-
Un mapa que contiene las claves y los valores de las etiquetas que se asocian al trabajo del generador de mundos.
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
- template
-
El nombre de recurso de Amazon (ARN) de la plantilla de mundo que describe los mundos que desea crear.
Tipo: string
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1224.
Patrón:
arn:.*Obligatorio: sí
- worldCount
-
Información sobre el recuento de mundos.
Tipo: objeto WorldCount
Obligatorio: sí
- worldTags
-
Un mapa que contiene las claves y los valores de las etiquetas que se asocian a los mundos creados.
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",
"clientRequestToken": "string",
"createdAt": number,
"failureCode": "string",
"status": "string",
"tags": {
"string" : "string"
},
"template": "string",
"worldCount": {
"floorplanCount": number,
"interiorCountPerFloorplan": number
},
"worldTags": {
"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 del generador de mundos.
Tipo: string
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: string
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 trabajo del generador de mundos.
Tipo: marca temporal
- failureCode
-
El código de error del trabajo de generador de mundos si falló:
- InternalServiceError
-
Error de servicio interno.
- LimitExceeded
-
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.
- ResourceNotFound
-
No se ha encontrado el recurso especificado.
- RequestThrottled
-
La solicitud se ha limitado.
- InvalidInput
-
Un parámetro de entrada de la solicitud no es válido.
Tipo: cadena
Valores válidos:
InternalServiceError | LimitExceeded | ResourceNotFound | RequestThrottled | InvalidInput | AllWorldGenerationFailed - status
-
El estado del trabajo de generador de mundos.
- Pendiente
-
La solicitud de trabajo del generador de mundos está pendiente.
- Running
-
El trabajo del generador de mundos está en ejecución.
- Finalizado
-
El trabajo del generador de mundos se ha completado.
- Con error
-
El trabajo del generador de mundos ha fallado. Para obtener más información, consulte
failureCode. - PartialFailed
-
Algunos mundos no se generaron.
- Cancelado
-
El trabajo de generador de mundos se ha cancelado.
- Cancelando
-
El trabajo del generador de mundos se ha cancelado.
Tipo: cadena
Valores válidos:
Pending | Running | Completed | Failed | PartialFailed | Canceling | Canceled -
Un mapa que contiene las claves y los valores de las etiquetas que se asocian al trabajo del generador de mundos.
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 _.\-\/+=:]* - template
-
El nombre de recurso de Amazon (ARN) de la plantilla de mundos.
Tipo: string
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1224.
Patrón:
arn:.* - worldCount
-
Información sobre el recuento de mundos.
Tipo: objeto WorldCount
- worldTags
-
Un mapa que contiene las claves y los valores de las etiquetas que se asocian a los mundos creados.
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.
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
- ServiceUnavailableException
-
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.
Código de estado HTTP: 503
- 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:
