

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.

# AWS WAF Classic ejemplos que utilizan AWS CLI
<a name="cli_2_waf_code_examples"></a>

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso del AWS Command Line Interface with AWS WAF Classic.

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.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

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

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

### `put-logging-configuration`
<a name="waf_PutLoggingConfiguration_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `put-logging-configuration`.

**AWS CLI**  
**Para crear una configuración de registro para el ARN de ACL web con el ARN de flujo de Kinesis Firehose especificado**  
En el siguiente `put-logging-configuration` ejemplo, se muestra el registro de la configuración de WAF con 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=[]
```
Salida:  

```
{
    "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"
        ]
    }
}
```
+  Para obtener más información sobre la API, consulte [PutLoggingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf/put-logging-configuration.html)la *Referencia de AWS CLI comandos*. 

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

En el siguiente ejemplo de código, se muestra cómo utilizar `update-byte-match-set`.

**AWS CLI**  
**Para actualizar un conjunto de coincidencias de bytes**  
El siguiente `update-byte-match-set` comando elimina un ByteMatchTuple objeto (filtro) de 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"}
```
Para obtener más información, consulte Trabajar con condiciones de coincidencia de cadena en la *Guía para desarrolladores de AWS WAF*.  
+  Para obtener más información sobre la API, consulte [UpdateByteMatchSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf/update-byte-match-set.html)la *Referencia de AWS CLI comandos*. 

### `update-ip-set`
<a name="waf_UpdateIpSet_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `update-ip-set`.

**AWS CLI**  
**Para actualizar un conjunto de IP**  
El siguiente `update-ip-set` comando actualiza un IPSet con una IPv4 dirección y elimina una IPv6 dirección:  

```
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"}
```
Como alternativa, puede utilizar un archivo JSON para especificar la entrada. Por ejemplo:  

```
aws waf update-ip-set --ip-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1  --updates file://change.json
```
Este es el contenido del archivo 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"
}
}
]
```
Para obtener más información, consulte Trabajar con condiciones de coincidencia de IP en la *Guía para desarrolladores de AWS WAF*.  
+  Para obtener más información sobre la API, consulte [UpdateIpSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf/update-ip-set.html)la *Referencia de AWS CLI comandos*. 

### `update-rule`
<a name="waf_UpdateRule_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `update-rule`.

**AWS CLI**  
**Para actualizar una regla**  
El siguiente comando `update-rule` elimina un objeto Predicate de una regla:  

```
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"}
```
Para obtener más información, consulte Trabajar con reglas en la *Guía para desarrolladores de AWS WAF*.  
+  Para obtener más información sobre la API, consulte [UpdateRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf/update-rule.html)la *Referencia de AWS CLI comandos*. 

### `update-size-constraint-set`
<a name="waf_UpdateSizeConstraintSet_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `update-size-constraint-set`.

**AWS CLI**  
**Para actualizar un conjunto de restricciones de tamaño**  
El siguiente `update-size-constraint-set` comando elimina un SizeConstraint objeto (filtros) de un conjunto de restricciones de tamaño:  

```
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}
```
Para obtener más información, consulte Trabajar con condiciones de restricción de tamaño en la *Guía para desarrolladores de AWS WAF*.  
+  Para obtener más información sobre la API, consulte la Referencia [UpdateSizeConstraintSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf/update-size-constraint-set.html)de *AWS CLI comandos*. 

### `update-sql-injection-match-set`
<a name="waf_UpdateSqlInjectionMatchSet_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `update-sql-injection-match-set`.

**AWS CLI**  
**Para actualizar un conjunto de coincidencias de inyección de código SQL**  
El siguiente `update-sql-injection-match-set` comando elimina un SqlInjectionMatchTuple objeto (filtros) de un conjunto de coincidencias por inyección 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"}
```
Para obtener más información, consulte Trabajar con condiciones de coincidencia de inyección de código SQL en la *Guía para desarrolladores de AWS WAF*.  
+  Para obtener más información sobre la API, consulte [UpdateSqlInjectionMatchSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf/update-sql-injection-match-set.html)la *Referencia de AWS CLI comandos*. 

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

En el siguiente ejemplo de código, se muestra cómo utilizar `update-web-acl`.

**AWS CLI**  
**Para actualizar una ACL web**  
El siguiente comando `update-web-acl` elimina un objeto `ActivatedRule` de una WebACL.  
aws waf update-web-acl -- web-acl-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates action="Delete», =' \$1Priority=1, =» -1-Example», Action= \$1type="Allow "\$1, type="Regular"\$1 'ActivatedRuleRuleIdWAFRule  
Salida:  

```
{
    "ChangeToken": "12cs345-67cd-890b-1cd2-c3a4567d89f1"
}
```
Para obtener más información, consulte [Trabajar con la Web ACLs](https://docs.aws.amazon.com/waf/latest/developerguide/classic-web-acl-working-with.html) en la *Guía para desarrolladores avanzados de AWS WAF, AWS Firewall Manager y AWS Shield*.  
+  Para obtener más información sobre la API, consulte [UpdateWebAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf/update-web-acl.html)la *Referencia de AWS CLI comandos*. 

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

En el siguiente ejemplo de código, se muestra cómo utilizar `update-xss-match-set`.

**AWS CLI**  
**Para actualizar un XSSMatch conjunto**  
El siguiente `update-xss-match-set` comando elimina un XssMatchTuple objeto (filtra) en 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"}
```
Para obtener más información, consulte Trabajar con condiciones de coincidencia de scripting entre sitios en la *Guía para desarrolladores de AWS WAF*.  
+  Para obtener más información sobre la API, consulte [UpdateXssMatchSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf/update-xss-match-set.html)la *Referencia de AWS CLI comandos*. 