Neptune ML 모델 변환 API - Amazon Neptune
StartMLModelTransformJobListMLModelTransformJobsGetMLModelTransformJobCancelMLModelTransformJob________________________CustomModelTransformParameters

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Neptune ML 모델 변환 API

모델 변환 작업:

모델 변환 구조:

StartMLModelTransformJob(작업)

        이 API의 AWS CLI 이름은 start-ml-model-transform-job입니다.

모델 변환 작업을 새로 생성합니다. 훈련된 모델을 사용하여 새 모델 아티팩트 생성을 참조합니다.

IAM 인증이 사용 설정된 Neptune 클러스터에서 이 작업을 호출하는 경우 요청을 생성하는 IAM 사용자 또는 역할에는 해당 클러스터에서 neptune-db:StartMLModelTransformJob IAM 작업을 허용하는 정책이 연결되어 있어야 합니다.

요청

  • baseProcessingInstanceType(CLI의 경우: --base-processing-instance-type) - String, 유형은 string(UTF-8 인코딩 문자열)입니다.

    ML 모델 훈련 준비 및 관리에 사용되는 ML 인스턴스 유형입니다. 훈련 데이터 및 모델을 처리하는 데 필요한 메모리 요구 사항을 기반으로 선택된 ML 컴퓨팅 인스턴스입니다.

  • baseProcessingInstanceVolumeSizeInGB(CLI의 경우: --base-processing-instance-volume-size-in-gb) - Integer, 유형은 integer(32비트 부호 있는 정수)입니다.

    훈련 인스턴스의 디스크 볼륨 크기(기가바이트 단위)입니다. 기본값은 0입니다. 입력 데이터와 출력 모델 모두 디스크에 저장되므로 볼륨 크기는 두 데이터 집합을 모두 저장할 수 있을 만큼 커야 합니다. 지정하지 않거나 0인 경우 Neptune ML은 데이터 처리 단계에서 생성된 권장 사항에 따라 디스크 볼륨 크기를 선택합니다.

  • customModelTransformParameters(CLI의 경우: --custom-model-transform-parameters) - CustomModelTransformParameters 객체입니다.

    사용자 지정 모델을 사용한 모델 변환의 구성 정보입니다. customModelTransformParameters 객체에는 다음 필드가 포함되며, 이 필드는 훈련 작업에서 저장된 모델 파라미터와 호환되는 값을 가져야 합니다.

  • dataProcessingJobId(CLI의 경우: --data-processing-job-id) - String, 유형은 string(UTF-8 인코딩 문자열)입니다.

    완료된 데이터 처리 작업의 작업 ID입니다. dataProcessingJobId 및 mlModelTrainingJobId를 포함하거나 trainingJobName을 지정해야 합니다.

  • id(CLI의 경우: --id) - String, 유형은 string(UTF-8 인코딩 문자열)입니다.

    새 작업의 고유 식별자입니다. 기본값은 자동 생성된 UUID입니다.

  • mlModelTrainingJobId(CLI의 경우: --ml-model-training-job-id) - String, 유형은 string(UTF-8 인코딩 문자열)입니다.

    완료된 모델 훈련 작업의 작업 ID입니다. dataProcessingJobId 및 mlModelTrainingJobId를 포함하거나 trainingJobName을 지정해야 합니다.

  • modelTransformOutputS3Location(CLI의 경우: --model-transform-output-s3-location) - 필수: String, 유형은 string(UTF-8 인코딩 문자열)입니다.

    모델 아티팩트가 저장되는 Amazon S3의 위치입니다.

  • neptuneIamRoleArn(CLI의 경우: --neptune-iam-role-arn) - String, 유형은 string(UTF-8 인코딩 문자열)입니다.

    SageMaker와 Amazon S3 리소스에 대한 Neptune의 액세스 권한을 제공하는 IAM 역할의 ARN입니다. 이는 DB 클러스터 파라미터 그룹에 나열되어 있어야 합니다. 그렇지 않으면 오류가 발생합니다.

  • s3OutputEncryptionKMSKey(CLI의 경우: --s-3-output-encryption-kms-key) - String, 유형은 string(UTF-8 인코딩 문자열)입니다.

    SageMaker가 처리 작업의 출력을 암호화하는 데 사용하는 Amazon Key Management Service(Amazon KMS) 키입니다. 기본값은 없습니다.

  • sagemakerIamRoleArn(CLI의 경우: --sagemaker-iam-role-arn) - String, 유형은 string(UTF-8 인코딩 문자열)입니다.

    SageMaker를 실행하기 위한 IAM 역할의 ARN입니다. 이는 DB 클러스터 파라미터 그룹에 나열되어 있어야 합니다. 그렇지 않으면 오류가 발생합니다.

  • securityGroupIds(CLI의 경우: --security-group-ids) - String, 유형은 string(UTF-8 인코딩 문자열)입니다.

    VPC 보안 그룹 ID입니다. 기본값은 없습니다.

  • subnets(CLI의 경우: --subnets) - String, 유형은 string(UTF-8 인코딩 문자열)입니다.

    Neptune VPC의 서브넷 ID입니다. 기본값은 없습니다.

  • trainingJobName(CLI의 경우: --training-job-name) - String, 유형은 string(UTF-8 인코딩 문자열)입니다.

    완료한 SageMaker 훈련 작업의 이름입니다. dataProcessingJobId 및 mlModelTrainingJobId를 포함하거나 trainingJobName을 지정해야 합니다.

  • volumeEncryptionKMSKey(CLI의 경우: --volume-encryption-kms-key) - String, 유형은 string(UTF-8 인코딩 문자열)입니다.

    훈련 작업을 실행하는 ML 컴퓨팅 인스턴스에 연결된 스토리지 볼륨에서 데이터를 암호화하는 데 SageMaker가 사용하는 Amazon Key Management Service(Amazon KMS) 키입니다. 기본값은 없습니다.

