翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# テストレポートのアクセス許可
<a name="test-permissions"></a>

 このトピックでは、テストレポートに関連するアクセス権限に関する重要な情報について説明します。

**Topics**
+ [テストレポートの IAM ロール](#test-permissions-required)
+ [テストレポートオペレーションのアクセス許可](#test-permissions-related-to-reporting)
+ [テストレポートのアクセス許可の例](#test-permissions-examples)

## テストレポートの IAM ロール
<a name="test-permissions-required"></a>

テストレポートを実行し、テストレポートを含めるようにプロジェクトを更新するには、IAM ロールに以下のアクセス権限が必要です。これらのアクセス許可は、事前定義された AWS 管理ポリシーに含まれています。既存のビルドプロジェクトにテストレポートを追加する場合は、これらのアクセス権限を自分で追加する必要があります。
+ `CreateReportGroup` 
+ `CreateReport` 
+ `UpdateReport` 
+ `BatchPutTestCases` 

コードカバレッジレポートを実行するには、IAM ロールに `BatchPutCodeCoverages` アクセス許可が付与されている必要もあります。

**注記**  
`BatchPutTestCases`、`CreateReport`、`UpdateReport`、および `BatchPutCodeCoverages` はパブリック権限ではありません。これらのアクセス許可に対応する AWS CLI コマンドまたは SDK メソッドを呼び出すことはできません。

これらのアクセス許可があることを確認するには、次のポリシーを IAM ロールにアタッチします。

```
{
    "Effect": "Allow",
    "Resource": [
        "*"
    ],
    "Action": [
        "codebuild:CreateReportGroup",
        "codebuild:CreateReport",
        "codebuild:UpdateReport",
        "codebuild:BatchPutTestCases",
        "codebuild:BatchPutCodeCoverages"
    ]
}
```

このポリシーは、使用する必要があるレポートグループだけに制限することをお勧めします。以下の例では、ポリシー内の 2 つの ARN を持つレポートグループのみにアクセス権限を制限します。

```
{
    "Effect": "Allow",
    "Resource": [
        "arn:aws:codebuild:your-region:your-aws-account-id:report-group/report-group-name-1",
        "arn:aws:codebuild:your-region:your-aws-account-id:report-group/report-group-name-2"
    ],
    "Action": [
        "codebuild:CreateReportGroup",
        "codebuild:CreateReport",
        "codebuild:UpdateReport",
        "codebuild:BatchPutTestCases",
        "codebuild:BatchPutCodeCoverages"
    ]
}
```

以下の例では、`my-project` という名前のプロジェクトのビルドを実行することによって作成されたレポートグループのみにアクセス権限を制限しています。

```
{
    "Effect": "Allow",
    "Resource": [
        "arn:aws:codebuild:your-region:your-aws-account-id:report-group/my-project-*"
    ],
    "Action": [
        "codebuild:CreateReportGroup",
        "codebuild:CreateReport",
        "codebuild:UpdateReport",
        "codebuild:BatchPutTestCases",
        "codebuild:BatchPutCodeCoverages"
    ]
}
```

**注記**  
プロジェクトで指定した CodeBuild サービスロールは、S3 バケットにアップロードするアクセス許可に使用されます。

## テストレポートオペレーションのアクセス許可
<a name="test-permissions-related-to-reporting"></a>

 次のテストレポート CodeBuild API オペレーションのアクセス権限を指定できます。
+  `BatchGetReportGroups` 
+  `BatchGetReports` 
+  `CreateReportGroup` 
+  `DeleteReportGroup` 
+  `DeleteReport` 
+  `DescribeTestCases` 
+  `ListReportGroups` 
+  `ListReports` 
+  `ListReportsForReportGroup` 
+  `UpdateReportGroup` 

詳細については、「[AWS CodeBuild アクセス許可リファレンス](auth-and-access-control-permissions-reference.md)」を参照してください。

## テストレポートのアクセス許可の例
<a name="test-permissions-examples"></a>

 テストレポートに関連するサンプルポリシーの詳細については、以下を参照してください。
+  [レポートグループの変更をユーザーに許可する](auth-and-access-control-iam-identity-based-access-control.md#customer-managed-policies-example-change-report-group) 
+  [レポートグループの作成をユーザーに許可する](auth-and-access-control-iam-identity-based-access-control.md#customer-managed-policies-example-create-report-group) 
+  [レポートの削除をユーザーに許可する](auth-and-access-control-iam-identity-based-access-control.md#customer-managed-policies-example-delete-report) 
+  [レポートグループの削除をユーザーに許可する](auth-and-access-control-iam-identity-based-access-control.md#customer-managed-policies-example-delete-report-group) 
+  [レポートグループに関する情報の取得をユーザーに許可する](auth-and-access-control-iam-identity-based-access-control.md#customer-managed-policies-get-information-about-report-group) 
+  [レポートに関する情報の取得をユーザーに許可する](auth-and-access-control-iam-identity-based-access-control.md#customer-managed-policies-get-information-about-reports) 
+  [レポートグループの一覧表示をユーザーに許可する](auth-and-access-control-iam-identity-based-access-control.md#customer-managed-policies-example-get-list-of-report-groups) 
+  [レポートの一覧表示をユーザーに許可する](auth-and-access-control-iam-identity-based-access-control.md#customer-managed-policies-example-get-list-of-reports) 
+  [レポートグループのレポートの一覧表示をユーザーに許可する](auth-and-access-control-iam-identity-based-access-control.md#customer-managed-policies-example-get-list-of-reports-for-report-group) 
+  [レポートのテストケースの一覧表示をユーザーに許可する](auth-and-access-control-iam-identity-based-access-control.md#customer-managed-policies-example-get-list-of-test-cases-for-report)