Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# CloudFormation Hooks zielen auf Filter ab
<a name="hooks-target-filtering"></a>

Dieses Thema enthält Anleitungen zur Konfiguration von Zielfiltern für CloudFormation Hooks. Sie können Zielfilter verwenden, um detaillierter zu steuern, wann und auf welchen Ressourcen Ihr Hook aufgerufen wird. Du kannst Filter konfigurieren, die von der einfachen Ausrichtung auf Ressourcentypen bis hin zu komplexeren Kombinationen von Ressourcentypen, Aktionen und Aufrufpunkten reichen.

Um einen oder mehrere Stack-Namen als Filter in Ihrer Hooks-Konfiguration anzugeben, fügen Sie einen `TargetFilters` Schlüssel unter `HookConfiguration` hinzu.

`TargetFilters`unterstützt die folgenden Eigenschaften. 

`Actions`  <a name="hooks-targetfilters-actions"></a>
Ein Zeichenkettenarray, das die Aktionen angibt, auf die abgezielt werden soll. Ein Beispiel finden Sie unter [Beispiel 1: Einfacher Zielfilter](#target-filtering-example-1).  
*Zulässige Werte*: `CREATE` \$1 `UPDATE` \$1 `DELETE`  
Für `RESOURCE``STACK`, und `CLOUD_CONTROL` Ziele sind alle Zielaktionen anwendbar. Für `CHANGE_SET` Ziele ist nur die `CREATE` Aktion anwendbar. Weitere Informationen finden Sie unter [Hook-Ziele](hooks-concepts.md#hook-terms-hook-target).

`InvocationPoints`  <a name="hooks-targetfilters-invocationpoints"></a>
Ein Zeichenkettenarray, das angibt, dass der Aufruf auf das Ziel zeigt.  
*Gültige Werte*: `PRE_PROVISION`

`TargetNames`  <a name="hooks-targetfilters-targetnames"></a>
Ein Zeichenkettenarray, das die Namen der zu adressierenden Ressourcentypen angibt, `AWS::S3::Bucket` z. B.   
Zielnamen unterstützen konkrete Zielnamen und vollständigen Platzhalterabgleich. Weitere Informationen finden Sie unter [Verwendung von Platzhaltern mit Hook-Zielnamen](wildcard-hook-targets.md).  
*Muster*: `^[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>
Ein Objekt-Array, das die Liste der Ziele angibt, die für die Zielfilterung verwendet werden sollen.  
Jedes Ziel im Ziel-Array hat die folgenden Eigenschaften.    
`Actions`  <a name="hooks-targetfilters-targets-actions"></a>
Die Aktion für das angegebene Ziel.  
*Zulässige Werte*: `CREATE` \$1 `UPDATE` \$1 `DELETE`  
`InvocationPoints`  <a name="hooks-targetfilters-targets-invocationpoints"></a>
Der Aufrufpunkt für das angegebene Ziel.  
*Gültige Werte*: `PRE_PROVISION`  
`TargetNames`  <a name="hooks-targetfilters-targets-targetnames"></a>
Der Name des Ressourcentyps, auf den abgezielt werden soll.

**Anmerkung**  
Sie können nicht gleichzeitig das `Targets` Objekt-Array und das `TargetNames` `Actions` ,- oder `InvocationPoints` -Array einschließen. Wenn Sie diese drei Elemente und verwenden möchten`Targets`, müssen Sie sie in das `Targets` Objekt-Array aufnehmen. Ein Beispiel finden Sie unter [Beispiel 2: Verwenden des `Targets` Objekt-Arrays](#target-filtering-example-2).

## Beispiele für Zielfilter
<a name="target-filtering-examples"></a>

Dieser Abschnitt enthält Beispiele, denen Sie folgen können, um Zielfilter für CloudFormation Hooks zu erstellen.

### Beispiel 1: Einfacher Zielfilter
<a name="target-filtering-example-1"></a>

Um einen grundlegenden Zielfilter zu erstellen, der sich auf bestimmte Ressourcentypen konzentriert, verwenden Sie das `TargetFilters` Objekt mit dem `Actions` Array. Die folgende Zielfilterkonfiguration ruft den Hook für alle `Create``Update`, und `Delete` Aktionen für die angegebenen Zieloperationen (in diesem Fall `RESOURCE` sowohl als auch für `STACK` Operationen) auf.

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

### Beispiel 2: Verwenden des `Targets` Objekt-Arrays
<a name="target-filtering-example-2"></a>

Für erweiterte Filter können Sie das `Targets` Objekt-Array verwenden, um bestimmte Kombinationen aus Ziel, Aktion und Aufrufpunkt aufzulisten. Diese folgende Zielfilterkonfiguration ruft den Hook vor `CREATE` und `UPDATE` Aktionen für S3-Buckets und DynamoDB-Tabellen. Sie gilt sowohl für Operationen als auch. `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"
          }
        ]               
      }
    }
  }
}
```