응답

  • arn - String, 유형은 string(UTF-8 인코딩 문자열)입니다.

    모델 변환 작업의 ARN입니다.

  • creationTimeInMillis - Long, 유형은 long(64비트 부호 있는 정수)입니다.

    모델 변환 작업 생성 시간(밀리초 단위)입니다.

  • id - String, 유형은 string(UTF-8 인코딩 문자열)입니다.

    새 모델 변환 작업의 고유 ID입니다.

오류

ListMLModelTransformJobs(작업)

        이 API의 AWS CLI 이름은 list-ml-model-transform-jobs입니다.

모델 변환 작업 ID 목록을 반환합니다. 훈련된 모델을 사용하여 새 모델 아티팩트 생성을 참조합니다.

IAM 인증이 사용 설정된 Neptune 클러스터에서 이 작업을 호출하는 경우 요청을 생성하는 IAM 사용자 또는 역할에는 해당 클러스터에서 neptune-db:ListMLModelTransformJobs IAM 작업을 허용하는 정책이 연결되어 있어야 합니다.

요청

  • maxItems(CLI의 경우: --max-items) - ListMLModelTransformJobsInputMaxItemsInteger, 유형은 1~1,024자인 integer(32비트 부호 있는 정수)입니다.

    반환할 항목의 최대 수입니다(1~1024이며, 기본값은 10).

  • neptuneIamRoleArn(CLI의 경우: --neptune-iam-role-arn) - String, 유형은 string(UTF-8 인코딩 문자열)입니다.

    SageMaker와 Amazon S3 리소스에 대한 Neptune의 액세스 권한을 제공하는 IAM 역할의 ARN입니다. 이는 DB 클러스터 파라미터 그룹에 나열되어 있어야 합니다. 그렇지 않으면 오류가 발생합니다.

응답

  • ids - String, 유형은 string(UTF-8 인코딩 문자열)입니다.

    모델 변환 ID 목록 페이지입니다.

오류

GetMLModelTransformJob(작업)

        이 API의 AWS CLI 이름은 get-ml-model-transform-job입니다.

지정된 모델 변환 작업에 대한 정보를 가져옵니다. 훈련된 모델을 사용하여 새 모델 아티팩트 생성을 참조합니다.

IAM 인증이 사용 설정된 Neptune 클러스터에서 이 작업을 호출하는 경우 요청을 생성하는 IAM 사용자 또는 역할에는 해당 클러스터에서 neptune-db:GetMLModelTransformJobStatus IAM 작업을 허용하는 정책이 연결되어 있어야 합니다.

