Neptune ML 추론 엔드포인트 API - Amazon Neptune
CreateMLEndpointListMLEndpointsGetMLEndpointDeleteMLEndpoint

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

Neptune ML 추론 엔드포인트 API

추론 엔드포인트 작업:

CreateMLEndpoint(작업)

        이 API의 AWS CLI 이름은 create-ml-endpoint입니다.

모델 훈련 프로세스에서 구성한 특정 모델 하나를 쿼리할 수 있는 새 Neptune ML 추론 엔드포인트를 생성합니다. 엔드포인트 명령을 사용한 추론 엔드포인트 관리를 참조합니다.

IAM 인증이 사용 설정된 Neptune 클러스터에서 이 작업을 호출하는 경우 요청을 생성하는 IAM 사용자 또는 역할에는 해당 클러스터에서 neptune-db: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입니다.

오류

ListMLEndpoints(작업)

        이 API의 AWS CLI 이름은 list-ml-endpoints입니다.

기존 추론 엔드포인트를 나열합니다. 엔드포인트 명령을 사용한 추론 엔드포인트 관리를 참조합니다.

IAM 인증이 사용 설정된 Neptune 클러스터에서 이 작업을 호출하는 경우 요청을 생성하는 IAM 사용자 또는 역할에는 해당 클러스터에서 neptune-db: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 목록의 한 페이지입니다.

오류

GetMLEndpoint(작업)

        이 API의 AWS CLI 이름은 get-ml-endpoint입니다.

추론 엔드포인트에 대한 세부 정보를 검색합니다. 엔드포인트 명령을 사용한 추론 엔드포인트 관리를 참조합니다.

IAM 인증이 사용 설정된 Neptune 클러스터에서 이 작업을 호출하는 경우 요청을 생성하는 IAM 사용자 또는 역할에는 해당 클러스터에서 neptune-db: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 객체입니다.

    엔드포인트 정의입니다.

  • endpointConfig – MlConfigDefinition 객체입니다.

    엔드포인트 구성입니다.

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

    추론 엔드포인트의 고유 식별자입니다.

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

    추론 엔드포인트의 상태입니다.

오류

DeleteMLEndpoint(작업)

        이 API의 AWS CLI 이름은 delete-ml-endpoint입니다.

Neptune ML 추론 엔드포인트 생성을 취소합니다. 엔드포인트 명령을 사용한 추론 엔드포인트 관리를 참조합니다.

IAM 인증이 사용 설정된 Neptune 클러스터에서 이 작업을 호출하는 경우 요청을 생성하는 IAM 사용자 또는 역할에는 해당 클러스터에서 neptune-db: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 인코딩 문자열)입니다.

    취소 상태입니다.

오류