기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Neptune ML 추론 엔드포인트 API **추론 엔드포인트 작업:** + [CreateMLEndpoint(작업)](#CreateMLEndpoint) + [ListMLEndpoints(작업)](#ListMLEndpoints) + [GetMLEndpoint(작업)](#GetMLEndpoint) + [DeleteMLEndpoint(작업)](#DeleteMLEndpoint) ## CreateMLEndpoint(작업)         이 API의 AWS CLI 이름은 `create-ml-endpoint`입니다. 모델 훈련 프로세스에서 구성한 특정 모델 하나를 쿼리할 수 있는 새 Neptune ML 추론 엔드포인트를 생성합니다. [엔드포인트 명령을 사용한 추론 엔드포인트 관리](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-api-endpoints.html)를 참조합니다. IAM 인증이 사용 설정된 Neptune 클러스터에서 이 작업을 호출하는 경우 요청을 생성하는 IAM 사용자 또는 역할에는 해당 클러스터에서 [neptune-db:CreateMLEndpoint](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#createmlendpoint) IAM 작업을 허용하는 정책이 연결되어 있어야 합니다. **요청** + **id**(CLI의 경우: `--id`) - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다. 새 추론 엔드포인트의 고유 식별자입니다. 기본값은 자동 생성된 타임스탬프 이름입니다. + **instanceCount**(CLI의 경우: `--instance-count`) - Integer, 유형은 `integer`(32비트 부호 있는 정수)입니다. 예측을 위해 엔드포인트에 배포할 최소 Amazon EC2 인스턴스 수입니다. 기본값은 1입니다. + **instanceType**(CLI의 경우: `--instance-type`) - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다. 온라인 서비스에서 사용할 Neptune ML 인스턴스의 유형입니다. 기본값은 `ml.m5.xlarge`입니다. 추론 엔드포인트의 ML 인스턴스 유형을 선택하는 것은 작업 유형, 그래프 크기, 예산에 따라 달라집니다. + **mlModelTrainingJobId**(CLI의 경우: `--ml-model-training-job-id`) - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다. 추론 엔드포인트가 가리키는 모델을 생성하여 완료된 모델 훈련 작업의 작업 ID입니다. `mlModelTrainingJobId` 또는 `mlModelTransformJobId` 중 하나를 제공해야 합니다. + **mlModelTransformJobId**(CLI의 경우: `--ml-model-transform-job-id`) - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다. 완료된 모델 변환 작업의 작업 ID입니다. `mlModelTrainingJobId` 또는 `mlModelTransformJobId` 중 하나를 제공해야 합니다. + **modelName**(CLI의 경우: `--model-name`) - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다. 훈련용 모델 유형입니다. 기본적으로 Neptune ML 모델은 자동으로 데이터 처리에 사용되는 `modelType`을 기반으로 하지만 여기에서 다른 모델 유형을 지정할 수도 있습니다. 기본값은 이기종 그래프용 `rgcn` 및 지식 그래프용 `kge`입니다. 이기종 그래프의 유일한 유횻값은 `rgcn`입니다. 지식 그래프의 유횻값은`kge`, `transe`, `distmult`, `rotate`입니다. + **neptuneIamRoleArn**(CLI의 경우: `--neptune-iam-role-arn`) - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다. SageMaker와 Amazon S3 리소스에 대한 Neptune의 액세스 권한을 제공하는 IAM 역할의 ARN입니다. 이는 DB 클러스터 파라미터 그룹에 나열되어 있어야 합니다. 그렇지 않으면 오류가 발생합니다. + **update**(CLI의 경우: `--update`) - Boolean, 유형은 `boolean`(부울(true 또는 false) 값)입니다. `true`로 설정하면 업데이터 요청을 나타내는 `update`가 나타납니다. 기본값은 `false`입니다. `mlModelTrainingJobId` 또는 `mlModelTransformJobId` 중 하나를 제공해야 합니다. + **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) ## ListMLEndpoints(작업)         이 API의 AWS CLI 이름은 `list-ml-endpoints`입니다. 기존 추론 엔드포인트를 나열합니다. [엔드포인트 명령을 사용한 추론 엔드포인트 관리](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-api-endpoints.html)를 참조합니다. IAM 인증이 사용 설정된 Neptune 클러스터에서 이 작업을 호출하는 경우 요청을 생성하는 IAM 사용자 또는 역할에는 해당 클러스터에서 [neptune-db:ListMLEndpoints](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#listmlendpoints) IAM 작업을 허용하는 정책이 연결되어 있어야 합니다. **요청** + **maxItems**(CLI의 경우: `--max-items`) - ListMLEndpointsInputMaxItemsInteger, 유형은 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 목록의 한 페이지입니다. **오류** + [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) ## GetMLEndpoint(작업)         이 API의 AWS CLI 이름은 `get-ml-endpoint`입니다. 추론 엔드포인트에 대한 세부 정보를 검색합니다. [엔드포인트 명령을 사용한 추론 엔드포인트 관리](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-api-endpoints.html)를 참조합니다. IAM 인증이 사용 설정된 Neptune 클러스터에서 이 작업을 호출하는 경우 요청을 생성하는 IAM 사용자 또는 역할에는 해당 클러스터에서 [neptune-db:GetMLEndpointStatus](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#getmlendpointstatus) 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 클러스터 파라미터 그룹에 나열되어 있어야 합니다. 그렇지 않으면 오류가 발생합니다. **응답**: + **endpoint** – [MlResourceDefinition](data-api-dp-ml-data-processing.md#MlResourceDefinition) 객체입니다. 엔드포인트 정의입니다. + **endpointConfig** – [MlConfigDefinition](data-api-dp-ml-data-processing.md#MlConfigDefinition) 객체입니다. 엔드포인트 구성입니다. + **id** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다. 추론 엔드포인트의 고유 식별자입니다. + **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) ## DeleteMLEndpoint(작업)         이 API의 AWS CLI 이름은 `delete-ml-endpoint`입니다. Neptune ML 추론 엔드포인트 생성을 취소합니다. [엔드포인트 명령을 사용한 추론 엔드포인트 관리](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-api-endpoints.html)를 참조합니다. IAM 인증이 사용 설정된 Neptune 클러스터에서 이 작업을 호출하는 경우 요청을 생성하는 IAM 사용자 또는 역할에는 해당 클러스터에서 [neptune-db:DeleteMLEndpoint](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#deletemlendpoint) 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)