フック設定スキーマ構文リファレンス - AWS CloudFormation
フック設定スキーマのプロパティフック設定の例

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

フック設定スキーマ構文リファレンス

このセクションでは、フックの設定に使用されるスキーマ構文の概要を説明します。CloudFormation は、 でフックを呼び出すときに、実行時にこの設定スキーマを使用します AWS アカウント。

フックがスタックの設定をプロアクティブに検査できるようにするには、フックがアカウントに登録されてアクティブ化されたHookInvocationStatusENABLED後、 を に設定します。

トピック
注記

フックの設定で保存できるデータの最大量は 300 KB です。これは、 SetTypeConfigurationオペレーションのConfigurationリクエストパラメータに適用されるすべての制約に追加されます。

フック設定スキーマのプロパティ

次のスキーマは、フック設定スキーマの構造です。

{
    "CloudFormationConfiguration": {
        "HookConfiguration": {
            "HookInvocationStatus": "ENABLED",
            "TargetOperations": ["STACK"],
            "FailureMode": "FAIL",
            "Properties": {
                ...
            }
        }
    }
}
HookConfiguration

フック設定では、スタックレベルでのフックの有効化または無効化、障害モード、フックプロパティ値をサポートしています。

フック設定では、次のプロパティがサポートされています。

HookInvocationStatus

フックが ENABLEDか かを指定しますDISABLED。

有効な値: ENABLED | DISABLED

TargetOperations

フックが実行されるオペレーションのリストを指定します。詳細については、「フックターゲット」を参照してください。

有効な値: STACK | RESOURCE | CHANGE_SET | CLOUD_CONTROL

TargetStacks

下位互換性のために使用できます。HookInvocationStatus代わりに を使用します。

モードが に設定されている場合ALL、フックは CREATE、、UPDATEまたは DELETEリソースオペレーション中にアカウント内のすべてのスタックに適用されます。

モードが に設定されている場合NONE、フックはアカウントのスタックには適用されません。

有効な値: ALL | NONE

FailureMode

このフィールドは、フック障害の処理方法をサービスに指示します。

  • モードが に設定されていてFAIL、フックが失敗した場合、失敗設定はリソースのプロビジョニングを停止し、スタックをロールバックします。

  • モードが に設定WARNされていて、フックが失敗した場合、警告設定によりプロビジョニングを警告メッセージで続行できます。

有効な値: FAIL | WARN

Properties

フックランタイムプロパティを指定します。これらは、フックスキーマでサポートされているプロパティの形状と一致する必要があります。

フック設定の例

からフックを設定する例については AWS CLI、以下のセクションを参照してください。