Weitere AWS SDK-Beispiele sind im GitHub Repo [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) verfügbar.
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.
# AWS WAF Classic Regional Beispiele mit AWS CLI
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS WAF Classic Regional.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `associate-web-acl`
Das folgende Codebeispiel zeigt die Verwendung. `associate-web-acl`
**AWS CLI**
**So verknüpfen Sie eine Web-ACL mit einer Ressource**
Der folgende `associate-web-acl`-Befehl verknüpft eine mit der Web-ACL-ID definierte Web-ACL mit einer Ressource, die wiederum durch den resource-arn definiert ist. Der Ressourcen-ARN kann sich entweder auf einen Application Load Balancer oder auf ein API Gateway beziehen:
```
aws waf-regional associate-web-acl \
--web-acl-id {{a123fae4-b567-8e90-1234-5ab67ac8ca90}} \
--resource-arn {{12cs345-67cd-890b-1cd2-c3a4567d89f1}}
```
Weitere Informationen finden Sie unter [Arbeiten mit Web-ACLs](https://docs.aws.amazon.com/waf/latest/developerguide/web-acl-working-with.html) im *Entwicklerhandbuch für AWS WAF*.
+ Einzelheiten zur API finden Sie [AssociateWebAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf-regional/associate-web-acl.html)in der *AWS CLI Befehlsreferenz*.
### `Put-Logging-Konfiguration`
Das folgende Codebeispiel zeigt, wie man es benutzt. `put-logging-configuration`
**AWS CLI**
**So erstellen Sie eine Logging-Konfiguration für den Web-ACL-ARN mit dem angegebenen Stream-ARN von Kinesis Firehose**
Das folgende `put-logging-configuration` Beispiel zeigt die Protokollierungskonfiguration für WAF mit ALB/APIGateway in Region`us-east-1`.
```
aws waf-regional put-logging-configuration \
--logging-configuration {{ResourceArn=arn:aws:waf-regional:us-east-1:123456789012:webacl/3bffd3ed-fa2e-445e-869f-a6a7cf153fd3,LogDestinationConfigs=arn:aws:firehose:us-east-1:123456789012:deliverystream/aws-waf-logs-firehose-stream,RedactedFields=[]}} \
--region {{us-east-1}}
```
Ausgabe:
```
{
"LoggingConfiguration": {
"ResourceArn": "arn:aws:waf-regional:us-east-1:123456789012:webacl/3bffd3ed-fa2e-445e-869f-a6a7cf153fd3",
"LogDestinationConfigs": [
"arn:aws:firehose:us-east-1:123456789012:deliverystream/aws-waf-logs-firehose-stream"
]
}
}
```
+ Einzelheiten zur API finden Sie [PutLoggingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf-regional/put-logging-configuration.html)in der *AWS CLI Befehlsreferenz.*
### `Byte-Match-Set aktualisieren`
Das folgende Codebeispiel zeigt, wie man es benutzt. `update-byte-match-set`
**AWS CLI**
**So aktualisieren Sie ein Byte-Match-Set**
Der folgende `update-byte-match-set`-Befehl löscht ein `ByteMatchTuple`-Objekt (Filter) in einem `ByteMatchSet`. Da der `updates`-Wert eingebettete doppelte Anführungszeichen enthält, müssen Sie den Wert mit einfachen Anführungszeichen umschließen.
```
aws waf-regional update-byte-match-set \
--byte-match-set-id {{a123fae4-b567-8e90-1234-5ab67ac8ca90}} \
--change-token {{12cs345-67cd-890b-1cd2-c3a4567d89f1}} \
--updates '{{Action="DELETE",ByteMatchTuple={FieldToMatch={Type="HEADER",Data="referer"},TargetString="badrefer1",TextTransformation="NONE",PositionalConstraint="CONTAINS"}}}'
```
Weitere Informationen finden Sie unter „Arbeiten mit Bedingungen für den Abgleich von Zeichenfolgen“ im *Entwicklerhandbuch für AWS WAF*.
+ Einzelheiten zur API finden Sie [UpdateByteMatchSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf-regional/update-byte-match-set.html)in der *AWS CLI Befehlsreferenz*.
### `update-ip-set`
Das folgende Codebeispiel zeigt, wie man es benutzt. `update-ip-set`
**AWS CLI**
**So erstellen Sie ein IP-Set**
Der folgende `update-ip-set`-Befehl aktualisiert ein IP-Set mit einer IPv4-Adresse und löscht eine IPv6-Adresse. Rufen Sie den Wert für `change-token` ab, indem Sie den Befehl `get-change-token` ausführen. Da der Wert für Updates eingebettete doppelte Anführungszeichen enthält, müssen Sie den Wert mit einfachen Anführungszeichen umschließen.
```
aws waf update-ip-set \
--ip-set-id {{a123fae4-b567-8e90-1234-5ab67ac8ca90}} \
--change-token {{12cs345-67cd-890b-1cd2-c3a4567d89f1}} \
--updates '{{Action="INSERT",IPSetDescriptor={Type="IPV4",Value="12.34.56.78/16"},Action="DELETE",IPSetDescriptor={Type="IPV6",Value="1111:0000:0000:0000:0000:0000:0000:0111/128"}}}'
```
Alternativ können Sie eine JSON-Datei verwenden, um die Eingabe vorzugeben. Beispiel:
```
aws waf-regional update-ip-set \
--ip-set-id {{a123fae4-b567-8e90-1234-5ab67ac8ca90}} \
--change-token {{12cs345-67cd-890b-1cd2-c3a4567d89f1}} \
--updates {{file://change.json}}
```
Inhalt des `change.json`
```
[
{
"Action": "INSERT",
"IPSetDescriptor":
{
"Type": "IPV4",
"Value": "12.34.56.78/16"
}
},
{
"Action": "DELETE",
"IPSetDescriptor":
{
"Type": "IPV6",
"Value": "1111:0000:0000:0000:0000:0000:0000:0111/128"
}
}
]
```
Weitere Informationen finden Sie unter [Arbeiten mit IP-Übereinstimmungsbedingungen](https://docs.aws.amazon.com/waf/latest/developerguide/web-acl-ip-conditions.html) im *Entwicklerhandbuch für AWS WAF*.
+ Einzelheiten zur API finden Sie [UpdateIpSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf-regional/update-ip-set.html)in der *AWS CLI Befehlsreferenz*.
### `Regel aktualisieren`
Das folgende Codebeispiel zeigt, wie man es benutzt. `update-rule`
**AWS CLI**
**So aktualisieren Sie eine Regel**
Der folgende `update-rule`-Befehl löscht ein `Predicate`-Objekt in einer Regel. Da der `updates`-Wert eingebettete doppelte Anführungszeichen enthält, müssen Sie den gesamten Wert mit einfachen Anführungszeichen umschließen.
```
aws waf-regional update-rule \
--rule-id {{a123fae4-b567-8e90-1234-5ab67ac8ca90}} \
--change-token {{12cs345-67cd-890b-1cd2-c3a4567d89f1}} \
--updates '{{Action="DELETE",Predicate={Negated=false,Type="ByteMatch",DataId="MyByteMatchSetID"}}}'
```
Weitere Informationen finden Sie unter [Arbeiten mit Regeln](https://docs.aws.amazon.com/waf/latest/developerguide/web-acl-rules.html) im *Entwicklerhandbuch für AWS WAF*.
+ Einzelheiten zur API finden Sie [UpdateRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf-regional/update-rule.html)in der *AWS CLI Befehlsreferenz*.
### `Größenbeschränkungssatz aktualisieren`
Das folgende Codebeispiel zeigt, wie man es benutzt. `update-size-constraint-set`
**AWS CLI**
**So aktualisieren Sie einen Größenbeschränkungssatz**
Der folgende `update-size-constraint-set` Befehl löscht ein SizeConstraint `-Objekt (Filter) in einem Größenbeschränkungssatz. Da der `updates`-Wert eingebettete doppelte Anführungszeichen enthält, müssen Sie den gesamten Wert mit einfachen Anführungszeichen umschließen.
```
aws waf-regional update-size-constraint-set \
--size-constraint-set-id {{a123fae4-b567-8e90-1234-5ab67ac8ca90}} \
--change-token {{12cs345-67cd-890b-1cd2-c3a4567d89f1}} \
--updates '{{Action="DELETE",SizeConstraint={FieldToMatch={Type="QUERY_STRING"},TextTransformation="NONE",ComparisonOperator="GT",Size=0}}}'
```
Weitere Informationen finden Sie unter [Arbeiten mit Größenbeschränkungsbedingungen](https://docs.aws.amazon.com/waf/latest/developerguide/web-acl-size-conditions.html) im *Entwicklerhandbuch für AWS WAF*.
+ Einzelheiten zur API finden Sie [UpdateSizeConstraintSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf-regional/update-size-constraint-set.html)in der *AWS CLI Befehlsreferenz.*
### `aktualisiere das SQL-Injektions-Match-Set`
Das folgende Codebeispiel zeigt, wie man. `update-sql-injection-match-set`
**AWS CLI**
**So aktualisieren Sie einen SQL-Injektions-Übereinstimmungssatz**
Der folgende `update-sql-injection-match-set`-Befehl löscht ein `SqlInjectionMatchTuple`-Objekt (Filter) in einem SQL-Injektions-Übereinstimmungssatz. Da der `updates`-Wert eingebettete doppelte Anführungszeichen enthält, müssen Sie den gesamten Wert in einfache Anführungszeichen setzen:
aws waf-regional update-sql-injection-match-set --sql-injection-match-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates 'action="DELETE“, = {= {type="query\_string "}, ="URL\_DECODE"} 'SqlInjectionMatchTupleFieldToMatchTextTransformation
Weitere Informationen finden Sie unter [Arbeiten mit SQL-Injektions-Übereinstimmungssätzen](https://docs.aws.amazon.com/waf/latest/developerguide/web-acl-sql-conditions.html) im *Entwicklerhandbuch für AWS WAF*.
+ Einzelheiten zur API finden Sie [UpdateSqlInjectionMatchSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf-regional/update-sql-injection-match-set.html)unter *AWS CLI Befehlsreferenz*.
### `update-web-acl`
Das folgende Codebeispiel zeigt, wie man es benutzt. `update-web-acl`
**AWS CLI**
**So aktualisieren Sie eine Web-ACL**
Der folgende `update-web-acl`-Befehl löscht ein `ActivatedRule`-Objekt in einer WebACL. Da der `updates`-Wert eingebettete doppelte Anführungszeichen enthält, müssen Sie den gesamten Wert in einfache Anführungszeichen setzen.
```
aws waf-regional update-web-acl \
--web-acl-id {{a123fae4-b567-8e90-1234-5ab67ac8ca90}} \
--change-token {{12cs345-67cd-890b-1cd2-c3a4567d89f1}} \
--updates Action="DELETE",ActivatedRule='{Priority=1,RuleId="WAFRule-1-Example",Action={Type="ALLOW"},Type="ALLOW"}'
```
Weitere Informationen finden Sie unter [Arbeiten mit Web-ACLs](https://docs.aws.amazon.com/waf/latest/developerguide/web-acl-working-with.html) im *Entwicklerhandbuch für AWS WAF*.
+ Einzelheiten zur API finden Sie [UpdateWebAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf-regional/update-web-acl.html)in der *AWS CLI Befehlsreferenz*.
### `update-xss-match-set`
Das folgende Codebeispiel zeigt, wie man es benutzt. `update-xss-match-set`
**AWS CLI**
**Um ein zu aktualisieren XSSMatchSet**
Der folgende `update-xss-match-set`-Befehl löscht ein `XssMatchTuple`-Objekt (Filter) in einem `XssMatchSet`. Da der `updates`-Wert eingebettete doppelte Anführungszeichen enthält, müssen Sie den gesamten Wert mit einfachen Anführungszeichen umschließen.
```
aws waf-regional update-xss-match-set \
--xss-match-set-id {{a123fae4-b567-8e90-1234-5ab67ac8ca90}} \
--change-token {{12cs345-67cd-890b-1cd2-c3a4567d89f1}} \
--updates '{{Action="DELETE",XssMatchTuple={FieldToMatch={Type="QUERY_STRING"},TextTransformation="URL_DECODE"}}}'
```
Weitere Informationen finden Sie unter [Working with Cross-site Scripting Match Conditions](https://docs.aws.amazon.com/waf/latest/developerguide/web-acl-xss-conditions.html) im *AWS WAF Developer Guide*.
+ Einzelheiten zur API finden Sie unter [UpdateXssMatchSet AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf-regional/update-xss-match-set.html)*Befehlsreferenz*.