기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon Rekognition에 사용되는 작업, 리소스 및 조건 키
Amazon Rekognition(서비스 접두사: rekognition)은 IAM 권한 정책에 사용할 수 있는 다음과 같은 서비스별 리소스, 작업 및 조건 컨텍스트 키를 제공합니다.
참조:
-
이 서비스를 구성하는 방법을 알아봅니다.
-
이 서비스에 사용 가능한 API 작업의 목록을 봅니다.
-
IAM 권한 정책을 사용하여 이 서비스와 리소스를 보호하는 방법을 알아봅니다.
Amazon Rekognition에서 정의한 작업
IAM 정책 설명의 Action 요소에서는 다음 작업을 지정할 수 있습니다. 정책을 사용하여 AWS에서 작업할 수 있는 권한을 부여합니다. 정책에서 작업을 사용하면 일반적으로 이름이 같은 API 작업 또는 CLI 명령에 대한 액세스를 허용하거나 거부합니다. 그러나 경우에 따라 하나의 작업으로 둘 이상의 작업에 대한 액세스가 제어됩니다. 또는 일부 작업을 수행하려면 다양한 작업이 필요합니다.
작업 테이블의 액세스 수준 열은 작업이 분류되는 방법(목록, 읽기, 권한 관리 또는 태그 지정)을 설명합니다. 이 분류는 정책에서 사용하는 작업이 부여하는 액세스 레벨을 이해하는 데 도움이 될 수 있습니다. 액세스 수준에 대한 자세한 내용은 정책 요약의 액세스 수준을 참조하세요.
작업 테이블의 리소스 유형 열에는 각 작업이 리소스 수준 권한을 지원하는지 여부가 표시됩니다. 리소스 열에 값이 없으면 정책 문의 Resource 요소에서 정책이 적용되는 모든 리소스("*")를 지정해야 합니다. 리소스 열에 리소스 유형이 포함되어 있으면 해당 작업 시 문에서 해당 유형의 ARN을 지정할 수 있습니다. 작업에 필요한 리소스가 하나 이상 있는 경우, 호출자에게 해당 리소스와 함께 작업을 사용할 수 있는 권한이 있어야 합니다. 필수 리소스는 테이블에서 별표(*)로 표시됩니다. IAM 정책의 Resource 요소로 리소스 액세스를 제한하는 경우, 각 필수 리소스 유형에 대해 ARN 또는 패턴을 포함해야 합니다. 일부 작업은 다수의 리소스 유형을 지원합니다. 리소스 유형이 옵션(필수 리소스로 표시되지 않은 경우)인 경우에는 선택적 리소스 유형 중 하나를 사용하도록 선택할 수 있습니다.
작업 테이블의 조건 키 열에는 정책 설명의 Condition 요소에서 지정할 수 있는 키가 포함됩니다. 서비스의 리소스와 연결된 조건 키에 대한 자세한 내용은 리소스 유형 테이블의 조건 키 열을 참조하세요.
작업 테이블의 종속 작업 열에는 작업을 성공적으로 호출하는 데 필요할 수 있는 추가 권한이 표시됩니다. 이러한 권한은 작업 자체에 대한 권한 외에 추가로 필요할 수 있습니다. 작업이 종속 작업을 지정하는 경우 해당 종속성은 테이블에 나열된 첫 번째 리소스뿐만 아니라 해당 작업에 정의된 추가 리소스에도 적용될 수 있습니다.
참고
리소스 조건 키는 리소스 유형 표에 나열되어 있습니다. 작업에 적용되는 리소스 유형에 대한 링크는 리소스 유형(*필수) 작업 표의 열에서 찾을 수 있습니다. 리소스 유형 테이블의 리소스 유형에는 조건 키 열이 포함되고 이는 작업 표의 작업에 적용되는 리소스 조건 키입니다.
다음 테이블의 열에 대한 자세한 내용은 작업 테이블을 참조하세요.
| 작업 | 설명 | 액세스 레벨 | 리소스 유형(*필수) | 조건 키 | 종속 작업 |
|---|---|---|---|---|---|
| AssociateFaces | 여러 개별 얼굴을 단일 사용자와 연결할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CompareFaces | 소스 입력 이미지의 얼굴과 대상 입력 이미지에서 감지된 각 얼굴을 비교할 수 있는 권한을 부여합니다. | Read | |||
| CopyProjectVersion | 기존 모델 버전을 새 모델 버전으로 복사할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateCollection | 에서 컬렉션을 생성할 수 있는 권한을 부여합니다. AWS 리전 | 쓰기 | |||
| CreateDataset | 새 Amazon Rekognition Custom Labels 데이터 세트를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateFaceLivenessSession | 얼굴 인증 세션을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateProject | Amazon Rekognition Custom Labels 프로젝트를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateProjectVersion | 모델의 새 버전을 훈련할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateStreamProcessor | Amazon Rekognition 스트림 프로세서를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateUser | 제공한 고유한 사용자 ID를 사용하여 컬렉션에 새 사용자를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteCollection | 지정된 컬렉션을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteDataset | 기존 Amazon Rekognition Custom Labels 데이터 세트를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteFaces | 컬렉션에서 얼굴을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteProject | 프로젝트를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteProjectPolicy | 프로젝트에 연결된 리소스 정책을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteProjectVersion | 모형을 삭제할 권한을 부여합니다. | 쓰기 | |||
| DeleteStreamProcessor | 지정된 스트림 프로세서를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteUser | 제공된 사용자 ID를 기준으로 컬렉션에서 사용자를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DescribeCollection | 컬렉션에 대한 세부 정보를 읽을 수 있는 권한을 부여합니다. | Read | |||
| DescribeDataset | Amazon Rekognition Custom Labels 데이터 세트를 설명할 수 있는 권한을 부여합니다. | Read | |||
| DescribeProjectVersions | Amazon Rekognition Custom Labels 프로젝트의 모델 버전을 나열할 수 있는 권한을 부여합니다. | Read | |||
| DescribeProjects | Amazon Rekognition Custom Labels 프로젝트를 나열할 수 있는 권한을 부여합니다. | Read | |||
| DescribeStreamProcessor | 지정된 스트림 프로세서에 대한 정보를 가져올 수 있는 권한을 부여합니다. | Read | |||
| DetectCustomLabels | 제공된 이미지에서 사용자 지정 레이블을 감지할 수 있는 권한을 부여합니다. | Read | |||
| DetectFaces | 입력으로 제공된 이미지 내에서 사람의 얼굴을 감지할 수 있는 권한을 부여합니다. | Read | |||
| DetectLabels | 입력으로 제공된 이미지 내에서 실제 레이블의 인스턴스를 감지할 수 있는 권한을 부여합니다. | Read | |||
| DetectModerationLabels | 입력 이미지 내에서 중재 레이블을 감지할 수 있는 권한을 부여합니다. | Read | |||
| DetectProtectiveEquipment | 입력 이미지에서 개인 보호 장비를 감지할 수 있는 권한을 부여합니다. | Read | |||
| DetectText | 입력 이미지의 텍스트를 감지하고 이를 머신 판독 가능한 텍스트로 변환할 수 있는 권한을 부여합니다. | Read | |||
| DisassociateFaces | 사용자 ID와 얼굴 ID 간의 연결을 제거할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DistributeDatasetEntries | 프로젝트에 대한 훈련 데이터 집합 및 테스트 데이터 집합 전반에서 훈련 데이터 집합의 항목을 배포할 수 있는 권한을 부여합니다. | 쓰기 | |||
| GetCelebrityInfo | 유명 인사의 이름 및 추가 정보를 읽을 수 있는 권한을 부여합니다. | Read | |||
| GetCelebrityRecognition | 비동기 유명 인사 인식 작업에 의해 저장된 비디오에서 발견된 유명 인사 인식 결과를 읽을 수 있는 권한을 부여합니다. | Read | |||
| GetContentModeration | 비동기 콘텐츠 중재 작업을 통해 저장된 비디오에서 발견된 콘텐츠 중재 분석 결과를 읽을 수 있는 권한을 부여합니다. | Read | |||
| GetFaceDetection | 비동기 얼굴 감지 작업을 통해 저장된 비디오에서 발견된 얼굴 감지 결과를 읽을 수 있는 권한을 부여합니다. | Read | |||
| GetFaceLivenessSessionResults | 얼굴 인증 세션의 결과를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetFaceSearch | 비동기 얼굴 검색 작업에 의해 저장된 비디오에서 발견된 일치하는 컬렉션 얼굴을 읽을 수 있는 권한을 부여합니다. | Read | |||
| GetLabelDetection | 비동기 레이블 감지 작업을 통해 저장된 비디오에서 발견된 레이블 감지 결과를 읽을 수 있는 권한을 부여합니다. | Read | |||
| GetMediaAnalysisJob | S3의 작업 결과에 대한 참조와 미디어 분석 작업에 대한 추가 정보를 읽을 수 있는 권한을 부여합니다. | Read | |||
| GetPersonTracking | 비동기 사람 추적 작업에 의해 저장된 비디오에서 감지된 사람 목록을 읽을 수 있는 권한을 부여합니다. | Read | |||
| GetSegmentDetection | 비동기 세그먼트 감지 작업에 의해 저장된 비디오에서 발견된 비디오 세그먼트를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetTextDetection | 비동기 텍스트 감지 작업에 의해 저장된 비디오에서 발견된 텍스트를 가져올 수 있는 권한을 부여합니다. | Read | |||
| IndexFaces | 입력 이미지에서 감지된 얼굴로 기존 컬렉션을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| ListCollections | 계정에서 컬렉션 ID를 읽을 수 있는 권한을 부여합니다. | Read | |||
| ListDatasetEntries | 기존 Amazon Rekognition Custom Labels 데이터 세트의 데이터 집합 항목을 나열할 수 있는 권한을 부여합니다. | Read | |||
| ListDatasetLabels | 데이터 집합에서 레이블을 나열할 수 있는 권한을 부여합니다. | Read | |||
| ListFaces | 지정된 컬렉션에서 얼굴에 대한 메타데이터를 읽을 수 있는 권한을 부여합니다. | Read | |||
| ListMediaAnalysisJobs | 미디어 분석 작업 목록을 읽을 수 있는 권한을 부여합니다. | Read | |||
| ListProjectPolicies | 프로젝트에 연결된 리소스 정책을 나열할 수 있는 권한을 부여합니다. | Read | |||
| ListStreamProcessors | 스트림 프로세서 목록을 가져올 권한을 부여합니다. | List | |||
| ListTagsForResource | 리소스와 연결된 태그 목록을 반환할 수 있는 권한을 부여합니다. | Read | |||
| ListUsers | UserId와 UserStatus를 나열할 수 있는 권한을 부여합니다. | Read | |||
| PutProjectPolicy | 프로젝트에 리소스 정책을 연결할 수 있는 권한을 부여합니다. | 쓰기 | |||
| RecognizeCelebrities | 입력 이미지에서 유명 인사를 감지할 수 있는 권한을 부여합니다. | Read | |||
| SearchFaces | 제공된 얼굴 ID에 대해 지정된 컬렉션을 검색할 수 있는 권한을 부여합니다. | Read | |||
| SearchFacesByImage | 입력 이미지의 가장 큰 얼굴에 대해 지정된 컬렉션을 검색할 수 있는 권한을 부여합니다. | Read | |||
| SearchUsers | 지정된 얼굴 ID 또는 사용자 ID를 사용하여 지정된 컬렉션에서 사용자 일치 결과를 검색할 수 있는 권한을 부여합니다. | Read | |||
| SearchUsersByImage | 입력 이미지에서 가장 큰 얼굴을 사용하여 특정 컬렉션에서 사용자 일치 결과를 검색할 수 있는 권한을 부여합니다. | Read | |||
| StartCelebrityRecognition | 저장된 비디오에서 유명 인사의 비동기 인식을 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StartContentModeration | 비디오에서 노골적이거나 선정적인 성인 콘텐츠의 비동기 감지를 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StartFaceDetection | 저장된 비디오에서 얼굴의 비동기 감지를 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StartFaceLivenessSession | 얼굴 인증 세션의 비디오 스트리밍을 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StartFaceSearch | 저장된 비디오에서 감지된 사람의 얼굴과 일치하는 모음의 얼굴에 대한 비동기 검색을 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StartLabelDetection | 저장된 비디오에서 레이블의 비동기 감지를 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StartMediaAnalysisJob | 미디어 분석 작업을 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StartPersonTracking | 저장된 비디오에서 사람의 비동기 추적을 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StartProjectVersion | 모델 버전 실행을 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StartSegmentDetection | 저장된 비디오에서 세그먼트의 비동기 감지를 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StartStreamProcessor | 스트림 프로세서를 실행하기 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StartTextDetection | 저장된 비디오에서 텍스트의 비동기 감지를 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StopProjectVersion | 모델 버전 실행을 중지할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StopStreamProcessor | 실행 중인 스트림 프로세서를 중지할 수 있는 권한을 부여합니다. | 쓰기 | |||
| TagResource | 리소스에 태그를 1개 이상 추가할 수 있는 권한을 부여합니다. | 태그 지정 | |||
| UntagResource | 리소스에서 태그를 1개 이상 제거할 수 있는 권한을 부여합니다. | 태그 지정 | |||
| UpdateDatasetEntries | 데이터 집합에 하나 이상의 JSON 라인(항목)을 추가하거나 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateStreamProcessor | 스트림 프로세서의 속성을 수정할 수 있는 권한을 부여합니다. | 쓰기 |
Amazon Rekognition에서 정의한 리소스 유형
이 서비스에서 정의하는 리소스 유형은 다음과 같으며, IAM 권한 정책 설명의 Resource 요소에서 사용할 수 있습니다. 작업 테이블의 각 작업은 해당 작업으로 지정할 수 있는 리소스 유형을 식별합니다. 리소스 유형은 정책에 포함할 조건 키를 정의할 수도 있습니다. 이러한 키는 리소스 유형 테이블의 마지막 열에 표시됩니다. 다음 테이블의 열에 관한 자세한 내용은 리소스 유형 테이블을 참조하세요.
| 리소스 유형 | ARN | 조건 키 |
|---|---|---|
| collection |
arn:${Partition}:rekognition:${Region}:${Account}:collection/${CollectionId}
|
|
| streamprocessor |
arn:${Partition}:rekognition:${Region}:${Account}:streamprocessor/${StreamprocessorId}
|
|
| project |
arn:${Partition}:rekognition:${Region}:${Account}:project/${ProjectName}/${CreationTimestamp}
|
|
| projectversion |
arn:${Partition}:rekognition:${Region}:${Account}:project/${ProjectName}/version/${VersionName}/${CreationTimestamp}
|
|
| dataset |
arn:${Partition}:rekognition:${Region}:${Account}:project/${ProjectName}/dataset/${DatasetType}/${CreationTimestamp}
|
Amazon Rekognition에 사용되는 조건 키
Amazon Rekognition은 IAM 정책의 Condition 요소에 사용할 수 있는 다음과 같은 조건 키를 정의합니다. 이러한 키를 사용하여 정책 설명이 적용되는 조건을 보다 상세하게 설정할 수 있습니다. 다음 테이블의 열에 대한 자세한 내용은 조건 키 테이블을 참조하세요.
모든 서비스에서 사용할 수 있는 전역 조건 키를 보려면 AWS 전역 조건 컨텍스트 키를 참조하세요.
| 조건 키 | 설명 | 형식 |
|---|---|---|
| aws:RequestTag/${TagKey} | 요청에서 전달되는 태그를 기준으로 액세스를 필터링합니다. | String |
| aws:ResourceTag/${TagKey} | 리소스와 연결된 태그를 기준으로 액세스를 필터링합니다. | String |
| aws:TagKeys | 요청에서 전달되는 태그 키를 기준으로 액세스를 필터링합니다. | ArrayOfString |
