기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Neptune ML 모델 변환 API **모델 변환 작업:** + [StartMLModelTransformJob(작업)](#StartMLModelTransformJob) + [ListMLModelTransformJobs(작업)](#ListMLModelTransformJobs) + [GetMLModelTransformJob(작업)](#GetMLModelTransformJob) + [CancelMLModelTransformJob(작업)](#CancelMLModelTransformJob) **모델 변환 구조:** + [CustomModelTransformParameters(구조)](#CustomModelTransformParameters) ## StartMLModelTransformJob(작업)         이 API의 AWS CLI 이름은 `start-ml-model-transform-job`입니다. 모델 변환 작업을 새로 생성합니다. [훈련된 모델을 사용하여 새 모델 아티팩트 생성](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-model-transform.html)을 참조합니다. IAM 인증이 사용 설정된 Neptune 클러스터에서 이 작업을 호출하는 경우 요청을 생성하는 IAM 사용자 또는 역할에는 해당 클러스터에서 [neptune-db:StartMLModelTransformJob](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#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) 객체입니다. 사용자 지정 모델을 사용한 모델 변환의 구성 정보입니다. `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입니다. **오류** + [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException) + [BadRequestException](data-api-dp-errors.md#BadRequestException) + [MLResourceNotFoundException](data-api-dp-errors.md#MLResourceNotFoundException) + [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException) + [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException) + [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException) + [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException) + [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException) + [MissingParameterException](data-api-dp-errors.md#MissingParameterException) + [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException) + [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException) ## ListMLModelTransformJobs(작업)         이 API의 AWS CLI 이름은 `list-ml-model-transform-jobs`입니다. 모델 변환 작업 ID 목록을 반환합니다. [훈련된 모델을 사용하여 새 모델 아티팩트 생성](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-model-transform.html)을 참조합니다. IAM 인증이 사용 설정된 Neptune 클러스터에서 이 작업을 호출하는 경우 요청을 생성하는 IAM 사용자 또는 역할에는 해당 클러스터에서 [neptune-db:ListMLModelTransformJobs](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#listmlmodeltransformjobs) IAM 작업을 허용하는 정책이 연결되어 있어야 합니다. **요청** + **maxItems**(CLI의 경우: `--max-items`) - ListMLModelTransformJobsInputMaxItemsInteger, 유형은 1\$11,024자인 `integer`(32비트 부호 있는 정수)입니다. 반환할 항목의 최대 수입니다(1\$11024이며, 기본값은 10). + **neptuneIamRoleArn**(CLI의 경우: `--neptune-iam-role-arn`) - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다. SageMaker와 Amazon S3 리소스에 대한 Neptune의 액세스 권한을 제공하는 IAM 역할의 ARN입니다. 이는 DB 클러스터 파라미터 그룹에 나열되어 있어야 합니다. 그렇지 않으면 오류가 발생합니다. **응답**: + **ids** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다. 모델 변환 ID 목록 페이지입니다. **오류** + [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException) + [BadRequestException](data-api-dp-errors.md#BadRequestException) + [MLResourceNotFoundException](data-api-dp-errors.md#MLResourceNotFoundException) + [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException) + [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException) + [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException) + [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException) + [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException) + [MissingParameterException](data-api-dp-errors.md#MissingParameterException) + [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException) + [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException) ## GetMLModelTransformJob(작업)         이 API의 AWS CLI 이름은 `get-ml-model-transform-job`입니다. 지정된 모델 변환 작업에 대한 정보를 가져옵니다. [훈련된 모델을 사용하여 새 모델 아티팩트 생성](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-model-transform.html)을 참조합니다. IAM 인증이 사용 설정된 Neptune 클러스터에서 이 작업을 호출하는 경우 요청을 생성하는 IAM 사용자 또는 역할에는 해당 클러스터에서 [neptune-db:GetMLModelTransformJobStatus](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#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](data-api-dp-ml-data-processing.md#MlResourceDefinition) 객체입니다. 기본 데이터 처리 작업입니다. + **id** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다. 검색될 모델 변환 작업의 고유 식별자입니다. + **models** – [MlConfigDefinition](data-api-dp-ml-data-processing.md#MlConfigDefinition) 객체의 배열입니다. 사용 중인 모델의 구성 정보 목록입니다. + **remoteModelTransformJob** – [MlResourceDefinition](data-api-dp-ml-data-processing.md#MlResourceDefinition) 객체입니다. 원격 모델 변환 작업입니다. + **status** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다. 모델 변환 작업의 상태입니다. **오류** + [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException) + [BadRequestException](data-api-dp-errors.md#BadRequestException) + [MLResourceNotFoundException](data-api-dp-errors.md#MLResourceNotFoundException) + [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException) + [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException) + [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException) + [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException) + [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException) + [MissingParameterException](data-api-dp-errors.md#MissingParameterException) + [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException) + [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException) ## CancelMLModelTransformJob(작업)         이 API의 AWS CLI 이름은 `cancel-ml-model-transform-job`입니다. 지정된 모델 변환 작업을 취소합니다. [훈련된 모델을 사용하여 새 모델 아티팩트 생성](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-model-transform.html)을 참조합니다. IAM 인증이 사용 설정된 Neptune 클러스터에서 이 작업을 호출하는 경우 요청을 생성하는 IAM 사용자 또는 역할에는 해당 클러스터에서 [neptune-db:CancelMLModelTransformJob](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#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 인코딩 문자열)입니다. 취소 상태입니다. **오류** + [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException) + [BadRequestException](data-api-dp-errors.md#BadRequestException) + [MLResourceNotFoundException](data-api-dp-errors.md#MLResourceNotFoundException) + [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException) + [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException) + [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException) + [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException) + [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException) + [MissingParameterException](data-api-dp-errors.md#MissingParameterException) + [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException) + [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException) ## *모델 변환 구조:* ## CustomModelTransformParameters(구조) 사용자 지정 모델 변환 파라미터가 포함되어 있습니다. [훈련된 모델을 사용하여 새 모델 아티팩트 생성](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-model-transform.html)을 참조합니다. **Fields** + **sourceS3DirectoryPath** - *필수*는 String이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다. 모델을 구현하는 Python 모듈이 위치한 Amazon S3 위치 경로입니다. 이는 최소한 훈련 스크립트, 변환 스크립트 및 `model-hpo-configuration.json` 파일을 포함하는 유효한 기존 Amazon S3 위치를 가리켜야 합니다. + **transformEntryPointScript** - String이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다. 모델 배포에 필요한 모델 아티팩트를 계산하기 위해 하이퍼파라미터 검색에서 최적의 모델을 식별한 후 실행해야 하는 스크립트의 모듈 내 진입점 이름입니다. 명령줄 인수 없이 실행할 수 있어야 합니다. 기본값은 `transform.py`입니다.