기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon Comprehend에 사용되는 작업, 리소스 및 조건 키
Amazon Comprehend(서비스 접두사: comprehend)는 IAM 권한 정책에 사용할 수 있는 다음과 같은 서비스별 리소스, 작업 및 조건 컨텍스트 키를 제공합니다.
참조:
-
이 서비스를 구성하는 방법을 알아봅니다.
-
이 서비스에 사용 가능한 API 작업의 목록을 봅니다.
-
IAM 권한 정책을 사용하여 이 서비스와 리소스를 보호하는 방법을 알아봅니다.
Amazon Comprehend에서 정의한 작업
IAM 정책 설명의 Action 요소에서는 다음 작업을 지정할 수 있습니다. 정책을 사용하여 AWS에서 작업할 수 있는 권한을 부여합니다. 정책에서 작업을 사용하면 일반적으로 이름이 같은 API 작업 또는 CLI 명령에 대한 액세스를 허용하거나 거부합니다. 그러나 경우에 따라 하나의 작업으로 둘 이상의 작업에 대한 액세스가 제어됩니다. 또는 일부 작업을 수행하려면 다양한 작업이 필요합니다.
작업 테이블의 액세스 수준 열은 작업이 분류되는 방법(목록, 읽기, 권한 관리 또는 태그 지정)을 설명합니다. 이 분류는 정책에서 사용하는 작업이 부여하는 액세스 레벨을 이해하는 데 도움이 될 수 있습니다. 액세스 수준에 대한 자세한 내용은 정책 요약의 액세스 수준을 참조하세요.
작업 테이블의 리소스 유형 열에는 각 작업이 리소스 수준 권한을 지원하는지 여부가 표시됩니다. 리소스 열에 값이 없으면 정책 문의 Resource 요소에서 정책이 적용되는 모든 리소스("*")를 지정해야 합니다. 리소스 열에 리소스 유형이 포함되어 있으면 해당 작업 시 문에서 해당 유형의 ARN을 지정할 수 있습니다. 작업에 필요한 리소스가 하나 이상 있는 경우, 호출자에게 해당 리소스와 함께 작업을 사용할 수 있는 권한이 있어야 합니다. 필수 리소스는 테이블에서 별표(*)로 표시됩니다. IAM 정책의 Resource 요소로 리소스 액세스를 제한하는 경우, 각 필수 리소스 유형에 대해 ARN 또는 패턴을 포함해야 합니다. 일부 작업은 다수의 리소스 유형을 지원합니다. 리소스 유형이 옵션(필수 리소스로 표시되지 않은 경우)인 경우에는 선택적 리소스 유형 중 하나를 사용하도록 선택할 수 있습니다.
작업 테이블의 조건 키 열에는 정책 설명의 Condition 요소에서 지정할 수 있는 키가 포함됩니다. 서비스의 리소스와 연결된 조건 키에 대한 자세한 내용은 리소스 유형 테이블의 조건 키 열을 참조하세요.
작업 테이블의 종속 작업 열에는 작업을 성공적으로 호출하는 데 필요할 수 있는 추가 권한이 표시됩니다. 이러한 권한은 작업 자체에 대한 권한 외에 추가로 필요할 수 있습니다. 작업이 종속 작업을 지정하는 경우 해당 종속성은 테이블에 나열된 첫 번째 리소스뿐만 아니라 해당 작업에 정의된 추가 리소스에도 적용될 수 있습니다.
참고
리소스 조건 키는 리소스 유형 표에 나열되어 있습니다. 작업에 적용되는 리소스 유형에 대한 링크는 리소스 유형(*필수) 작업 표의 열에서 찾을 수 있습니다. 리소스 유형 테이블의 리소스 유형에는 조건 키 열이 포함되고 이는 작업 표의 작업에 적용되는 리소스 조건 키입니다.
다음 테이블의 열에 대한 자세한 내용은 작업 테이블을 참조하세요.
| 작업 | 설명 | 액세스 레벨 | 리소스 유형(*필수) | 조건 키 | 종속 작업 |
|---|---|---|---|---|---|
| BatchDetectDominantLanguage | 텍스트 문서 목록에 있는 언어를 하나 이상 감지할 수 있는 권한을 부여합니다. | Read | |||
| BatchDetectEntities | 지정된 텍스트 문서의 목록 내에서 명명된 엔터티("People", "Places", "Locations" 등)를 감지할 수 있는 권한을 부여합니다. | Read | |||
| BatchDetectKeyPhrases | 콘텐츠를 가장 잘 나타내는 텍스트 문서 목록의 구를 감지할 수 있는 권한을 부여합니다. | Read | |||
| BatchDetectSentiment | 문서 목록에 있는 텍스트의 감정(Positive, Negative, Neutral 또는 Mixed)을 감지할 수 있는 권한을 부여합니다. | Read | |||
| BatchDetectSyntax | 텍스트 문서의 목록에서 구문 정보(예: 음성의 일부, 토큰)를 감지할 수 있는 권한을 부여합니다. | Read | |||
| BatchDetectTargetedSentiment | 주어진 텍스트 문서 목록 내에서 특정 엔터티(예: 브랜드 또는 제품)와 관련된 감정을 감지할 수 있는 권한을 부여합니다. | Read | |||
| ClassifyDocument | 이전에 생성 및 훈련한 사용자 지정 모델과 엔드포인트를 사용하여 단일 문서를 실시간으로 분석하는 새 문서 분류 요청을 생성할 수 있는 권한을 부여합니다. | Read | |||
| ContainsPiiEntities | 주어진 문서 내에서 개인 식별 정보를 실시간으로 분류할 수 있는 권한을 부여합니다. | Read | |||
| CreateDataset | 플라이휠 내에서 새로운 데이터 세트를 만들 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateDocumentClassifier | 문서를 범주화하는 데 사용할 수 있는 새 문서 분류자를 생성할 수 있는 권한을 부여합니다. | Write | |||
| CreateEndpoint | 이전에 훈련된 사용자 지정 모델에 대한 동기식 추론을 위해 모델별 엔드포인트를 생성할 수 있는 권한을 부여합니다. | Write | |||
| CreateEntityRecognizer | 제출된 파일을 사용하여 엔터티 인식기를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateFlywheel | 모델 버전을 교육하는 데 사용할 수 있는 새 플라이휠을 만들 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteDocumentClassifier | 이전에 생성한 문서 분류자를 삭제할 수 있는 권한을 부여합니다. | Write | |||
| DeleteEndpoint | 이전에 훈련된 사용자 지정 모델에 대한 모델별 엔드포인트를 삭제할 수 있는 권한을 부여합니다. 모델을 삭제하려면 모든 엔드포인트를 삭제해야 합니다. | Write | |||
| DeleteEntityRecognizer | 제출된 엔터티 인식기를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteFlywheel | 플라이휠을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteResourcePolicy | 리소스에서 정책을 제거할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DescribeDataset | 데이터 세트와 연결된 속성을 가져올 수 있는 권한을 부여합니다. | Read | |||
| DescribeDocumentClassificationJob | 문서 분류 작업과 연결된 속성을 가져올 수 있는 권한을 부여합니다. | Read | |||
| DescribeDocumentClassifier | 문서 분류자와 연결된 속성을 가져올 수 있는 권한을 부여합니다. | Read | |||
| DescribeDominantLanguageDetectionJob | 중심 언어 감지 작업과 연결된 속성을 가져올 수 있는 권한을 부여합니다. | Read | |||
| DescribeEndpoint | 특정 엔드포인트와 연결된 속성을 가져올 수 있는 권한을 부여합니다. 이 작업을 사용하여 엔드포인트의 상태를 가져옵니다. | Read | |||
| DescribeEntitiesDetectionJob | 엔터티 감지 작업과 연결된 속성을 가져올 수 있는 권한을 부여합니다. | Read | |||
| DescribeEntityRecognizer | 상태, 훈련 데이터가 들어 있는 S3 버킷, 인식기 메타데이터터, 지표 등 엔터티 인식기 세부 정보를 제공할 수 있는 권한을 부여합니다. | Read | |||
| DescribeEventsDetectionJob | 이벤트 감지 작업과 연결된 속성을 가져올 수 있는 권한을 부여합니다. | Read | |||
| DescribeFlywheel | 플라이휠과 연결된 속성을 가져올 수 있는 권한을 부여합니다. | Read | |||
| DescribeFlywheelIteration | 플라이휠에 대한 플라이휠 반복과 연결된 속성을 가져올 수 있는 권한을 부여합니다. | Read | |||
| DescribeKeyPhrasesDetectionJob | 핵심 구문 감지 작업과 연결된 속성을 가져올 수 있는 권한을 부여합니다. | Read | |||
| DescribePiiEntitiesDetectionJob | PII 엔터티 감지 작업과 연결된 속성을 가져올 수 있는 권한을 부여합니다. | Read | |||
| DescribeResourcePolicy | 리소스에 연결된 정책을 읽을 수 있는 권한을 부여합니다. | Read | |||
| DescribeSentimentDetectionJob | 감정 감지 작업과 연결된 속성을 가져올 수 있는 권한을 부여합니다. | Read | |||
| DescribeTargetedSentimentDetectionJob | 대상 감정 감지 작업과 연결된 속성을 가져올 수 있는 권한을 부여합니다. | Read | |||
| DescribeTopicsDetectionJob | 주제 감지 작업과 연결된 속성을 가져올 수 있는 권한을 부여합니다. | Read | |||
| DetectDominantLanguage | 텍스트에 있는 언어를 하나 이상 감지할 수 있는 권한을 부여합니다. | Read | |||
| DetectEntities | 지정된 텍스트 문서 내에서 명명된 엔터티("People", "Places", "Locations" 등)를 감지할 수 있는 권한을 부여합니다. | Read | |||
| DetectKeyPhrases | 콘텐츠를 가장 잘 나타내는 텍스트의 구를 감지할 수 있는 권한을 부여합니다. | Read | |||
| DetectPiiEntities | 지정된 텍스트 문서 내에서 개인 식별 정보 엔터티(“이름”, “SSN”, “PIN” 등)를 감지할 수 있는 권한을 부여합니다. | Read | |||
| DetectSentiment | 문서에 있는 텍스트의 감정(Positive, Negative, Neutral 또는 Mixed)을 감지할 수 있는 권한을 부여합니다. | Read | |||
| DetectSyntax | 텍스트 문서에서 구문 정보(예: 음성의 일부, 토큰)를 감지할 수 있는 권한을 부여합니다. | Read | |||
| DetectTargetedSentiment | 문서에서 특정 엔터티(예: 브랜드 또는 제품)와 관련된 감정을 감지할 수 있는 권한을 부여합니다. | Read | |||
| DetectToxicContent | 지정된 텍스트 세그먼트 목록 내에서 독성 콘텐츠를 탐지할 수 있는 권한을 부여합니다. | Read | |||
| ImportModel | 훈련된 Comprehend 모델을 가져올 수 있는 권한을 부여합니다. | 쓰기 | |||
| ListDatasets | 플라이휠과 연결된 데이터 세트의 목록을 가져올 수 있는 권한을 부여합니다. | Read | |||
| ListDocumentClassificationJobs | 제출한 문서 분류 작업의 목록을 가져올 수 있는 권한을 부여합니다. | Read | |||
| ListDocumentClassifierSummaries | 생성한 문서 분류자의 요약 목록을 가져올 수 있는 권한을 부여합니다. | Read | |||
| ListDocumentClassifiers | 생성한 문서 분류자의 목록을 가져올 수 있는 권한을 부여합니다. | Read | |||
| ListDominantLanguageDetectionJobs | 제출한 중심 언어 감지 작업의 목록을 가져올 수 있는 권한을 부여합니다. | Read | |||
| ListEndpoints | 기존에 생성한 모든 엔드포인트의 목록을 가져올 수 있는 권한을 부여합니다. | Read | |||
| ListEntitiesDetectionJobs | 제출한 엔터티 감지 작업의 목록을 가져올 수 있는 권한을 부여합니다. | Read | |||
| ListEntityRecognizerSummaries | 생성한 엔터티 인식기의 요약 목록을 가져올 수 있는 권한을 부여합니다. | Read | |||
| ListEntityRecognizers | 현재 훈련 중인 인식기를 포함하여 생성한 모든 엔터티 인식기의 속성 목록을 가져올 수 있는 권한을 부여합니다. | Read | |||
| ListEventsDetectionJobs | 제출한 이벤트 감지 작업의 목록을 가져올 수 있는 권한을 부여합니다. | Read | |||
| ListFlywheelIterationHistory | 플라이휠에 대한 연결된 반복 목록을 가져올 수 있는 권한을 부여합니다. | Read | |||
| ListFlywheels | 생성한 플라이휠의 목록을 가져올 수 있는 권한을 부여합니다. | Read | |||
| ListKeyPhrasesDetectionJobs | 제출한 핵심 문구 감지 작업의 목록을 가져올 수 있는 권한을 부여합니다. | Read | |||
| ListPiiEntitiesDetectionJobs | 제출한 PII 엔터티 감지 작업의 목록을 가져올 수 있는 권한을 부여합니다. | Read | |||
| ListSentimentDetectionJobs | 제출한 감정 감지 작업의 목록을 가져올 수 있는 권한을 부여합니다. | Read | |||
| ListTagsForResource | 리소스에 대한 태그를 나열할 수 있는 권한을 부여합니다. | Read | |||
| ListTargetedSentimentDetectionJobs | 제출한 대상 감정 감지 작업의 목록을 가져올 수 있는 권한을 부여합니다. | Read | |||
| ListTopicsDetectionJobs | 제출한 주제 감지 작업의 목록을 가져올 수 있는 권한을 부여합니다. | Read | |||
| PutResourcePolicy | 리소스에 정책을 연결할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StartDocumentClassificationJob | 비동기식 문서 분류 작업을 시작할 수 있는 권한을 부여합니다. | Write | |||
| StartDominantLanguageDetectionJob | 문서 모음에 대해 비동기식 중심 언어 감지 작업을 시작할 수 있는 권한을 부여합니다. | Write | |||
| StartEntitiesDetectionJob | 문서 모음에 대해 비동기식 엔터티 감지 작업을 시작할 수 있는 권한을 부여합니다. | Write | |||
| StartEventsDetectionJob | 문서 모음에 대해 비동기식 이벤트 감지 작업을 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StartFlywheelIteration | 플라이휠에 대한 플라이휠 반복을 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StartKeyPhrasesDetectionJob | 문서 모음에 대해 비동기식 핵심 문구 감지 작업을 시작할 수 있는 권한을 부여합니다. | Write | |||
| StartPiiEntitiesDetectionJob | 문서 모음에 대해 비동기식 PII 엔터티 감지 작업을 시작할 수 있는 권한을 부여합니다. | Write | |||
| StartSentimentDetectionJob | 문서 모음에 대해 비동기식 감정 감지 작업을 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StartTargetedSentimentDetectionJob | 문서 모음에 대해 비동기식 대상 감정 감지 작업을 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StartTopicsDetectionJob | 비동기 작업을 시작하여 문서 모음에서 가장 일반적인 주제 및 각 주제와 연결된 구를 감지할 수 있는 권한을 부여합니다. | Write | |||
| StopDominantLanguageDetectionJob | 주요 언어 감지 작업을 중지할 수 있는 권한을 부여합니다. | Write | |||
| StopEntitiesDetectionJob | 엔터티 감지 작업을 중지할 수 있는 권한을 부여합니다. | Write | |||
| StopEventsDetectionJob | 이벤트 감지 작업을 중지할 수 있는 권한을 부여합니다. | Write | |||
| StopKeyPhrasesDetectionJob | 핵심 구문 감지 작업을 중지할 수 있는 권한을 부여합니다. | Write | |||
| StopPiiEntitiesDetectionJob | PII 엔터티 감지 작업을 중지할 수 있는 권한을 부여합니다. | Write | |||
| StopSentimentDetectionJob | 감정 감지 작업을 중지할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StopTargetedSentimentDetectionJob | 대상 감정 감지 작업을 중지할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StopTrainingDocumentClassifier | 이전에 생성한 문서 분류자 훈련 작업을 중지할 수 있는 권한을 부여합니다. | Write | |||
| StopTrainingEntityRecognizer | 이전에 생성한 엔터티 인식기 훈련 작업을 중지할 수 있는 권한을 부여합니다. | Write | |||
| TagResource | 지정된 키 값 페어로 리소스에 태그를 지정할 수 있는 권한을 부여합니다. | 태그 지정 | |||
| UntagResource | 지정된 키로 리소스의 태그를 해제할 수 있는 권한을 부여합니다. | 태그 지정 | |||
| UpdateEndpoint | 지정된 엔드포인트에 대한 정보를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateFlywheel | 플라이휠의 구성을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
Amazon Comprehend에서 정의한 리소스 유형
이 서비스에서 정의하는 리소스 유형은 다음과 같으며, IAM 권한 정책 설명의 Resource 요소에서 사용할 수 있습니다. 작업 테이블의 각 작업은 해당 작업으로 지정할 수 있는 리소스 유형을 식별합니다. 리소스 유형은 정책에 포함할 조건 키를 정의할 수도 있습니다. 이러한 키는 리소스 유형 테이블의 마지막 열에 표시됩니다. 다음 테이블의 열에 관한 자세한 내용은 리소스 유형 테이블을 참조하세요.
| 리소스 유형 | ARN | 조건 키 |
|---|---|---|
| targeted-sentiment-detection-job |
arn:${Partition}:comprehend:${Region}:${Account}:targeted-sentiment-detection-job/${JobId}
|
|
| document-classifier |
arn:${Partition}:comprehend:${Region}:${Account}:document-classifier/${DocumentClassifierName}
|
|
| document-classifier-endpoint |
arn:${Partition}:comprehend:${Region}:${Account}:document-classifier-endpoint/${DocumentClassifierEndpointName}
|
|
| entity-recognizer |
arn:${Partition}:comprehend:${Region}:${Account}:entity-recognizer/${EntityRecognizerName}
|
|
| entity-recognizer-endpoint |
arn:${Partition}:comprehend:${Region}:${Account}:entity-recognizer-endpoint/${EntityRecognizerEndpointName}
|
|
| dominant-language-detection-job |
arn:${Partition}:comprehend:${Region}:${Account}:dominant-language-detection-job/${JobId}
|
|
| entities-detection-job |
arn:${Partition}:comprehend:${Region}:${Account}:entities-detection-job/${JobId}
|
|
| pii-entities-detection-job |
arn:${Partition}:comprehend:${Region}:${Account}:pii-entities-detection-job/${JobId}
|
|
| events-detection-job |
arn:${Partition}:comprehend:${Region}:${Account}:events-detection-job/${JobId}
|
|
| key-phrases-detection-job |
arn:${Partition}:comprehend:${Region}:${Account}:key-phrases-detection-job/${JobId}
|
|
| sentiment-detection-job |
arn:${Partition}:comprehend:${Region}:${Account}:sentiment-detection-job/${JobId}
|
|
| topics-detection-job |
arn:${Partition}:comprehend:${Region}:${Account}:topics-detection-job/${JobId}
|
|
| document-classification-job |
arn:${Partition}:comprehend:${Region}:${Account}:document-classification-job/${JobId}
|
|
| flywheel |
arn:${Partition}:comprehend:${Region}:${Account}:flywheel/${FlywheelName}
|
|
| flywheel-dataset |
arn:${Partition}:comprehend:${Region}:${Account}:flywheel/${FlywheelName}/dataset/${DatasetName}
|
Amazon Comprehend에 사용되는 조건 키
Amazon Comprehend는 IAM 정책의 Condition 요소에 사용할 수 있는 다음과 같은 조건 키를 정의합니다. 이러한 키를 사용하여 정책 설명이 적용되는 조건을 보다 상세하게 설정할 수 있습니다. 다음 테이블의 열에 대한 자세한 내용은 조건 키 테이블을 참조하세요.
모든 서비스에서 사용할 수 있는 전역 조건 키를 보려면 AWS 전역 조건 컨텍스트 키를 참조하세요.
| 조건 키 | 설명 | 형식 |
|---|---|---|
| aws:RequestTag/${TagKey} | 리소스 생성 요청에 있는 태그 값의 존재를 요구하여 액세스를 필터링합니다. | String |
| aws:ResourceTag/${TagKey} | 리소스와 연결된 태그 값을 요구하여 액세스를 필터링합니다. | String |
| aws:TagKeys | 요청에 필수 태그의 존재를 요구하여 액세스를 필터링합니다. | ArrayOfString |
| comprehend:DataLakeKmsKey | 요청의 플라이휠 리소스와 연결된 DataLake KMS 키로 액세스를 필터링합니다. | ARN |
| comprehend:FlywheelIterationId | 플라이휠에 대한 특정 반복 ID를 기준으로 액세스를 필터링합니다. | String |
| comprehend:ModelKmsKey | 요청의 리소스와 연결된 모델 KMS 키로 액세스를 필터링합니다. | ARN |
| comprehend:OutputKmsKey | 요청의 리소스와 연결된 출력 KMS 키로 액세스를 필터링합니다. | ARN |
| comprehend:VolumeKmsKey | 요청의 리소스와 연결된 볼륨 KMS 키로 액세스를 필터링합니다. | ARN |
| comprehend:VpcSecurityGroupIds | 요청의 리소스와 연결된 모든 VPC 보안 그룹 ID 목록을 기준으로 액세스를 필터링합니다. | ArrayOfString |
| comprehend:VpcSubnets | 요청의 리소스와 연결된 모든 VPC 서브넷 목록을 기준으로 액세스를 필터링합니다. | ArrayOfString |
