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.
# Exemples de code pour AWS WAFV2 l'utilisation AWS SDKs
Les exemples de code suivants vous montrent comment utiliser AWS WAFV2 un kit de développement AWS logiciel (SDK).
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.
**Ressources supplémentaires**
+ **[AWS WAFV2 Guide du développeur](https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html)** — Plus d'informations sur AWS WAFV2.
+ **[AWS WAFV2 Référence d'API](https://docs.aws.amazon.com/waf/latest/APIReference/API_Operations_AWS_WAFV2.html)** : détails sur toutes les AWS WAFV2 actions disponibles.
+ **[AWS Centre pour les développeurs](https://aws.amazon.com/developer/code-examples/?awsf.sdk-code-examples-product=product%23)** : exemples de code que vous pouvez filtrer par catégorie ou par recherche en texte intégral.
+ **[AWS Exemples de SDK](https://github.com/awsdocs/aws-doc-sdk-examples)** : GitHub dépôt avec code complet dans les langues préférées. Inclut des instructions sur la configuration et l’exécution du code.
**Contents**
+ [Principes de base](wafv2_code_examples_basics.md)
+ [Actions](wafv2_code_examples_actions.md)
+ [`CreateWebAcl`](wafv2_example_wafv2_CreateWebAcl_section.md)
# Exemples de base pour AWS WAFV2 l'utilisation AWS SDKs
Les exemples de code suivants montrent comment utiliser les principes de base de AWS WAFV2 with AWS SDKs.
**Contents**
+ [Actions](wafv2_code_examples_actions.md)
+ [`CreateWebAcl`](wafv2_example_wafv2_CreateWebAcl_section.md)
# Actions d' AWS WAFV2 utilisation AWS SDKs
Les exemples de code suivants montrent comment effectuer des AWS WAFV2 actions individuelles avec AWS SDKs. Chaque exemple inclut un lien vers GitHub, où vous pouvez trouver des instructions pour configurer et exécuter le code.
Les exemples suivants incluent uniquement les actions les plus couramment utilisées. Pour obtenir la liste complète, consultez la [Référence des API AWS WAFV2](https://docs.aws.amazon.com/waf/latest/APIReference/API_Operations_AWS_WAFV2.html).
**Topics**
+ [`CreateWebAcl`](wafv2_example_wafv2_CreateWebAcl_section.md)
# Utilisation de `CreateWebAcl` avec une CLI
Les exemples de code suivants illustrent comment utiliser `CreateWebAcl`.
------
#### [ CLI ]
**AWS CLI**
**Pour créer une ACL Web**
La commande `create-web-acl` suivante crée une liste ACL Web pour une utilisation régionale. Les instructions de règle pour la liste ACL Web sont fournies dans un fichier au format JSON.
```
aws wafv2 create-web-acl \
--name TestWebAcl \
--scope REGIONAL \
--default-action Allow={} \
--visibility-config SampledRequestsEnabled=true,CloudWatchMetricsEnabled=true,MetricName=TestWebAclMetrics \
--rules file://waf-rule.json \
--region us-west-2
```
Contenu de file://waf-rule.json :
```
[
{
"Name":"basic-rule",
"Priority":0,
"Statement":{
"AndStatement":{
"Statements":[
{
"ByteMatchStatement":{
"SearchString":"example.com",
"FieldToMatch":{
"SingleHeader":{
"Name":"host"
}
},
"TextTransformations":[
{
"Priority":0,
"Type":"LOWERCASE"
}
],
"PositionalConstraint":"EXACTLY"
}
},
{
"GeoMatchStatement":{
"CountryCodes":[
"US",
"IN"
]
}
}
]
}
},
"Action":{
"Allow":{
}
},
"VisibilityConfig":{
"SampledRequestsEnabled":true,
"CloudWatchMetricsEnabled":true,
"MetricName":"basic-rule"
}
}
]
```
Sortie :
```
{
"Summary":{
"ARN":"arn:aws:wafv2:us-west-2:123456789012:regional/webacl/TestWebAcl/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"Description":"",
"Name":"TestWebAcl",
"LockToken":"2294b3a1-eb60-4aa0-a86f-a3ae04329de9",
"Id":"a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
}
```
Pour plus d'informations, consultez [Managing and Using a Web Access Control List (Web ACL)](https://docs.aws.amazon.com/waf/latest/developerguide/web-acl.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 [CreateWebAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/wafv2/create-web-acl.html)à la section *Référence des AWS CLI commandes*.
------
#### [ PowerShell ]
**Outils pour PowerShell V4**
**Exemple 1 : cette commande crée une nouvelle liste ACL Web nommée « waf-test ». Veuillez noter que selon la documentation de l'API du service, DefaultAction « » est une propriété obligatoire. Par conséquent, la valeur de '- DefaultAction \$1Allow' ' and/or '- DefaultAction \$1Block » doit être spécifiée. Étant donné que «- DefaultAction \$1Allow » et «- DefaultAction \$1Block » ne sont pas les propriétés requises, la valeur « @ \$1\$1 » peut être utilisée comme espace réservé, comme indiqué dans l'exemple ci-dessus.**
```
New-WAF2WebACL -Name "waf-test" -Scope REGIONAL -Region eu-west-1 -VisibilityConfig_CloudWatchMetricsEnabled $true -VisibilityConfig_SampledRequestsEnabled $true -VisibilityConfig_MetricName "waf-test" -Description "Test" -DefaultAction_Allow @{}
```
**Sortie** :
```
ARN : arn:aws:wafv2:eu-west-1:139480602983:regional/webacl/waf-test/19460b3f-db14-4b9a-8e23-a417e1eb007f
Description : Test
Id : 19460b3f-db14-4b9a-8e23-a417e1eb007f
LockToken : 5a0cd5eb-d911-4341-b313-b429e6d6b6ab
Name : waf-test
```
+ Pour plus de détails sur l'API, reportez-vous [CreateWebAcl](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
**Outils pour PowerShell V5**
**Exemple 1 : cette commande crée une nouvelle liste ACL Web nommée « waf-test ». Veuillez noter que selon la documentation de l'API du service, DefaultAction « » est une propriété obligatoire. Par conséquent, la valeur de '- DefaultAction \$1Allow' ' and/or '- DefaultAction \$1Block » doit être spécifiée. Étant donné que «- DefaultAction \$1Allow » et «- DefaultAction \$1Block » ne sont pas les propriétés requises, la valeur « @ \$1\$1 » peut être utilisée comme espace réservé, comme indiqué dans l'exemple ci-dessus.**
```
New-WAF2WebACL -Name "waf-test" -Scope REGIONAL -Region eu-west-1 -VisibilityConfig_CloudWatchMetricsEnabled $true -VisibilityConfig_SampledRequestsEnabled $true -VisibilityConfig_MetricName "waf-test" -Description "Test" -DefaultAction_Allow @{}
```
**Sortie** :
```
ARN : arn:aws:wafv2:eu-west-1:139480602983:regional/webacl/waf-test/19460b3f-db14-4b9a-8e23-a417e1eb007f
Description : Test
Id : 19460b3f-db14-4b9a-8e23-a417e1eb007f
LockToken : 5a0cd5eb-d911-4341-b313-b429e6d6b6ab
Name : waf-test
```
+ Pour plus de détails sur l'API, reportez-vous [CreateWebAcl](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
------