요청

  • id(CLI의 경우: --id) - 필수: String, 유형은 string(UTF-8 인코딩 문자열)입니다.

    다시 검색할 모델 변환 작업의 고유 식별자입니다.

  • neptuneIamRoleArn(CLI의 경우: --neptune-iam-role-arn) - String, 유형은 string(UTF-8 인코딩 문자열)입니다.

    SageMaker와 Amazon S3 리소스에 대한 Neptune의 액세스 권한을 제공하는 IAM 역할의 ARN입니다. 이는 DB 클러스터 파라미터 그룹에 나열되어 있어야 합니다. 그렇지 않으면 오류가 발생합니다.

응답

  • baseProcessingJob – MlResourceDefinition 객체입니다.

    기본 데이터 처리 작업입니다.

  • id - String, 유형은 string(UTF-8 인코딩 문자열)입니다.

    검색될 모델 변환 작업의 고유 식별자입니다.

  • models – MlConfigDefinition 객체의 배열입니다.

    사용 중인 모델의 구성 정보 목록입니다.

  • remoteModelTransformJob – MlResourceDefinition 객체입니다.

    원격 모델 변환 작업입니다.

  • status - String, 유형은 string(UTF-8 인코딩 문자열)입니다.

    모델 변환 작업의 상태입니다.

오류

CancelMLModelTransformJob(작업)

        이 API의 AWS CLI 이름은 cancel-ml-model-transform-job입니다.

지정된 모델 변환 작업을 취소합니다. 훈련된 모델을 사용하여 새 모델 아티팩트 생성을 참조합니다.

IAM 인증이 사용 설정된 Neptune 클러스터에서 이 작업을 호출하는 경우 요청을 생성하는 IAM 사용자 또는 역할에는 해당 클러스터에서 neptune-db:CancelMLModelTransformJob IAM 작업을 허용하는 정책이 연결되어 있어야 합니다.

요청

  • clean(CLI의 경우: --clean) - Boolean, 유형은 boolean(부울(true 또는 false) 값)입니다.

    플래그가 TRUE로 설정되면 모든 Neptune ML S3 아티팩트는 작업이 중지될 때 삭제됩니다. 기본값은 FALSE입니다.

  • id(CLI의 경우: --id) - 필수: String, 유형은 string(UTF-8 인코딩 문자열)입니다.

    취소할 모델 변환 작업의 고유 식별자입니다.

  • neptuneIamRoleArn(CLI의 경우: --neptune-iam-role-arn) - String, 유형은 string(UTF-8 인코딩 문자열)입니다.

    SageMaker와 Amazon S3 리소스에 대한 Neptune의 액세스 권한을 제공하는 IAM 역할의 ARN입니다. 이는 DB 클러스터 파라미터 그룹에 나열되어 있어야 합니다. 그렇지 않으면 오류가 발생합니다.

응답

  • status - String, 유형은 string(UTF-8 인코딩 문자열)입니다.

    취소 상태입니다.

오류

모델 변환 구조:

CustomModelTransformParameters(구조)

사용자 지정 모델 변환 파라미터가 포함되어 있습니다. 훈련된 모델을 사용하여 새 모델 아티팩트 생성을 참조합니다.

필드

  • sourceS3DirectoryPath - 필수는 String이며, 유형은 string(UTF-8 인코딩 문자열)입니다.

    모델을 구현하는 Python 모듈이 위치한 Amazon S3 위치 경로입니다. 이는 최소한 훈련 스크립트, 변환 스크립트 및 model-hpo-configuration.json 파일을 포함하는 유효한 기존 Amazon S3 위치를 가리켜야 합니다.

  • transformEntryPointScript - String이며, 유형은 string(UTF-8 인코딩 문자열)입니다.

    모델 배포에 필요한 모델 아티팩트를 계산하기 위해 하이퍼파라미터 검색에서 최적의 모델을 식별한 후 실행해야 하는 스크립트의 모듈 내 진입점 이름입니다. 명령줄 인수 없이 실행할 수 있어야 합니다. 기본값은 transform.py입니다.