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.
CreateWorldExportJob
Crear un trabajo de exportación de mundos.
Sintaxis de la solicitud
POST /createWorldExportJob HTTP/1.1
Content-type: application/json
{
"clientRequestToken": "string",
"iamRole": "string",
"outputLocation": {
"s3Bucket": "string",
"s3Prefix": "string"
},
"tags": {
"string" : "string"
},
"worlds": [ "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
- iamRole
-
El rol de IAM que el proceso de exportación de mundos utiliza para acceder al bucket de Amazon S3 y realizar la exportación.
Tipo: string
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 255 caracteres.
Patrón:
arn:aws:iam::\w+:role/.*Obligatorio: sí
- outputLocation
-
La ubicación de salida.
Tipo: objeto OutputLocation
Obligatorio: sí
-
Un mapa que contiene las claves y los valores de las etiquetas que se asocian al trabajo de exportación 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
- worlds
-
Una lista de nombres de recursos de Amazon (ARN) que corresponde a mundos para exportar.
Tipo: matriz de cadenas
Miembros de la matriz: número mínimo de 1 artículo. Número máximo de 100 artículos.
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",
"createdAt": number,
"failureCode": "string",
"iamRole": "string",
"outputLocation": {
"s3Bucket": "string",
"s3Prefix": "string"
},
"status": "string",
"tags": {
"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 de exportación 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 de exportación de mundos.
Tipo: marca temporal
- failureCode
-
Código de error del trabajo de exportación de mundos en caso de error:
- 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.
- AllWorldGenerationFailed
-
Todos los mundos en el trabajo de generación de mundos han fallado. Esto puede suceder si su
worldCountes mayor de 50 o menor de 1.
Para obtener más información sobre la solución de problemas WorldForge, consulte Simulación de solución de problemas WorldForge.
Tipo: cadena
Valores válidos:
InternalServiceError | LimitExceeded | ResourceNotFound | RequestThrottled | InvalidInput | AccessDenied - iamRole
-
El rol de IAM que el proceso de exportación de mundos utiliza para acceder al bucket de Amazon S3 y realizar la exportación.
Tipo: string
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 255 caracteres.
Patrón:
arn:aws:iam::\w+:role/.* - outputLocation
-
La ubicación de salida.
Tipo: objeto OutputLocation
- status
-
Estado del trabajo de exportación de mundos.
- Pendiente
-
La solicitud de trabajo de exportación de mundos está pendiente.
- Running
-
El trabajo de exportación de mundos está en curso.
- Finalizado
-
Trabajo de exportación de mundos completado.
- Con error
-
Trabajo de exportación de mundos fallido. Para obtener más información, consulte
failureCode. - Cancelado
-
Trabajo de exportación de mundos cancelado.
- Cancelando
-
Cancelando el trabajo de exportación de mundos.
Tipo: cadena
Valores válidos:
Pending | Running | Completed | Failed | Canceling | Canceled -
Un mapa que contiene las claves y los valores de las etiquetas que se asocian al trabajo de exportación 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 _.\-\/+=:]*
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
- 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:
