翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# CloudFormation フックの呼び出し結果を表示する
このトピックでは、 CloudFormation フックの呼び出し結果を表示する方法について説明します。呼び出し結果を表示すると、フックがリソースをどのように評価しているかを理解し、フックがリソースを検証したときに検出された問題を解決するのに役立ちます。
呼び出しは、検証ロジック (プロアクティブコントロール、ガードルール、Lambda 関数など AWS Control Tower ) がリソースのライフサイクル中に実行される特定のインスタンスです。
## コンソールで呼び出し結果を表示する
コンソールで呼び出し結果を表示するには、**呼び出しの概要**ページ、個々のフックの呼び出し履歴、スタック固有の呼び出しの個々のスタックイベントの 3 つの方法があります。
### すべてのフックの結果を表示する
**呼び出しの概要**ページには、過去 90 日間のアカウントとリージョンのすべてのフック呼び出しが包括的に表示されます。
**すべてのフックの結果を表示するには**
1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/) で CloudFormation コンソールを開きます。
1. 画面上部のナビゲーションバーで、フック呼び出しを表示する AWS リージョン を選択します。
1. ナビゲーションペインから、**呼び出しの概要**を選択します。
1. このページには、過去 90 日間のすべてのフック呼び出しのリストが表示されます。
+ 呼び出し ID
+ フック
+ ターゲット
+ モード (`Warn` または `Fail`)
+ 結果 (`Warning`、`Pass`、`Failed`、`In progress`)
+ 呼び出し時間
+ 結果メッセージ
1. テーブルの上部にある検索バーを使用してリストをフィルタリングし、特定の呼び出しを検索できます。
1. 特定の呼び出しを選択すると、失敗したフック呼び出しの修正ガイダンスなど、呼び出し結果に関する詳細が表示されます。
### 個々のフックの呼び出し履歴を表示する
個々のフックの呼び出し履歴を使用して呼び出し結果を表示することもできます。
**特定のフックのフック呼び出しを表示するには**
1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/) で CloudFormation コンソールを開きます。
1. 画面上部のナビゲーションバーで、フック呼び出しを表示する AWS リージョン を選択します。
1. ナビゲーションペインからフックを選択します****。
1. フック呼び出しを表示するフックを選択します。
1. 特定の呼び出しを選択すると、失敗したフック呼び出しの修正ガイダンスなど、呼び出し結果に関する詳細が表示されます。
### スタック固有の呼び出しの結果を表示する
スタック**イベント**ページから特定のスタックの呼び出し結果を表示することもできます。
**特定のスタックのフック呼び出しを表示するには**
1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/) で CloudFormation コンソールを開きます。
1. 画面上部のナビゲーションバーで、スタックオペレーションが発生した AWS リージョン を選択します。
1. ナビゲーションペインで **[Stacks]** (スタック) を選択します。
1. フック呼び出しを表示するスタックを選択します。
1. **スタックイベント**タブを選択します。
1. イベントリストで、**ステータスの理由**列で**フック呼び出しが完了した**イベントを探します。
1. 特定のフック呼び出しの詳細を表示するには、**フック呼び出し**列を確認し、下線付きのテキストを選択して、より詳細な情報を含むポップアップウィンドウを開きます。
**注記**
非表示の列を表示するには、セクションの右上隅にある歯車アイコンを選択して**設定**モーダルを開き、必要に応じて設定を更新し、**確認**を選択します。
## を使用して呼び出し結果を表示する AWS CLI
[https://docs.aws.amazon.com/cli/latest/reference/cloudformation/list-hook-results.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/list-hook-results.html) コマンドを使用して、フック呼び出しに関する情報を取得します。このコマンドは、次のフィルタリングオプションをサポートしています。
+ すべてのフック呼び出し結果を取得する (パラメータは不要)
+ フック ARN でフィルタリングする ( を使用`--type-arn`)
+ フック ARN とステータスでフィルタリングする ( `--type-arn`と を使用`--status`)
+ 特定のターゲットを検索する ( `--target-type`と を使用`--target-id`)
**フック ARN で結果をフィルタリングする**
次の コマンドは、特定のフックのすべてのフック呼び出し結果を一覧表示します。
```
aws cloudformation list-hook-results \
--type-arn arn:aws:cloudformation:us-west-2:123456789012:type/hook/MyOrg-Security-ComplianceHook \
--region us-west-2
```
出力例:
```
{
"HookResults": [
{
"TypeArn": "arn:aws:cloudformation:us-west-2:123456789012:type/hook/MyOrg-Security-ComplianceHook",
"HookResultId": "59ef501c-0ac4-47c0-a193-e071cabf748d",
"TypeName": "MyOrg::Security::ComplianceHook",
"TypeVersionId": "00000001",
"HookExecutionTarget": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/39f29d10-73ed-11f0-abc1-0affdfe4aebb",
"InvokedAt": "2025-08-08T00:18:39.651Z",
"FailureMode": "WARN",
"HookStatusReason": "...",
"InvocationPoint": "PRE_PROVISION",
"Status": "HOOK_COMPLETE_FAILED"
},
...
]
}
```
レスポンスのフィールドの説明については、 *AWS CloudFormation API リファレンス*の[HookResultSummary](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_HookResultSummary.html)」を参照してください。
**フック ARN とステータスで結果をフィルタリングする**
結果間で共通のステータスをフィルタリングするには、 コマンドで `--status`オプションを指定します。次の値を指定できます。
+ `HOOK_IN_PROGRESS`: フックは現在実行中です。
+ `HOOK_COMPLETE_SUCCEEDED`: フックが正常に完了しました。
+ `HOOK_COMPLETE_FAILED`: フックは完了しましたが、検証に失敗しました。
+ `HOOK_FAILED`: フックの実行中にエラーが発生しました。
```
aws cloudformation list-hook-results \
--type-arn arn:aws:cloudformation:us-west-2:123456789012:type/hook/MyOrg-Security-ComplianceHook \
--status HOOK_COMPLETE_FAILED \
--region us-west-2
```
出力例:
```
{
"HookResults": [
{
"TypeArn": "arn:aws:cloudformation:us-west-2:123456789012:type/hook/MyOrg-Security-ComplianceHook",
"HookResultId": "59ef501c-0ac4-47c0-a193-e071cabf748d",
"TypeName": "MyOrg::Security::ComplianceHook",
"TypeVersionId": "00000001",
"HookExecutionTarget": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/39f29d10-73ed-11f0-abc1-0affdfe4aebb",
"InvokedAt": "2025-08-08T00:18:39.651Z",
"FailureMode": "WARN",
"HookStatusReason": "...",
"InvocationPoint": "PRE_PROVISION",
"Status": "HOOK_COMPLETE_FAILED"
},
...
]
}
```
レスポンスのフィールドの説明については、 *AWS CloudFormation API リファレンス*の[HookResultSummary](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_HookResultSummary.html)」を参照してください。
**ターゲットタイプとターゲット ID で結果をフィルタリングする**
次の コマンドは、特定の Cloud Control API リクエストのすべてのフック呼び出し結果を一覧表示します。
```
aws cloudformation list-hook-results \
--target-type CLOUD_CONTROL \
--target-id d417b05b-9eff-46ef-b164-08c76aec1801 \
--region us-west-2
```
出力例:
```
{
"HookResults": [
{
"TargetType": "CLOUD_CONTROL",
"TargetId": "d417b05b-9eff-46ef-b164-08c76aec1801",
"HookResults": [
{
"TypeArn": "arn:aws:cloudformation:us-west-2:123456789012:type/hook/MyOrg-Security-ComplianceHook",
"HookResultId": "4e7f4766-d8fe-44e5-8587-5b327a148abe",
"TypeName": "MyOrg::Security::ComplianceHook",
"TypeVersionId": "00000001",
"FailureMode": "WARN",
"HookStatusReason": "...",
"InvocationPoint": "PRE_PROVISION",
"Status": "HOOK_COMPLETE_FAILED"
},
...
]
}
]
}
```
レスポンスのフィールドの説明については、 *AWS CloudFormation API リファレンス*の[HookResultSummary](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_HookResultSummary.html)」を参照してください。
**特定の呼び出しの詳細な結果を取得する**
[https://docs.aws.amazon.com/cli/latest/reference/cloudformation/get-hook-result.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/get-hook-result.html) コマンドを使用して、コンプライアンスチェックの結果や修復ガイダンスを含む注釈など、特定のフック呼び出しに関する詳細情報を取得します。
```
aws cloudformation get-hook-result \
--hook-result-id 59ef501c-0ac4-47c0-a193-e071cabf748d \
--region us-west-2
```
出力例:
```
{
"HookResultId": "59ef501c-0ac4-47c0-a193-e071cabf748d",
"InvocationPoint": "PRE_PROVISION",
"FailureMode": "WARN",
"TypeName": "MyOrg::Security::ComplianceHook",
"TypeVersionId": "00000001",
"TypeArn": "arn:aws:cloudformation:us-west-2:123456789012:type/hook/MyOrg-Security-ComplianceHook",
"Status": "HOOK_COMPLETE_FAILED",
"HookStatusReason": "Hook completed with failed validations",
"InvokedAt": "2025-08-08T00:18:39.651Z",
"Target": {
"TargetType": "RESOURCE",
"TargetTypeName": "AWS::S3::Bucket",
"TargetId": "my-s3-bucket",
"Action": "CREATE"
},
"Annotations": [
{
"AnnotationName": "BlockPublicAccessCheck",
"Status": "FAILED",
"StatusMessage": "Bucket does not block public access",
"RemediationMessage": "Enable block public access settings on the S3 bucket",
"SeverityLevel": "HIGH"
},
{
"AnnotationName": "BucketEncryptionCheck",
"Status": "PASSED",
"StatusMessage": "Bucket has encryption configured correctly"
}
]
}
```
レスポンスのフィールドの説明については、 *AWS CloudFormation API リファレンス*の[GetHookResult](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_GetHookResult.html)」を参照してください。