기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # StartDocumentTextDetection 문서에서 텍스트의 비동기 감지를 시작합니다. Amazon Textract Textract는 텍스트 줄과 텍스트 한 줄을 구성하는 단어를 감지할 수 있습니다. `StartDocumentTextDetection`에서는 JPEG, PNG, TIFF 및 PDF 형식의 문서에서 텍스트를 분석할 수 있습니다. 문서는 Amazon S3 버킷에 저장됩니다. 사용[DocumentLocation](API_DocumentLocation.md)을 눌러 문서의 버킷 이름과 파일 이름을 지정합니다. `StartTextDetection`작업 식별자를 반환합니다 (`JobId`) 을 사용하여 작업 결과를 얻습니다. 텍스트 감지가 완료되면 Amazon Textract Textract가 에서 지정한 Amazon Simple Notification Service (Amazon SNS) 주제에 완료 상태를 게시합니다.`NotificationChannel`. 텍스트 감지 작업의 결과를 얻으려면 먼저 Amazon SNS 주제에 게시된 상태 값이 다음과 같은지 확인하십시오.`SUCCEEDED`. 그렇다면 전화하십시오.[GetDocumentTextDetection](API_GetDocumentTextDetection.md)작업 식별자를 전달하고 (`JobId`) 초기 호출부터`StartDocumentTextDetection`. 자세한 내용은 단원을 참조하십시오.[문서 텍스트 감지](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-detecting.html). ## 요청 구문 ``` { "ClientRequestToken": "string", "DocumentLocation": { "S3Object": { "Bucket": "string", "Name": "string", "Version": "string" } }, "JobTag": "string", "KMSKeyId": "string", "NotificationChannel": { "RoleArn": "string", "SNSTopicArn": "string" }, "OutputConfig": { "S3Bucket": "string", "S3Prefix": "string" } } ``` ## 요청 파라미터 요청은 JSON 형식의 다음 데이터를 받습니다. ** [ClientRequestToken](#API_StartDocumentTextDetection_RequestSyntax) ** 시작 요청을 식별하는 데 사용되는 멱등 토큰입니다. 동일한 토큰을 여러 개 사용하여 사용하는 경우`StartDocumentTextDetection`요청, 동일`JobId`이 반환됩니다. 사용`ClientRequestToken`같은 작업이 실수로 두 번 이상 시작되지 않도록 합니다. 자세한 내용은 단원을 참조하십시오.[Amazon Textract 비동기 작업 호출](https://docs.aws.amazon.com/textract/latest/dg/api-async.html). Type: String 길이 제약 조건: 최소 길이는 1이고, 최대 길이 64. Pattern: `^[a-zA-Z0-9-_]+$` : 필수 아니요 ** [DocumentLocation](#API_StartDocumentTextDetection_RequestSyntax) ** 처리할 문서의 위치입니다. 유형: [DocumentLocation](API_DocumentLocation.md) 객체 : 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다. ** [JobTag](#API_StartDocumentTextDetection_RequestSyntax) ** 지정한 식별자로, Amazon SNS 주제에 게시된 완료 알림에 포함됩니다. 예를 들어 를 사용할 수 있습니다.`JobTag`완료 통지가 해당하는 문서 유형 (예: 세금 양식 또는 영수증) 을 식별합니다. Type: String 길이 제약 조건: 최소 길이는 1이고, 최대 길이 64. Pattern: `[a-zA-Z0-9_.\-:]+` : 필수 아니요 ** [KMSKeyId](#API_StartDocumentTextDetection_RequestSyntax) ** 추론 결과를 암호화하는 데 사용되는 KMS 키입니다. 키 ID 또는 키 별칭 형식일 수 있습니다. KMS 키가 제공되면 고객 버킷에 있는 객체의 서버 측 암호화에 KMS 키가 사용됩니다. 이 매개 변수를 활성화하지 않으면 결과는 SSE-S3 를 사용하여 서버 측에서 암호화됩니다. Type: String 길이 제약 조건: 최소 길이는 1이고, 최대 길이 2048. Pattern: `^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$` : 필수 아니요 ** [NotificationChannel](#API_StartDocumentTextDetection_RequestSyntax) ** Amazon Textract가 작업의 완료 상태를 게시하도록 하려는 Amazon SNS 주제 ARN입니다. 유형: [NotificationChannel](API_NotificationChannel.md) 객체 : 필수 아니요 ** [OutputConfig](#API_StartDocumentTextDetection_RequestSyntax) ** 출력이 고객 정의 버킷으로 이동할지 여부를 설정합니다. 기본적으로 Amazon Textract Textract는 GetDocumentTextDetection 작업을 통해 액세스할 수 있도록 결과를 내부적으로 저장합니다. 유형: [OutputConfig](API_OutputConfig.md) 객체 : 필수 아니요 ## 응답 구문 ``` { "JobId": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [JobId](#API_StartDocumentTextDetection_ResponseSyntax) ** 문서에 대한 텍스트 검색 작업의 식별자입니다. 사용`JobId`후속 호출에서 작업을 식별합니다.`GetDocumentTextDetection`. A`JobId`값은 7일 동안만 유효합니다. Type: String 길이 제약 조건: 최소 길이는 1이고, 최대 길이 64. Pattern: `^[a-zA-Z0-9-_]+$` ## 오류 ** AccessDeniedException ** 작업을 수행할 권한이 없습니다. 권한 있는 사용자 또는 IAM 역할의 Amazon 리소스 이름(ARN)을 사용하여 작업을 수행하십시오. HTTP 상태 코드: 400 ** BadDocumentException ** Amazon Textract Textract는 문서를 읽을 수 없습니다. Amazon Textract Textract의 문서 한도에 대한 자세한 내용은 단원을 참조하십시오.[Amazon Textract TEXTRACT에서의 하드 제한](limits.md). HTTP 상태 코드: 400 ** DocumentTooLargeException ** 문서가 너무 크기 때문에 처리할 수 없습니다. 동기 작업의 최대 문서 크기 10MB. 비동기 작업의 최대 문서 크기는 PDF 파일의 경우 500MB입니다. HTTP 상태 코드: 400 ** IdempotentParameterMismatchException ** A`ClientRequestToken`입력 파라미터가 작업에서 재사용되었지만 하나 이상의 다른 입력 파라미터가 이전의 작업 호출과 다릅니다. HTTP 상태 코드: 400 ** InternalServerError ** Amazon Textract Textract에 서비스 문제가 발생했습니다. 호출을 다시 시도하십시오. HTTP 상태 코드: 500 ** InvalidKMSKeyException ** KMS 키를 입력한 상태에서 암호 해독 권한이 없거나 KMS 키가 잘못 입력되었음을 나타냅니다. HTTP 상태 코드: 400 ** InvalidParameterException ** 입력 파라미터가 제약 조건을 위반했습니다. 예를 들어, 동기 작업에서는`InvalidParameterException`예외가 발생하지 않을 때`S3Object`또는`Bytes`값은 다음 위치에 제공됩니다.`Document`요청 파라미터입니다. 파라미터를 확인한 다음 API 작업을 다시 호출하십시오. HTTP 상태 코드: 400 ** InvalidS3ObjectException ** Amazon Textract Textract가 요청에서 지정된 S3 객체에 액세스할 수 없습니다.[Amazon S3 액세스 구성](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)문제 해결 정보는 를 참조하십시오.[Amazon S3 문제 해결](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html) HTTP 상태 코드: 400 ** LimitExceededException ** Amazon Textract Service 제한을 초과했습니다. 예를 들어 너무 많은 비동기 작업을 동시에 시작하면 시작 작업을 호출합니다 (`StartDocumentTextDetection`예를 들어) 을 발생시킬 경우에는 동시 실행 작업의 수가 Amazon Textract Service 제한 미만이 될 때까지 제한 Excepeption 예외 (HTTP 상태 코드: 400) 가 발생합니다. HTTP 상태 코드: 400 ** ProvisionedThroughputExceededException ** 요청의 수가 처리량 한도를 초과했습니다. 이 한도를 늘려야 하는 경우 Amazon Textract Textract에 문의하십시오. HTTP 상태 코드: 400 ** ThrottlingException ** Amazon Textract Textract가 요청을 일시적으로 처리할 수 없습니다. 호출을 다시 시도하십시오. HTTP 상태 코드: 500 ** UnsupportedDocumentException ** 입력 문서의 형식은 지원되지 않습니다. 작업 문서는 PNG, JPEG, PDF 또는 TIFF 형식일 수 있습니다. HTTP 상태 코드: 400 ## 참고 항목 이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요. + [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/StartDocumentTextDetection) + [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/StartDocumentTextDetection) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/StartDocumentTextDetection) + [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/StartDocumentTextDetection) + [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/StartDocumentTextDetection) + [AWS SDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/StartDocumentTextDetection) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/StartDocumentTextDetection) + [AWSPython용 SDK](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/StartDocumentTextDetection) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/StartDocumentTextDetection)