Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples).
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Ejemplos de código para AWS WAFV2 usar AWS SDKs
Los siguientes ejemplos de código muestran cómo usarlo AWS WAFV2 con un kit de desarrollo de AWS software (SDK).
Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
**Más recursos**
+ **[AWS WAFV2 Guía para desarrolladores](https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html)**: más información sobre AWS WAFV2.
+ **[AWS WAFV2 Referencia de la API](https://docs.aws.amazon.com/waf/latest/APIReference/API_Operations_AWS_WAFV2.html)**: detalles sobre todas AWS WAFV2 las acciones disponibles.
+ **[AWS Centro para desarrolladores](https://aws.amazon.com/developer/code-examples/?awsf.sdk-code-examples-product=product%23)**: ejemplos de código que puedes filtrar por categoría o por búsqueda de texto completo.
+ **[AWS Ejemplos de SDK](https://github.com/awsdocs/aws-doc-sdk-examples)**: GitHub repositorio con código completo en los idiomas preferidos. Incluye instrucciones para configurar y ejecutar el código.
**Contents**
+ [Conceptos básicos](wafv2_code_examples_basics.md)
+ [Acciones](wafv2_code_examples_actions.md)
+ [`CreateWebAcl`](wafv2_example_wafv2_CreateWebAcl_section.md)
# Ejemplos básicos de uso AWS WAFV2 AWS SDKs
Los siguientes ejemplos de código muestran cómo utilizar los conceptos básicos de AWS WAFV2 with AWS SDKs.
**Contents**
+ [Acciones](wafv2_code_examples_actions.md)
+ [`CreateWebAcl`](wafv2_example_wafv2_CreateWebAcl_section.md)
# Acciones para AWS WAFV2 usar AWS SDKs
Los siguientes ejemplos de código muestran cómo realizar AWS WAFV2 acciones individuales con AWS SDKs. Cada ejemplo incluye un enlace a GitHub, donde puede encontrar instrucciones para configurar y ejecutar el código.
Los siguientes ejemplos incluyen solo las acciones que se utilizan con mayor frecuencia. Para ver una lista completa, consulte la [Referencia de la API de AWS WAFV2](https://docs.aws.amazon.com/waf/latest/APIReference/API_Operations_AWS_WAFV2.html).
**Topics**
+ [`CreateWebAcl`](wafv2_example_wafv2_CreateWebAcl_section.md)
# Utilizar `CreateWebAcl` con una CLI
Los siguientes ejemplos de código muestran cómo utilizar `CreateWebAcl`.
------
#### [ CLI ]
**AWS CLI**
**Para crear una ACL web**
El siguiente comando `create-web-acl` crea una ACL web para uso regional. Las instrucciones de reglas de la ACL web se proporcionan en un archivo con formato 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
```
Contenido del archivo //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"
}
}
]
```
Salida:
```
{
"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 obtener más información, consulte [Administración y uso de una lista de control de acceso a la web (ACL web)](https://docs.aws.amazon.com/waf/latest/developerguide/web-acl.html) en la *Guía avanzada para desarrolladores de AWS WAF, AWS Firewall Manager y AWS Shield*.
+ Para obtener más información sobre la API, consulte [CreateWebAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/wafv2/create-web-acl.html)la *Referencia de AWS CLI comandos*.
------
#### [ PowerShell ]
**Herramientas para la PowerShell versión 4**
**Ejemplo 1: Este comando crea una nueva ACL web denominada “waf-test”. Tenga en cuenta que, según la documentación de la API de servicio, DefaultAction «» es una propiedad obligatoria. Por lo tanto, se debe especificar el valor de '- DefaultAction and/or \$1Allow' '- DefaultAction \$1Block'. Como '- DefaultAction \$1Allow' y '- DefaultAction \$1Block' no son las propiedades obligatorias, el valor '@ \$1\$1 'podría usarse como marcador de posición, como se muestra en el ejemplo anterior.**
```
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 @{}
```
**Salida:**
```
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 obtener más información sobre la API, consulte la referencia del cmdlet (V4 [CreateWebAcl](https://docs.aws.amazon.com/powershell/v4/reference)).Herramientas de AWS para PowerShell *
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: Este comando crea una nueva ACL web denominada “waf-test”. Tenga en cuenta que, según la documentación de la API de servicio, DefaultAction «» es una propiedad obligatoria. Por lo tanto, se debe especificar el valor de '- DefaultAction and/or \$1Allow' '- DefaultAction \$1Block'. Como '- DefaultAction \$1Allow' y '- DefaultAction \$1Block' no son las propiedades obligatorias, el valor '@ \$1\$1 'podría usarse como marcador de posición, como se muestra en el ejemplo anterior.**
```
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 @{}
```
**Salida:**
```
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 obtener más información sobre la API, consulte la referencia del cmdlet (V5 [CreateWebAcl](https://docs.aws.amazon.com/powershell/v5/reference)).Herramientas de AWS para PowerShell *
------