Envía un trabajo de Ray.
Pruébelo ahora
Test
Autorización de RAM
|
Action |
Nivel de acceso |
Tipo de recurso |
Clave de condición |
Acción dependiente |
|
emr-serverless-spark:SubmitRayJob |
create |
*Todos los recursos.
|
Ninguna | Ninguna |
Sintaxis de la solicitud
POST /api/v1/workspaces/{workspaceId}/rayJob HTTP/1.1
Parámetros de ruta
|
Parámetro |
Tipo |
Obligatorio |
Descripción |
Ejemplo |
| workspaceId |
string |
No |
El ID del espacio de trabajo. |
w-d2d82aa09155 |
Parámetros de la solicitud
|
Parámetro |
Tipo |
Obligatorio |
Descripción |
Ejemplo |
| body |
object |
No |
La estructura de la solicitud. |
|
| entrypoint |
string |
No |
El comando del punto de entrada. |
python -c "print('hello ray job')" |
| name |
string |
No |
El nombre del trabajo. |
my-job |
| displayReleaseVersion |
string |
No |
El número de versión del motor de base de datos Ray DPI. |
err-1.2.0 (Ray 2.55.1, Python 3.12) |
| tags |
array<object> |
No |
Las etiquetas. |
|
|
object |
No |
|||
| key |
string |
No |
La clave. |
jobname |
| value |
string |
No |
El valor. |
test |
| networkServiceName |
string |
No |
El nombre de la conectividad de red. |
vpc |
| runtimeEnvJson |
string |
No |
La cadena JSON del entorno de ejecución de Ray. |
{"pip":["requests==2.26.0","pendulum==2.1.2"],"env_vars":{"KEY":"VALUE"}} |
| workingDir |
string |
No |
La URL del directorio de trabajo para el código del trabajo. |
oss://mybucket/rayjob.zip |
| metadataJson |
string |
No |
La cadena JSON de metadatos del trabajo. |
{"resourceName": "test"} |
| submissionMode |
string |
No |
El modo de envío del trabajo. |
HTTPMode |
| entrypointNumCpus |
string |
No |
El número de CPU solicitadas por el trabajo de punto de entrada. |
1 |
| entrypointNumGpus |
string |
No |
El número de GPU solicitadas por el trabajo de punto de entrada. |
0 |
| entrypointMemory |
string |
No |
El tamaño de memoria solicitada por el trabajo de punto de entrada. |
4Gi |
| entrypointResources |
string |
No |
La cadena JSON de solicitud de recursos personalizados para el trabajo de punto de entrada. |
{"fpu": 1} |
| shutdownAfterJobFinishes |
boolean |
No |
Especifica si se debe destruir automáticamente el clúster temporal después de que finalice el trabajo. Valor predeterminado: true. |
true |
| ttlSecondsAfterFinished |
integer |
No |
El tiempo de espera en segundos antes de que se destruya el clúster. Este parámetro solo surte efecto cuando shutdownAfterJobFinishes se establece en true. |
60 |
| activeDeadlineSeconds |
integer |
No |
El periodo de tiempo de espera del trabajo, que incluye el tiempo de creación del clúster y de ejecución del trabajo. El trabajo se cancela si supera este periodo. |
3600 |
| volumeIds |
array |
No |
La lista de ID de los volúmenes montados. |
|
|
string |
No |
El ID del archivo administrado. |
vol-12345678 |
|
| headSpec |
object |
No |
Los parámetros del nodo principal del clúster de Ray. |
|
| queueName |
string |
No |
El nombre de la cola. |
root_queue |
| cpu |
string |
No |
El número de núcleos de CPU. |
2 |
| memory |
string |
No |
El tamaño de memoria, en Gi. |
8Gi |
| enableAutoScaling |
boolean |
No |
Especifica si se debe habilitar el escalado automático para los nodos worker. |
true |
| idleTimeoutSeconds |
integer |
No |
El tiempo de inactividad de los nodos worker después de habilitar el escalado automático. |
60 |
| gpuSpec |
string |
No |
El tipo de instancia de GPU. |
ecs.gn6i-c4g1.xlarge |
| displayReleaseVersion |
string |
No |
La versión del motor de base de datos Ray DPI. |
err-1.3.0 (Ray 2.55.1, Python 3.12) |
| workerSpec |
array<object> |
No |
Los parámetros del nodo de trabajo del clúster de Ray. |
|
|
object |
No |
La estructura del nodo de trabajo. |
||
| groupName |
string |
No |
El nombre del grupo de trabajadores. |
WorkerGroup1 |
| workerType |
string |
No |
El tipo de trabajador. Valores válidos:
|
CPU |
| replica |
integer |
No |
El número de trabajadores. |
2 |
| queueName |
string |
No |
El nombre de la cola. |
root_queue |
| cpu |
string |
No |
El número de núcleos de CPU. |
4 |
| memory |
string |
No |
El tamaño de memoria, en Gi. |
16Gi |
| minReplica |
integer |
No |
El número mínimo de trabajadores cuando el escalado automático está habilitado. |
1 |
| maxReplica |
integer |
No |
El número máximo de trabajadores cuando el escalado automático está habilitado. |
10 |
| gpuSpec |
string |
No |
El tipo de instancia de GPU. |
ecs.gn6i-c4g1.xlarge |
| displayReleaseVersion |
string |
No |
La versión del motor de DPI. |
ray-1.2.0 (Ray 2.55.1, Python 3.12) |
| extraParam |
string |
No |
La cadena JSON para parámetros adicionales. |
{"userDefinedFiles": "oss://mybucket/artifact/config.json,oss://mybucket/artifact/config2.json", "userRequirementsFile": "oss://mybucket/requirements.txt"} |
| clusterId |
string |
No |
El ID del clúster de Ray existente. |
ray-xxxxxxxxx |
Elementos de la respuesta
|
Elemento |
Tipo |
Descripción |
Ejemplo |
|
object |
El esquema de la respuesta. |
||
| requestId |
string |
El ID de la solicitud. |
DD6B1B2A-5837-5237-ABE4-FF0C8944 |
| submissionId |
string |
El ID del trabajo de Ray. |
rj-k7nm8ahl5te4tg91 |
Ejemplos
Respuesta exitosa
JSON Formato
{
"requestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944",
"submissionId": "rj-k7nm8ahl5te4tg91"
}
Códigos de error
Consulte Códigos de error para ver la lista completa.
Notas de la versión
Consulte Notas de la versión para ver la lista completa.