Riferimento alla sintassi dello schema di configurazione Hook - CloudFormation
Proprietà dello schema di configurazione HookEsempi di configurazione Hook

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Riferimento alla sintassi dello schema di configurazione Hook

Questa sezione descrive la sintassi dello schema utilizzata per configurare gli Hooks. CloudFormation utilizza questo schema di configurazione in fase di esecuzione quando richiama un Hook in un. Account AWS

Per consentire a Hook di ispezionare in modo proattivo la configurazione dello stack, imposta su ENABLED dopo che l'HookInvocationStatusHook è stato registrato e attivato nel tuo account.

Argomenti
Nota

La quantità massima di dati che la configurazione di un Hook può memorizzare è di 300 KB. Questo si aggiunge a tutti i vincoli imposti al parametro di funzionamento della Configuration SetTypeConfigurationrichiesta.

Proprietà dello schema di configurazione Hook

Lo schema seguente è la struttura di uno schema di configurazione Hook.

{
    "CloudFormationConfiguration": {
        "HookConfiguration": {
            "HookInvocationStatus": "ENABLED",
            "TargetOperations": ["STACK"],
            "FailureMode": "FAIL",
            "EncryptionConfiguration": {
                "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/abc-123"
            },
            "Properties": {
                ...
            }
        }
    }
}
HookConfiguration

La configurazione Hook supporta l'attivazione o la disattivazione degli Hook a livello di stack, le modalità di errore e i valori delle proprietà Hook.

La configurazione Hook supporta le seguenti proprietà.

HookInvocationStatus

Specifica se l'Hook è ENABLED oDISABLED.

Valori validi: ENABLED | DISABLED

TargetOperations

Specifica l'elenco delle operazioni su cui viene eseguito l'Hook. Per ulteriori informazioni, consulta Obiettivi Hook.

Valori validi: STACK | RESOURCE | CHANGE_SET | CLOUD_CONTROL

TargetStacks

Disponibile per la compatibilità con le versioni precedenti. Usa HookInvocationStatus invece.

Se la modalità è impostata suALL, l'Hook si applica a tutti gli stack dell'account durante un'operazione su CREATEUPDATE, o su una DELETE risorsa.

Se la modalità è impostata suNONE, l'Hook non si applicherà agli stack del tuo account.

Valori validi: ALL | NONE

FailureMode

Questo campo indica al servizio come trattare gli errori di Hook.

  • Se la modalità è impostata su e l'Hook fallisce, la configurazione di errore interrompe il provisioning delle risorse e ripristina lo stack. FAIL

  • Se la modalità è impostata su WARN e l'Hook fallisce, la configurazione warn consente di continuare il provisioning con un messaggio di avviso.

Valori validi: FAIL | WARN

EncryptionConfiguration

Specifica le impostazioni di crittografia per i dati delle annotazioni Hook.

KmsKeyId

L'alias, l'alias ARN, l'ID della chiave o l'ARN della chiave di crittografia AWS KMS simmetrica utilizzata per crittografare i dati delle annotazioni Hook. Per ulteriori informazioni, consulta i documenti. KeyId AWS KMS

Prima di poter creare Hooks con AWS KMS chiavi gestite dal cliente, l'utente o il ruolo deve disporre AWS KMS delle autorizzazioni per e. DescribeKey GenerateDataKey Per ulteriori informazioni, consulta AWS KMS policy chiave e autorizzazioni per crittografare i risultati di CloudFormation Hooks a riposo.

Properties

Specifica le proprietà di runtime di Hook. Queste devono corrispondere alla forma delle proprietà supportate dallo schema Hooks.

Esempi di configurazione Hook

Per esempi di configurazione di Hooks da AWS CLI, consulta le seguenti sezioni: