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.
API de procesamiento de datos Neptune ML
Acciones de procesamiento de datos:
Estructuras de uso general de ML:
StartMLDataProcessingJob (acción)
El nombre de la AWS CLI para esta API es: start-ml-data-processing-job
.
Crea un nuevo trabajo de procesamiento de datos de Neptune ML para procesar los datos de gráficos exportados desde Neptune para el entrenamiento. Consulte El comando dataprocessing
.
Al invocar esta operación en un clúster de Neptune que tiene habilitada la autenticación de IAM, el usuario o rol de IAM que realiza la solicitud debe tener una política adjunta que permita la acción de IAM neptune-db:StartMLModelDataProcessingJob en dicho clúster.
Solicitud
-
configFileName (en la CLI:
--config-file-name
): una cadena, del tipo:string
(una cadena codificada con UTF-8).Un archivo de especificación de datos que describe cómo cargar los datos de gráficos exportados para el entrenamiento. El kit de herramientas de exportación de Neptune genera automáticamente el archivo. El valor predeterminado es
training-data-configuration.json
. -
id (en la CLI:
--id
): una cadena, del tipo:string
(una cadena codificada con UTF-8).Un identificador único para el nuevo trabajo. El valor predeterminado es un UUID generado automáticamente.
-
inputDataS3Location (en la CLI:
--input-data-s3-location
): obligatorio: una cadena, del tipo:string
(una cadena codificada con UTF-8).El URI de la ubicación de Amazon S3 en la que desea que SageMaker descargue los datos necesarios para ejecutar el trabajo de procesamiento de datos.
-
modelType (en la CLI:
--model-type
): una cadena, del tipo:string
(una cadena codificada con UTF-8).Uno de los dos tipos de modelos que Neptune ML admite actualmente: modelos de subgráficos heterogéneos (
heterogeneous
) y gráficos de conocimientos (kge
). El valor predeterminado es Ninguno. Si no se especifica, Neptune ML elige automáticamente el modelo en función de los datos. -
neptuneIamRoleArn (en la CLI:
--neptune-iam-role-arn
): una cadena, del tipo:string
(una cadena codificada con UTF-8).El nombre de recurso de Amazon (ARN) de un rol de IAM que SageMaker puede asumir para realizar tareas en su nombre. Debe figurar en el grupo de parámetros del clúster de base de datos o se producirá un error.
-
previousDataProcessingJobId (en la CLI:
--previous-data-processing-job-id
): una cadena, del tipo:string
(una cadena codificada con UTF-8).El ID de un trabajo de procesamiento de datos completado que se ejecuta en una versión anterior de los datos.
-
processedDataS3Location (en la CLI:
--processed-data-s3-location
): obligatorio: una cadena, del tipo:string
(una cadena codificada con UTF-8).El URI de la ubicación de Amazon S3 en la que desea que SageMaker guarde los resultados de un trabajo de procesamiento de datos.
-
processingInstanceType (en la CLI:
--processing-instance-type
): una cadena, del tipo:string
(una cadena codificada con UTF-8).El tipo de instancia de ML que se utiliza durante el procesamiento de datos. Su memoria debe ser lo suficientemente grande como para incluir el conjunto de datos procesado. El valor predeterminado es el tipo ml.r5 de menor tamaño cuya memoria es diez veces mayor que el tamaño de los datos de gráficos exportados en el disco.
-
processingInstanceVolumeSizeInGB (en la CLI:
--processing-instance-volume-size-in-gb
): un valor entero, del tipo:integer
(un valor entero firmado de 32 bits).El tamaño del volumen del disco de la instancia de procesamiento. Tanto los datos de entrada como los datos procesados se almacenan en el disco, por lo que el tamaño del volumen debe ser lo suficientemente grande como para incluir ambos conjuntos de datos. El valor predeterminado es 0. Si no se especifica o el valor es 0, Neptune ML elige el tamaño del volumen automáticamente en función del tamaño de los datos.
-
processingTimeOutInSeconds (en la CLI:
--processing-time-out-in-seconds
): un valor entero, del tipo:integer
(un valor entero firmado de 32 bits).Tiempo de espera en segundos para el trabajo de procesamiento de datos. El valor predeterminado es 86 400 (1 día).
-
s3OutputEncryptionKMSKey (en la CLI:
--s-3-output-encryption-kms-key
): una cadena, del tipo:string
(una cadena codificada con UTF-8).La clave de Amazon Key Management Service (Amazon KMS) que SageMaker utiliza para cifrar la salida del trabajo de procesamiento. El valor predeterminado es Ninguno.
-
sagemakerIamRoleArn (en la CLI:
--sagemaker-iam-role-arn
): una cadena, del tipo:string
(una cadena codificada con UTF-8).El ARN de un rol de IAM para la ejecución de SageMaker. Debe figurar en el grupo de parámetros del clúster de base de datos o se producirá un error.
-
securityGroupIds (en la CLI:
--security-group-ids
): una cadena, del tipo:string
(una cadena codificada con UTF-8).Los ID del grupo de seguridad de la VPC. El valor predeterminado es Ninguno.
-
subnets (en la CLI:
--subnets
): una cadena, del tipo:string
(una cadena codificada con UTF-8).Los ID de las subredes en la VPC de Neptune. El valor predeterminado es Ninguno.
-
volumeEncryptionKMSKey (en la CLI:
--volume-encryption-kms-key
): una cadena, del tipo:string
(una cadena codificada con UTF-8).La clave de Amazon Key Management Service (Amazon KMS) que SageMaker utiliza para cifrar los datos del volumen de almacenamiento asociado con las instancias de computación de ML que ejecutan el trabajo de entrenamiento. El valor predeterminado es Ninguno.
Respuesta
-
arn: una cadena, del tipo:
string
(una cadena codificada con UTF-8).El ARN del trabajo de procesamiento de datos.
-
creationTimeInMillis: un valor Long, del tipo:
long
(valor entero firmado de 64 bits).El tiempo que se tardó en crear el nuevo trabajo de procesamiento, en milisegundos.
-
id: una cadena, del tipo:
string
(una cadena codificada con UTF-8).El ID único del nuevo trabajo de procesamiento de datos.
ListMLDataProcessingJobs (acción)
El nombre de la AWS CLI para esta API es: list-ml-data-processing-jobs
.
Devuelve una lista de los trabajos de procesamiento de datos de Neptune ML. Consulte Enumeración de trabajos de procesamiento de datos activos mediante el comando dataprocessing de Neptune ML.
Al invocar esta operación en un clúster de Neptune que tiene habilitada la autenticación de IAM, el usuario o rol de IAM que realiza la solicitud debe tener una política adjunta que permita la acción de IAM neptune-db:ListMLDataProcessingJobs en dicho clúster.
Solicitud
-
maxItems (en la CLI:
--max-items
): un ListMLDataProcessingJobsInputMaxItemsInteger, del tipo:integer
(un valor entero firmado de 32 bits), no inferior a 1 ni superior a 1024 ?st?s.El número máximo de elementos que se recuperan (de 1 a 1024; el valor predeterminado es 10).
-
neptuneIamRoleArn (en la CLI:
--neptune-iam-role-arn
): una cadena, del tipo:string
(una cadena codificada con UTF-8).El ARN de un rol de IAM que proporciona a Neptune acceso a los recursos de SageMaker y Amazon S3. Debe figurar en el grupo de parámetros del clúster de base de datos o se producirá un error.
Respuesta
-
ids: una cadena, del tipo:
string
(una cadena codificada con UTF-8).Una página con los identificadores de los trabajos de procesamiento de datos.
GetMLDataProcessingJob (acción)
El nombre de la AWS CLI para esta API es: get-ml-data-processing-job
.
Recupera información sobre un trabajo de procesamiento de datos específico. Consulte El comando dataprocessing
.
Al invocar esta operación en un clúster de Neptune que tiene habilitada la autenticación de IAM, el usuario o rol de IAM que realiza la solicitud debe tener una política adjunta que permita la acción de IAM neptune-db:neptune-db:GetMLDataProcessingJobStatus en dicho clúster.
Solicitud
-
id (en la CLI:
--id
): obligatorio: una cadena, del tipo:string
(una cadena codificada con UTF-8).El identificador único del trabajo de procesamiento de datos que se va a recuperar.
-
neptuneIamRoleArn (en la CLI:
--neptune-iam-role-arn
): una cadena, del tipo:string
(una cadena codificada con UTF-8).El ARN de un rol de IAM que proporciona a Neptune acceso a los recursos de SageMaker y Amazon S3. Debe figurar en el grupo de parámetros del clúster de base de datos o se producirá un error.
Respuesta
-
id: una cadena, del tipo:
string
(una cadena codificada con UTF-8).El identificador único de este trabajo de procesamiento de datos.
-
processingJob: objeto MlResourceDefinition.
Definición del trabajo de procesamiento de datos.
-
status: una cadena, del tipo:
string
(una cadena codificada con UTF-8).Estado del trabajo de procesamiento de datos.
CancelMLDataProcessingJob (acción)
El nombre de la AWS CLI para esta API es: cancel-ml-data-processing-job
.
Cancela un trabajo de procesamiento de datos de Neptune ML. Consulte El comando dataprocessing
.
Al invocar esta operación en un clúster de Neptune que tiene habilitada la autenticación de IAM, el usuario o rol de IAM que realiza la solicitud debe tener una política adjunta que permita la acción de IAM neptune-db:CancelMLDataProcessingJob en dicho clúster.
Solicitud
-
clean (en la CLI:
--clean
): un booleano, del tipo:boolean
(un valor booleano [true o false]).Si se establece en
TRUE
, este indicador especifica que todos los artefactos de S3 de Neptune ML deben eliminarse cuando se detenga el trabajo. El valor predeterminado esFALSE
. -
id (en la CLI:
--id
): obligatorio: una cadena, del tipo:string
(una cadena codificada con UTF-8).El identificador único del trabajo de procesamiento de datos.
-
neptuneIamRoleArn (en la CLI:
--neptune-iam-role-arn
): una cadena, del tipo:string
(una cadena codificada con UTF-8).El ARN de un rol de IAM que proporciona a Neptune acceso a los recursos de SageMaker y Amazon S3. Debe figurar en el grupo de parámetros del clúster de base de datos o se producirá un error.
Respuesta
-
status: una cadena, del tipo:
string
(una cadena codificada con UTF-8).El estado de la solicitud de cancelación.
Estructuras de uso general de ML:
MlResourceDefinition (estructura)
Define un recurso de Neptune ML.
Campos
-
arn: se trata de una cadena, del tipo:
string
(una cadena codificada con UTF-8).El ARN del recurso.
-
cloudwatchLogUrl: se trata de una cadena, del tipo:
string
(una cadena codificada con UTF-8).La URL del registro de CloudWatch del recurso.
-
failureReason: se trata de una cadena, del tipo:
string
(una cadena codificada con UTF-8).El motivo del error, en caso de que se produzca un error.
-
name: se trata de una cadena, del tipo:
string
(una cadena codificada con UTF-8).El nombre del recurso.
-
outputLocation: se trata de una cadena, del tipo:
string
(una cadena codificada con UTF-8).La ubicación de salida.
-
status: se trata de una cadena, del tipo:
string
(una cadena codificada con UTF-8).El estado del recurso.
MlConfigDefinition (estructura)
Incluye una configuración de Neptune ML.
Campos
-
arn: se trata de una cadena, del tipo:
string
(una cadena codificada con UTF-8).El ARN de la configuración.
-
name: se trata de una cadena, del tipo:
string
(una cadena codificada con UTF-8).El nombre de la configuración.