Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Exemplos de código para AWS WAFV2 usar AWS SDKs
Os exemplos de código a seguir mostram como usar AWS WAFV2 com um kit de desenvolvimento de AWS software (SDK).
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
**Mais atributos**
+ **[AWS WAFV2 Guia do desenvolvedor](https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html)** — Mais informações sobre AWS WAFV2.
+ **[AWS WAFV2 Referência da API](https://docs.aws.amazon.com/waf/latest/APIReference/API_Operations_AWS_WAFV2.html)** — Detalhes sobre todas as AWS WAFV2 ações disponíveis.
+ **[AWS Centro do desenvolvedor](https://aws.amazon.com/developer/code-examples/?awsf.sdk-code-examples-product=product%23)** — exemplos de código que você pode filtrar por categoria ou pesquisa de texto completo.
+ **[AWS Exemplos de SDK](https://github.com/awsdocs/aws-doc-sdk-examples)** — GitHub repositório com código completo nos idiomas preferidos. Inclui instruções para configurar e executar o código.
**Contents**
+ [Conceitos básicos](wafv2_code_examples_basics.md)
+ [Ações](wafv2_code_examples_actions.md)
+ [`CreateWebAcl`](wafv2_example_wafv2_CreateWebAcl_section.md)
# Exemplos básicos de AWS WAFV2 uso AWS SDKs
Os exemplos de código a seguir mostram como usar o básico do AWS WAFV2 with AWS SDKs.
**Contents**
+ [Ações](wafv2_code_examples_actions.md)
+ [`CreateWebAcl`](wafv2_example_wafv2_CreateWebAcl_section.md)
# Ações para AWS WAFV2 usar AWS SDKs
Os exemplos de código a seguir demonstram como realizar AWS WAFV2 ações individuais com AWS SDKs. Cada exemplo inclui um link para GitHub, onde você pode encontrar instruções para configurar e executar o código.
Os exemplos a seguir incluem apenas as ações mais utilizadas. Para obter uma lista completa, consulte a [Referência de APIs do AWS WAFV2](https://docs.aws.amazon.com/waf/latest/APIReference/API_Operations_AWS_WAFV2.html).
**Topics**
+ [`CreateWebAcl`](wafv2_example_wafv2_CreateWebAcl_section.md)
# Usar `CreateWebAcl` com uma CLI
Os exemplos de código a seguir mostram como usar o `CreateWebAcl`.
------
#### [ CLI ]
**AWS CLI**
**Para criar uma ACL da web**
O comando `create-web-acl` a seguir cria uma ACL da web para uso regional. As instruções de regra para a ACL da web são fornecidas em um arquivo formatado em 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
```
Conteúdo 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"
}
}
]
```
Saída:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Gerenciando e usando uma lista de controle de acesso à Web (Web ACL)](https://docs.aws.amazon.com/waf/latest/developerguide/web-acl.html) no *AWS WAF, no AWS Firewall Manager e no AWS Shield Advanced Developer Guide*.
+ Para obter detalhes da API, consulte [CreateWebAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/wafv2/create-web-acl.html)em *Referência de AWS CLI Comandos*.
------
#### [ PowerShell ]
**Ferramentas para PowerShell V4**
**Exemplo 1: esse comando cria uma ACL da web chamada “waf-test”. Observe que, de acordo com a documentação da API de serviço, 'DefaultAction' é uma propriedade obrigatória. Portanto, o valor de '- DefaultAction \$1Allow' '- and/or DefaultAction \$1Block' deve ser especificado. Como '- DefaultAction \$1Allow' e '- DefaultAction \$1Block 'não são as propriedades obrigatórias, o valor '@ \$1\$1' pode ser usado como espaço reservado, conforme mostrado no exemplo acima.**
```
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 @{}
```
**Saída**:
```
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
```
+ Para obter detalhes da API, consulte [CreateWebAcl](https://docs.aws.amazon.com/powershell/v4/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V4)*.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse comando cria uma ACL da web chamada “waf-test”. Observe que, de acordo com a documentação da API de serviço, 'DefaultAction' é uma propriedade obrigatória. Portanto, o valor de '- DefaultAction \$1Allow' '- and/or DefaultAction \$1Block' deve ser especificado. Como '- DefaultAction \$1Allow' e '- DefaultAction \$1Block 'não são as propriedades obrigatórias, o valor '@ \$1\$1' pode ser usado como espaço reservado, conforme mostrado no exemplo acima.**
```
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 @{}
```
**Saída**:
```
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
```
+ Para obter detalhes da API, consulte [CreateWebAcl](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
------