기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
AWS CodeBuild에 사용되는 작업, 리소스 및 조건 키
AWS CodeBuild (서비스 접두사:codebuild) 는 IAM 권한 정책에 사용할 수 있는 다음과 같은 서비스별 리소스, 작업 및 조건 컨텍스트 키를 제공합니다.
참조:
-
이 서비스의 구성 방법을 알아봅니다.
-
이 서비스에 사용 가능한 API 작업 목록을 봅니다.
-
IAM 권한 정책을 사용하여 이 서비스와 리소스를 보호하는 방법을 알아봅니다.
AWS CodeBuild에서 정의한 작업
IAM 정책 설명의 Action 요소에서는 다음 작업을 지정할 수 있습니다. 정책을 사용하여 AWS에서 작업할 수 있는 권한을 부여합니다. 정책에서 작업을 사용하면 일반적으로 이름이 같은 API 작업 또는 CLI 명령에 대한 액세스를 허용하거나 거부합니다. 그러나 경우에 따라 하나의 작업으로 둘 이상의 작업에 대한 액세스가 제어됩니다. 또는 일부 작업을 수행하려면 다양한 작업이 필요합니다.
작업 테이블의 리소스 유형 열에는 각 작업이 리소스 수준 권한을 지원하는지 여부가 표시됩니다. 리소스 열에 값이 없으면 정책 문의 Resource 요소에서 정책이 적용되는 모든 리소스("*")를 지정해야 합니다. 리소스 열에 리소스 유형이 포함되어 있으면 해당 작업 시 문에서 해당 유형의 ARN을 지정할 수 있습니다. 작업에 필요한 리소스가 하나 이상 있는 경우, 호출자에게 해당 리소스와 함께 작업을 사용할 수 있는 권한이 있어야 합니다. 필수 리소스는 테이블에서 별표(*)로 표시됩니다. IAM 정책의 Resource 요소로 리소스 액세스를 제한하는 경우, 각 필수 리소스 유형에 대해 ARN 또는 패턴을 포함해야 합니다. 일부 작업은 다수의 리소스 유형을 지원합니다. 리소스 유형이 옵션(필수 리소스로 표시되지 않은 경우)인 경우에는 선택적 리소스 유형 중 하나를 사용하도록 선택할 수 있습니다.
작업 테이블의 조건 키 열에는 정책 설명의 Condition 요소에서 지정할 수 있는 키가 포함됩니다. 서비스의 리소스와 연결된 조건 키에 대한 자세한 내용은 리소스 유형 테이블의 조건 키 열을 참조하세요.
참고
리소스 조건 키는 리소스 유형 표에 나열되어 있습니다. 작업에 적용되는 리소스 유형에 대한 링크는 리소스 유형(*필수) 작업 표의 열에서 찾을 수 있습니다. 리소스 유형 테이블의 리소스 유형에는 조건 키 열이 포함되고 이는 작업 표의 작업에 적용되는 리소스 조건 키입니다.
다음 테이블의 열에 대한 자세한 내용은 작업 테이블을 참조하세요.
| 작업 | 설명 | 액세스 레벨 | 리소스 유형(*필수) | 조건 키 | 종속 작업 |
|---|---|---|---|---|---|
| BatchDeleteBuilds | 하나 이상의 빌드를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| BatchGetBuildBatches | 하나 이상의 빌드 배치에 대한 정보를 가져올 권한을 부여합니다. | 읽기 | |||
| BatchGetBuilds | 하나 이상의 빌드에 대한 정보를 가져올 권한을 부여합니다. | 읽기 | |||
| BatchGetFleets | 입력 파라미터로 지정된 플릿 오브젝트의 배열을 반환할 권한을 부여합니다. | 읽기 | |||
| BatchGetProjects | 하나 이상의 빌드 프로젝트에 대한 정보를 가져올 권한을 부여합니다. | 읽기 | |||
| BatchGetReportGroups | 입력 reportGroupArns 파라미터로 지정된 ReportGroup 객체 배열을 반환할 권한을 부여합니다. | 읽기 | |||
| BatchGetReports | 입력 reportArns 파라미터에서 지정한 보고서 객체의 배열을 반환할 수 있는 권한을 부여합니다. | 읽기 | |||
| BatchPutCodeCoverages [권한만 해당] | 보고서에 대한 정보를 추가하거나 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| BatchPutTestCases [권한만 해당] | 보고서에 대한 정보를 추가하거나 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateFleet | 컴퓨팅 플릿을 생성할 권한을 부여합니다. | 쓰기 | |||
| CreateProject | 빌드 프로젝트를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateReport [권한만 해당] | 보고서를 생성할 수 있는 권한을 부여합니다. 보고서 그룹에 대한 buildspec 파일에 지정된 테스트가 프로젝트를 빌드하는 동안 실행될 때 보고서가 생성됩니다. | 쓰기 | |||
| CreateReportGroup | 보고 그룹을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateWebhook | 웹후크를 생성할 수 있는 권한을 부여합니다. GitHub 또는 Bitbucket 리포지토리에 소스 코드가 저장되어 있는 기존 AWS CodeBuild 빌드 프로젝트의 경우, 코드 변경 사항이 리포지토리에 푸시될 때마다 소스 코드 재빌드를 시작할 수 있습니다. AWS CodeBuild | 쓰기 | |||
| DeleteBuildBatch | 빌드 배치를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteFleet | 컴퓨팅 플릿을 삭제할 권한을 부여합니다. | 쓰기 | |||
| DeleteOAuthToken [권한만 해당] | 연결된 서드 파티 OAuth 공급자의 OAuth 토큰을 삭제할 수 있는 권한을 부여합니다. AWS CodeBuild 콘솔에서만 사용됩니다. | 쓰기 | |||
| DeleteProject | 빌드 프로젝트를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteReport | 보고서를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteReportGroup | 보고서 그룹을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteResourcePolicy | 연결된 프로젝트 또는 보고서 그룹에 대한 리소스 정책을 삭제할 권한을 부여합니다. | 권한 관리 | |||
| DeleteSourceCredentials | GitHub 엔터프라이즈 또는 Bitbucket 소스 자격 GitHub 증명 세트를 삭제할 권한을 부여합니다. | 쓰기 | |||
| DeleteWebhook | 웹후크를 삭제할 수 있는 권한을 부여합니다. 소스 코드가 Bitbucket GitHub 저장소나 Bitbucket 저장소에 저장되어 있는 기존 AWS CodeBuild 빌드 프로젝트의 경우, 코드 변경 사항이 저장소에 푸시될 때마다 소스 코드 재작성이 AWS CodeBuild 중지됩니다. | 쓰기 | |||
| DescribeCodeCoverages | 객체 배열을 반환할 권한을 부여합니다. CodeCoverage | 읽기 | |||
| DescribeTestCases | TestCase 개체 배열을 반환할 권한을 부여합니다. | 읽기 | |||
| GetReportGroupTrend | 지정된 보고서 그룹의 테스트 보고서에 대한 테스트 보고서 값을 분석하고 누적할 수 있는 권한을 부여합니다. | 읽기 | |||
| GetResourcePolicy | 지정된 프로젝트 또는 보고서 그룹에 대한 리소스 정책을 반환할 수 있는 권한을 부여합니다. | 읽기 | |||
| ImportSourceCredentials | GitHub Enterprise 또는 Bitbucket 리포지토리에 소스 코드가 저장되어 있는 AWS CodeBuild 프로젝트의 소스 리포지토리 자격 증명을 가져올 수 있는 GitHub 권한을 부여합니다. | 쓰기 | |||
| InvalidateProjectCache | 프로젝트 캐시를 재설정할 수 있는 권한을 부여합니다. | 쓰기 | |||
| ListBuildBatches | 하나의 빌드 배치를 나타내는 각 빌드 배치 ID가 들어 있는 빌드 배치 ID 목록을 가져올 권한을 부여합니다. | 나열 | |||
| ListBuildBatchesForProject | 지정된 빌드 프로젝트에 대해 하나의 빌드 배치를 나타내는 각 빌드 배치 ID가 들어 있는 빌드 배치 ID 목록을 가져올 권한을 부여합니다. | 나열 | |||
| ListBuilds | 하나의 빌드를 나타내는 각 빌드 ID가 들어 있는 빌드 ID 목록을 가져올 권한을 부여합니다. | 나열 | |||
| ListBuildsForProject | 지정된 빌드 프로젝트에 대해 하나의 빌드를 나타내는 각 빌드 ID가 들어 있는 빌드 ID 목록을 가져올 권한을 부여합니다. | 나열 | |||
| ListConnectedOAuthAccounts [권한만 해당] | 연결된 서드 파티 OAuth 공급자를 나열할 수 있는 권한을 부여합니다. 콘솔에서만 사용됩니다. AWS CodeBuild | 나열 | |||
| ListCuratedEnvironmentImages | 에서 관리하는 Docker 이미지에 대한 정보를 가져올 수 있는 권한을 부여합니다. AWS CodeBuild | 나열 | |||
| ListFleets | 컴퓨팅 플릿 ARN 목록을 가져올 권한을 부여하며, 각 컴퓨팅 플릿 ARN은 단일 플릿을 나타냅니다. | 나열 | |||
| ListProjects | 하나의 빌드 프로젝트를 나타내는 각 빌드 프로젝트 이름이 들어 있는 빌드 프로젝트 이름 목록을 가져올 권한을 부여합니다. | 나열 | |||
| ListReportGroups | 보고 그룹 ARN의 목록을 반환할 수 있는 권한을 부여합니다. 각 보고서 그룹 ARN은 하나의 보고서 그룹을 나타냅니다. | 나열 | |||
| ListReports | 보고서 ARN의 목록을 반환할 수 있는 권한을 부여합니다. 각 보고서 ARN은 하나의 보고서를 나타냅니다. | 나열 | |||
| ListReportsForReportGroup | 지정된 보고서 그룹에 속하는 보고서 ARN의 목록을 반환할 권한을 부여합니다. 각 보고서 ARN은 하나의 보고서를 나타냅니다. | 나열 | |||
| ListRepositories [권한만 해당] | 연결된 서드 파티 OAuth 공급자의 소스 코드 리포지토리를 나열할 권한을 부여합니다. 콘솔에서만 사용됩니다. AWS CodeBuild | 나열 | |||
| ListSharedProjects | 요청자들과 공유한 프로젝트 ARN의 목록을 반환할 권한을 부여합니다. 각 프로젝트 ARN은 하나의 프로젝트를 나타냅니다. | 나열 | |||
| ListSharedReportGroups | 요청자들과 공유한 보고서 그룹 ARN의 목록을 반환할 권한을 부여합니다. 각 보고서 그룹 ARN은 하나의 보고서 그룹을 나타냅니다. | 나열 | |||
| ListSourceCredentials | SourceCredentialsInfo 개체 목록을 반환할 권한을 부여합니다. | 나열 | |||
| PersistOAuthToken [권한만 해당] | 연결된 서드 파티 OAuth 공급자의 OAuth 토큰을 저장할 수 있는 권한을 부여합니다. AWS CodeBuild 콘솔에서만 사용됩니다. | 쓰기 | |||
| PutResourcePolicy | 연결된 프로젝트 또는 보고서 그룹에 대한 리소스 정책을 생성할 권한을 부여합니다. | 권한 관리 | |||
| RetryBuild | 빌드를 재시도할 수 있는 권한을 부여합니다. | 쓰기 | |||
| RetryBuildBatch | 빌드 배치를 재시도할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StartBuild | 빌드 실행을 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StartBuildBatch | 빌드 배치 실행을 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StopBuild | 빌드 실행 중단을 시도할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StopBuildBatch | 빌드 배치 실행 중단을 시도할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateFleet | 기존 컴퓨팅 플릿의 설정을 변경할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateProject | 기존 빌드 프로젝트의 설정을 변경할 권한을 부여합니다. | 쓰기 | |||
| UpdateProjectVisibility | 프로젝트 및 해당 빌드의 퍼블릭 가시성을 변경할 권한을 부여합니다. | 쓰기 | |||
| UpdateReport [권한만 해당] | 보고서에 대한 정보를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateReportGroup | 기존 보고 그룹의 설정을 변경할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateWebhook | AWS CodeBuild 빌드 프로젝트와 관련된 웹훅을 업데이트할 권한을 부여합니다. | 쓰기 |
AWS CodeBuild에서 정의한 리소스 유형
이 서비스에서 정의하는 리소스 유형은 다음과 같으며, IAM 권한 정책 설명의 Resource 요소에서 사용할 수 있습니다. 작업 테이블의 각 작업에서 해당 작업으로 지정할 수 있는 리소스 유형을 식별합니다. 리소스 유형은 정책에 포함할 조건 키를 정의할 수도 있습니다. 이러한 키는 리소스 유형 테이블의 마지막 열에 표시됩니다. 다음 테이블의 열에 관한 자세한 내용은 리소스 유형 테이블을 참조하세요.
| 리소스 유형 | ARN | 조건 키 |
|---|---|---|
| build |
arn:${Partition}:codebuild:${Region}:${Account}:build/${BuildId}
|
|
| build-batch |
arn:${Partition}:codebuild:${Region}:${Account}:build-batch/${BuildBatchId}
|
|
| project |
arn:${Partition}:codebuild:${Region}:${Account}:project/${ProjectName}
|
|
| report-group |
arn:${Partition}:codebuild:${Region}:${Account}:report-group/${ReportGroupName}
|
|
| report |
arn:${Partition}:codebuild:${Region}:${Account}:report/${ReportGroupName}:${ReportId}
|
|
| fleet |
arn:${Partition}:codebuild:${Region}:${Account}:fleet/${FleetName}:${FleetId}
|
AWS CodeBuild의 조건 키
AWS CodeBuild IAM 정책의 Condition 요소에 사용할 수 있는 다음 조건 키를 정의합니다. 이러한 키를 사용하여 정책 설명이 적용되는 조건을 보다 상세하게 설정할 수 있습니다. 다음 테이블의 열에 대한 자세한 내용은 조건 키 테이블을 참조하세요.
모든 서비스에 사용할 수 있는 글로벌 조건 키를 보려면 사용 가능한 글로벌 조건 키를 참조하세요.
| 조건 키 | 설명 | 유형 |
|---|---|---|
| aws:RequestTag/${TagKey} | 요청에 태그 키-값 페어가 있는지 여부를 기준으로 작업에 의한 액세스를 필터링합니다. | String |
| aws:ResourceTag/${TagKey} | 리소스에 연결된 태그 키-값 페어를 기준으로 작업에 의한 액세스를 필터링합니다. | String |
| aws:TagKeys | 요청에 태그 키가 있는지 여부를 기준으로 작업에 의한 액세스를 필터링합니다. | ArrayOfString |
