API를 사용한 플라이 휠 구성

Amazon Comprehend API를 사용하여 플라이 휠을 생성, 업데이트 및 삭제할 수 있습니다.

플라이 휠을 생성하면 Amazon Comprehend는 각 모델 버전의 학습 데이터 및 테스트 데이터와 같이 플라이 휠에 필요한 모든 데이터를 보관하기 위해 데이터 레이크를 생성합니다.

플라이 휠을 삭제해도 Amazon Comprehend는 데이터 레이크 또는 플라이 휠과 관련된 모델을 삭제하지 않습니다.

플라이 휠이 반복 실행하거나 데이터 세트를 생성하는 중이면 플라이 휠 삭제 작업이 실패합니다.

새 플라이 휠을 생성하기 전에 플라이 휠 생성 섹션의 정보를 검토합니다.

기존 모델의 플라이 휠 생성

CreateFlyWheel 작업을 사용하여 기존 모델용 플라이 휠을 만들 수 있습니다.

aws comprehend create-flywheel  \
    --flywheel-name "myFlywheel2"  \
    --active-model-arn  "modelArn"  \
    --data-access-role-arn   arn:aws::iam::111122223333:role/testFlywheelDataAccess \
    --data-lake-s3-uri": "https://s3-bucket-endpoint"   \ 

{
  "FlywheelArn": "arn:aws::comprehend:aws-region:111122223333:flywheel/name",
  "ActiveModelArn": "modelArn"
}     

새 모델용 플라이 휠 생성

CreateFlyWheel 작업을 사용하여 새로운 사용자 지정 분류 모델용 플라이 휠을 만들 수 있습니다.

aws comprehend create-flywheel \
    --flywheel-name "myFlywheel2" \
    --data-access-role-arn  arn:aws::iam::111122223333:role/testFlywheelDataAccess \
    --model-type "DOCUMENT_CLASSIFIER" \
    --data-lake-s3-uri  "s3Uri"  \
    --task-config  file://taskConfig.json         

{
    "LanguageCode": "en",
    "DocumentClassificationConfig": {
        "Mode": "MULTI_LABEL",
        "Labels": ["optimism", "anger"]
    } 
}       

{
  "FlywheelArn": "arn:aws::comprehend:aws-region:111122223333:flywheel/name",
  "ActiveModelArn": "modelArn"
}  

플라이 휠을 설명합니다.

Amazon Comprehend DescribeFlyWheel작업을 사용하여 플라이 휠에 대한 구성 정보를 검색할 수 있습니다.

aws comprehend describe-flywheel \
    --flywheel-arn  "flywheelArn" 

API 응답 본문에는 다음 콘텐츠가 포함됩니다.

{
  "FlywheelProperties": {
      "FlywheelArn": "arn:aws::comprehend:aws-region:111122223333:flywheel/myTestFlywheel",
      "DataAccessRoleArn": "arn:aws::iam::111122223333:role/Admin",
      "TaskConfig": {
          "LanguageCode": "en",
          "DocumentClassificationConfig": {
              "Mode": "MULTI_LABEL"
          }
      },
      "DataLakeS3Uri": "s3://my-test-datalake/flywheelbasictest/myTestFlywheel/schemaVersion=1/20220801T014326Z",
      "Status": "ACTIVE",
      "ModelType":  "DOCUMENT_CLASSIFIER",
      "CreationTime": 1659318206.102,
      "LastModifiedTime": 1659318249.05
  }
}    

플라이 휠 업데이트

UpdateFlyWheel 작업을 사용하여 플라이 휠의 수정 가능한 구성 값을 업데이트 합니다.

일부 구성 필드는 하위 필드가 있는 JSON 구조입니다. 하나 이상의 하위 필드를 업데이트하려면 모든 하위 필드에 값을 제공합니다. Amazon Comprehend는 요청에서 누락된 모든 하위 필드에 대해 값을 null로 설정합니다.

UpdateFlywheel요청에 최상위 파라미터를 빠뜨리면 Amazon Comprehend는 플라이 휠에 있는 파라미터 또는 해당 하위 필드의 값을 변경하지 않습니다.

플라이 휠에서 태그를 추가하거나 제거하려면 TagResource 및 UntagResource 작업을 사용합니다.

다음 예와 같이 ActiveModelArn 파라미터를 설정하여 모델 버전을 승격할 수 있습니다.

aws comprehend update-flywheel \
    --region aws-region \
    --flywheel-arn  "flywheelArn" \
    --active-model-arn  "modelArn" \

API 응답 본문에는 다음 콘텐츠가 포함됩니다.

{
  "FlywheelArn": "arn:aws::comprehend:aws-region:111122223333:flywheel/name",
  "ActiveModelArn": "modelArn"
}    

플라이 휠 삭제

Amazon Comprehend DeleteFlyWheel 작업을 사용하여 플라이 휠을 삭제합니다.

aws comprehend delete-flywheel \
    --flywheel-arn  "flywheelArn" 

성공적인 API 응답에는 메시지 본문이 비워 있습니다

플라이 휠 목록

Amazon Comprehend ListFlyWheels 작업을 사용하여 현재 리전의 플라이 휠 목록을 검색할 수 있습니다.

aws comprehend list-flywheel \
    --region aws-region \
    --endpoint-url  "uri" 
    

API 응답 본문에는 다음 콘텐츠가 포함됩니다.

{
    "FlywheelSummaryList": [
        {
            "FlywheelArn": "arn:aws::comprehend:aws-region:111122223333:flywheel/myTestFlywheel",
            "DataLakeS3Uri": "s3://my-test-datalake/flywheelbasictest/myTestFlywheel/schemaVersion=1/20220801T014326Z",
            "Status": "ACTIVE",
            ""ModelType":  "DOCUMENT_CLASSIFIER",
            "CreationTime": 1659318206.102,
            "LastModifiedTime": 1659318249.05
        }
    ]
}