D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# AWS WAF Classic exemples utilisant AWS CLI
<a name="cli_2_waf_code_examples"></a>

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du AWS Command Line Interface with AWS WAF Classic.

Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

**Topics**
+ [Actions](#actions)

## Actions
<a name="actions"></a>

### `configuration de journalisation des sorties`
<a name="waf_PutLoggingConfiguration_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`put-logging-configuration`.

**AWS CLI**  
**Pour créer une configuration de journalisation pour l’ARN ACL Web avec l’ARN du flux Firehose de Kinesis spécifié**  
L'`put-logging-configuration`exemple suivant montre la configuration de journalisation pour WAF avec CloudFront.  

```
aws waf put-logging-configuration \
    --logging-configuration {{ResourceArn=arn:aws:waf::123456789012:webacl/3bffd3ed-fa2e-445e-869f-a6a7cf153fd3,LogDestinationConfigs=arn:aws:firehose:us-east-1:123456789012:deliverystream/aws-waf-logs-firehose-stream,RedactedFields=[]}}
```
Sortie :  

```
{
    "LoggingConfiguration": {
        "ResourceArn": "arn:aws:waf::123456789012:webacl/3bffd3ed-fa2e-445e-869f-a6a7cf153fd3",
        "LogDestinationConfigs": [
            "arn:aws:firehose:us-east-1:123456789012:deliverystream/aws-waf-logs-firehose-stream"
        ]
    }
}
```
+  Pour plus de détails sur l'API, reportez-vous [PutLoggingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf/put-logging-configuration.html)à la section *Référence des AWS CLI commandes*. 

### `update-byte-match-set`
<a name="waf_UpdateByteMatchSet_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`update-byte-match-set`.

**AWS CLI**  
**Pour mettre à jour un jeu de correspondance d’octets**  
La `update-byte-match-set` commande suivante supprime un ByteMatchTuple objet (filtre) dans un ByteMatchSet :  

```
aws waf 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"}
```
Pour plus d’informations, consultez Utilisation des conditions de correspondance de chaîne dans le Manuel du développeur *AWS  WAF*.  
+  Pour plus de détails sur l'API, reportez-vous [UpdateByteMatchSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf/update-byte-match-set.html)à la section *Référence des AWS CLI commandes*. 

### `mise à jour de l'adresse IP`
<a name="waf_UpdateIpSet_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`update-ip-set`.

**AWS CLI**  
**Pour mettre à jour un ensemble d’adresses IP**  
La commande `update-ip-set` suivante met à jour un IPSet avec une adresse IPv4 et supprime une adresse IPv6 :  

```
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"}
```
Vous pouvez également utiliser un fichier JSON pour spécifier l’entrée. Par exemple :  

```
aws waf update-ip-set --ip-set-id {{a123fae4-b567-8e90-1234-5ab67ac8ca90}} --change-token {{12cs345-67cd-890b-1cd2-c3a4567d89f1}}  --updates {{file://change.json}}
```
Où le contenu du fichier JSON est :  

```
[
{
"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"
}
}
]
```
Pour plus d’informations, consultez Utilisation des conditions de correspondance IP dans le Manuel du développeur *AWS  WAF*.  
+  Pour plus de détails sur l'API, reportez-vous [UpdateIpSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf/update-ip-set.html)à la section *Référence des AWS CLI commandes*. 

### `règle de mise à jour`
<a name="waf_UpdateRule_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`update-rule`.

**AWS CLI**  
**Pour mettre à jour une règle**  
La commande `update-rule` suivante supprime un objet Predicate dans une règle :  

```
aws waf 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"}
```
Pour plus d’informations, consultez Utilisation des règles dans le Manuel du développeur *AWS  WAF*.  
+  Pour plus de détails sur l'API, reportez-vous [UpdateRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf/update-rule.html)à la section *Référence des AWS CLI commandes*. 

### `ensemble de contraintes de taille de mise à jour`
<a name="waf_UpdateSizeConstraintSet_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`update-size-constraint-set`.

**AWS CLI**  
**Pour mettre à jour un jeu de contraintes de taille**  
La `update-size-constraint-set` commande suivante supprime un SizeConstraint objet (filtres) dans un ensemble de contraintes de taille :  

```
aws waf 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}
```
Pour plus d’informations, consultez Utilisation des conditions de contrainte de taille dans le Manuel du développeur *AWS  WAF*.  
+  Pour plus de détails sur l'API, reportez-vous [UpdateSizeConstraintSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf/update-size-constraint-set.html)à la section *Référence des AWS CLI commandes*. 

### `jeu de correspondances update-sql-injection-`
<a name="waf_UpdateSqlInjectionMatchSet_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`update-sql-injection-match-set`.

**AWS CLI**  
**Pour mettre à jour un de correspondance d’injection SQL**  
La `update-sql-injection-match-set` commande suivante supprime un SqlInjectionMatchTuple objet (filtres) dans un jeu de correspondances par injection SQL :  

```
aws waf 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",SqlInjectionMatchTuple={FieldToMatch={Type="QUERY_STRING"},TextTransformation="URL_DECODE"}
```
Pour plus d’informations, consultez Utilisation des conditions de correspondance d’injection SQL dans le Manuel du développeur *AWS  WAF*.  
+  Pour plus de détails sur l'API, reportez-vous [UpdateSqlInjectionMatchSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf/update-sql-injection-match-set.html)à la section *Référence des AWS CLI commandes*. 

### `update-web-acl`
<a name="waf_UpdateWebAcl_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`update-web-acl`.

**AWS CLI**  
**Pour mettre à jour une liste ACL Web**  
La commande `update-web-acl` suivante supprime un objet `ActivatedRule` d’une liste WebACL.  
aws waf update-web-acl --web-acl-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="delete », =' {Priority=1, = » «, Action= {type="Autoriser"}, Type="REGULAR "} 'ActivatedRuleRuleIdWAFRule-1-Example  
Sortie :  

```
{
    "ChangeToken": "12cs345-67cd-890b-1cd2-c3a4567d89f1"
}
```
Pour plus d'informations, consultez la section [Working with Web ACL](https://docs.aws.amazon.com/waf/latest/developerguide/classic-web-acl-working-with.html) dans le guide du *développeur AWS WAF, AWS Firewall Manager et AWS Shield Advanced*.  
+  Pour plus de détails sur l'API, reportez-vous [UpdateWebAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf/update-web-acl.html)à la section *Référence des AWS CLI commandes*. 

### `update-xss-match-set`
<a name="waf_UpdateXssMatchSet_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`update-xss-match-set`.

**AWS CLI**  
**Pour mettre à jour un XSSMatchSet**  
La `update-xss-match-set` commande suivante supprime un XssMatchTuple objet (filtres) dans un XssMatchSet :  

```
aws waf 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"}
```
Pour plus d'informations, consultez la section Travailler avec les conditions Cross-site de correspondance des scripts dans le guide du développeur *AWS WAF*.  
+  Pour plus de détails sur l'API, reportez-vous [UpdateXssMatchSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf/update-xss-match-set.html)à la section *Référence des AWS CLI commandes*.