

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à.

# CloudFormation Aggancia i filtri target
<a name="hooks-target-filtering"></a>

Questo argomento fornisce indicazioni sulla configurazione dei filtri di destinazione per CloudFormation gli Hooks. Puoi utilizzare i filtri di destinazione per un controllo più granulare su quando e su quali risorse viene richiamato il tuo Hook. Puoi configurare filtri che vanno dal semplice targeting per tipo di risorsa a combinazioni più complesse di tipi di risorse, azioni e punti di richiamo.

Per specificare uno o più nomi di stack come filtri nella configurazione di Hooks, aggiungi una chiave sotto. `TargetFilters` `HookConfiguration`

`TargetFilters`supporta le seguenti proprietà. 

`Actions`  <a name="hooks-targetfilters-actions"></a>
Un array di stringhe che specifica le azioni da intraprendere. Per vedere un esempio, consulta [Esempio 1: filtro target di base](#target-filtering-example-1).  
*Valori validi*: `CREATE` \$1 `UPDATE` \$1 `DELETE`  
Per`RESOURCE`, e `CLOUD_CONTROL` target`STACK`, sono applicabili tutte le azioni di destinazione. Per `CHANGE_SET` gli obiettivi, è applicabile solo l'`CREATE`azione. Per ulteriori informazioni, consulta [Obiettivi Hook](hooks-concepts.md#hook-terms-hook-target).

`InvocationPoints`  <a name="hooks-targetfilters-invocationpoints"></a>
Un array di stringhe che specifica i punti di invocazione da utilizzare come target.  
*Valori validi*: `PRE_PROVISION`

`TargetNames`  <a name="hooks-targetfilters-targetnames"></a>
Un array di stringhe che specifica i nomi dei tipi di risorse da utilizzare come target, ad esempio. `AWS::S3::Bucket`   
I nomi delle destinazioni supportano nomi di destinazione concreti e la corrispondenza completa con caratteri jolly. Per ulteriori informazioni, consulta [Usare i caratteri jolly con i nomi degli obiettivi di Hook](wildcard-hook-targets.md).  
*Pattern*: `^[a-zA-Z0-9]{2,64}::[a-zA-Z0-9]{2,64}::[a-zA-Z0-9]{2,64}$`  
*Maximum*: `50`

`Targets`  <a name="hooks-targetfilters-targets"></a>
Un array di oggetti che specifica l'elenco di obiettivi da utilizzare per il filtraggio degli obiettivi.  
Ogni oggetto nell'array targets ha le seguenti proprietà.    
`Actions`  <a name="hooks-targetfilters-targets-actions"></a>
L'azione per l'obiettivo specificato.  
*Valori validi*: `CREATE` \$1 `UPDATE` \$1 `DELETE`  
`InvocationPoints`  <a name="hooks-targetfilters-targets-invocationpoints"></a>
Il punto di invocazione per il target specificato.  
*Valori validi*: `PRE_PROVISION`  
`TargetNames`  <a name="hooks-targetfilters-targets-targetnames"></a>
Il nome del tipo di risorsa da scegliere come target.

**Nota**  
Non è possibile includere contemporaneamente sia l'array di `Targets` oggetti che gli `InvocationPoints` array `TargetNames``Actions`, o. Se si desidera utilizzare questi tre elementi e`Targets`, è necessario includerli nell'array di `Targets` oggetti. Per vedere un esempio, consulta [Esempio 2: utilizzo dell'array di `Targets` oggetti](#target-filtering-example-2).

## Esempi di filtri target
<a name="target-filtering-examples"></a>

Questa sezione fornisce esempi che puoi seguire per creare filtri di destinazione per CloudFormation Hooks.

### Esempio 1: filtro target di base
<a name="target-filtering-example-1"></a>

Per creare un filtro di destinazione di base incentrato su tipi di risorse specifici, utilizzate l'`TargetFilters`oggetto con l'`Actions`array. La seguente configurazione del filtro di destinazione richiamerà l'Hook su tutte le `Create` operazioni di destinazione e sulle `Delete` azioni per le operazioni di destinazione specificate (in questo caso, entrambe `RESOURCE` le `STACK` operazioni). `Update`

```
{
  "CloudFormationConfiguration": {
    "HookConfiguration": {
      "HookInvocationStatus": "ENABLED",
      "TargetOperations": [
        "STACK",
        "RESOURCE"
      ],
      "FailureMode": "WARN",
      "Properties": {},
      "TargetFilters": {
        "Actions": [
           "Create",
           "Update",
           "Delete"
        ]
      }
    }
  }
}
```

### Esempio 2: utilizzo dell'array di `Targets` oggetti
<a name="target-filtering-example-2"></a>

Per filtri più avanzati, è possibile utilizzare l'array di `Targets` oggetti per elencare combinazioni specifiche di obiettivi, azioni e punti di invocazione. La seguente configurazione del filtro di destinazione richiamerà l'Hook prima `CREATE` e `UPDATE` le azioni sui bucket S3 e sulle tabelle DynamoDB. Si applica a entrambe le operazioni. `STACK` `RESOURCE`

```
{
  "CloudFormationConfiguration": {
    "HookConfiguration": {
      "HookInvocationStatus": "ENABLED",
      "TargetOperations": [
        "STACK",
        "RESOURCE"
      ],
      "FailureMode": "WARN",
      "Properties": {},
      "TargetFilters": {
        "Targets": [
          {
             "TargetName": "AWS::S3::Bucket",
             "Action": "CREATE",
             "InvocationPoint": "PRE_PROVISION"
          },
          {
             "TargetName": "AWS::S3::Bucket",
             "Action": "UPDATE",
             "InvocationPoint": "PRE_PROVISION"
          },
          {
             "TargetName": "AWS::DynamoDB::Table",
             "Action": "CREATE",
             "InvocationPoint": "PRE_PROVISION"
          },
          {
             "TargetName": "AWS::DynamoDB::Table",
             "Action": "UPDATE",
             "InvocationPoint": "PRE_PROVISION"
          }
        ]               
      }
    }
  }
}
```