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

오류 처리

이 단원에서는 런타임 오류와 그러한 오류를 처리하는 방법을 설명합니다. 또한 Amazon Rekognition 관련 오류 메시지 및 코드를 설명합니다.

오류 구성 요소

프로그램이 요청을 보내면 Amazon Rekognition은 요청 처리를 시도합니다. 요청이 성공하면 Amazon Rekognition은 요청된 작업의 결과와 함께 HTTP 성공 상태 코드(200 OK)를 반환합니다.

요청이 실패하면 Amazon Rekognition은 오류를 반환합니다. 오류에는 세 가지 구성 요소가 있습니다.

AWS SDK는 적절한 조치를 취할 수 있도록 애플리케이션에 오류를 전파합니다. 예를 들어 Java 프로그램에서는 ResourceNotFoundException을 처리하기 위해 try-catch 로직을 작성할 수 있습니다.

AWS SDK를 사용하지 않는 경우, Amazon Rekognition에서 하위 수준 응답의 내용을 구문 분석해야 합니다. 다음은 그러한 응답의 예입니다.

HTTP/1.1 400 Bad Request
Content-Type: application/x-amz-json-1.1
Date: Sat, 25 May 2019 00:28:25 GMT
x-amzn-RequestId: 03507c9b-7e84-11e9-9ad1-854a4567eb71
Content-Length: 222
Connection: keep-alive

{"__type":"InvalidS3ObjectException","Code":"InvalidS3ObjectException","Logref":"5022229e-7e48-11e9-9ad1-854a4567eb71","Message":"Unable to get object metadata from S3. Check object key, region and/or access permissions."}

오류 메시지 및 코드

다음은 Amazon Rekognition이 반환하는 예외 목록을 HTTP 상태 코드를 기준으로 그룹화한 목록입니다. 재시도 가능?이 예라면 동일한 요청을 다시 제출할 수 있습니다. 재시도 가능?이 아니요라면 새로운 요청을 제출하기 전에 클라이언트 측에서 문제를 해결해야 합니다.

HTTP 상태 코드 400

HTTP 400 상태 코드는 요청에 문제가 있음을 나타냅니다. 몇 가지 문제의 예로는 인증 실패, 필수 파라미터 누락 또는 작업의 프로비저닝된 처리량 초과 등입니다. 요청을 다시 제출하기 전에 애플리케이션의 문제를 해결해야 합니다.

HTTP 상태 코드 5xx

HTTP 5xx 상태 코드는 AWS가 해결해야 하는 문제를 나타냅니다. 일시적 오류일 수 있습니다. 그 경우, 성공할 때까지 요청을 재시도할 수 있습니다. 그렇지 않은 경우 AWS Service Health Dashboard에서 서비스 운영 문제가 있는지 확인하십시오.

애플리케이션에서의 오류 처리

애플리케이션의 원활한 실행을 위해서는 오류를 발견하여 대응할 수 있는 로직을 추가해야 합니다. 일반적인 접근법에는 try-catch 블록 또는 if-then 문의 사용이 포함됩니다.

AWS SDK는 자체적으로 재시도 및 오류 검사를 실행합니다. AWS SDK 사용 중에 오류가 발생하면 해당 오류 코드와 설명이 문제 해결에 도움이 될 수 있습니다.

또한 응답에서 Request ID도 확인해야 합니다. 문제 진단을 위해 AWS Support와 협력해야 하는 경우 Request ID가 도움이 될 수 있습니다.

다음의 Java 코드 조각은 이미지의 객체 감지를 시도하고, 기초적인 오류 처리를 수행합니다. (이 경우, 사용자에게 요청이 실패했음을 알립니다.)

try {
    DetectLabelsResult result = rekognitionClient.detectLabels(request);
    List <Label> labels = result.getLabels();

    System.out.println("Detected labels for " + photo);
    for (Label label: labels) {
        System.out.println(label.getName() + ": " + label.getConfidence().toString());
    }
} 
catch(AmazonRekognitionException e) {
    System.err.println("Could not complete operation");
    System.err.println("Error Message:  " + e.getMessage());
    System.err.println("HTTP Status:    " + e.getStatusCode());
    System.err.println("AWS Error Code: " + e.getErrorCode());
    System.err.println("Error Type:     " + e.getErrorType());
    System.err.println("Request ID:     " + e.getRequestId());
}
catch (AmazonClientException ace) {
    System.err.println("Internal error occurred communicating with Rekognition");
    System.out.println("Error Message:  " + ace.getMessage());
}

이 코드 조각에서 try-catch 구문은 두 가지 상이한 예외를 처리합니다.