

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# AWS WAF Classic Regional contoh menggunakan AWS CLI
<a name="cli_waf-regional_code_examples"></a>

Contoh kode berikut menunjukkan cara melakukan tindakan dan mengimplementasikan skenario umum dengan menggunakan AWS Command Line Interface with AWS WAF Classic Regional.

*Tindakan* merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

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

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

### `associate-web-acl`
<a name="waf-regional_AssociateWebAcl_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`associate-web-acl`.

**AWS CLI**  
**Untuk mengaitkan ACL web dengan sumber daya**  
`associate-web-acl`Perintah berikut mengaitkan ACL web, ditentukan oleh, dengan sumber daya web-acl-id, yang ditentukan oleh sumber daya-arn. Sumber daya ARN dapat merujuk ke penyeimbang beban aplikasi atau API Gateway:  

```
aws waf-regional associate-web-acl \
    --web-acl-id a123fae4-b567-8e90-1234-5ab67ac8ca90 \
    --resource-arn 12cs345-67cd-890b-1cd2-c3a4567d89f1
```
Untuk informasi selengkapnya, lihat [Bekerja dengan Web ACLs](https://docs.aws.amazon.com/waf/latest/developerguide/web-acl-working-with.html) di *Panduan Pengembang AWS WAF*.  
+  Untuk detail API, lihat [AssociateWebAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf-regional/associate-web-acl.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`put-logging-configuration`.

**AWS CLI**  
**Untuk membuat konfigurasi logging untuk web ACL ARN dengan Arn Kinesis Firehose stream yang ditentukan**  
`put-logging-configuration`Contoh berikut menampilkan konfigurasi logging untuk WAF dengan ALB/APIGateway di Region`us-east-1`.  

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

```
{
    "LoggingConfiguration": {
        "ResourceArn": "arn:aws:waf-regional:us-east-1:123456789012:webacl/3bffd3ed-fa2e-445e-869f-a6a7cf153fd3",
        "LogDestinationConfigs": [
            "arn:aws:firehose:us-east-1:123456789012:deliverystream/aws-waf-logs-firehose-stream"
        ]
    }
}
```
+  Untuk detail API, lihat [PutLoggingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf-regional/put-logging-configuration.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`update-byte-match-set`.

**AWS CLI**  
**Untuk memperbarui set kecocokan byte**  
`update-byte-match-set`Perintah berikut menghapus `ByteMatchTuple` objek (filter) dalam file. `ByteMatchSet` Karena `updates` nilainya telah menyematkan tanda kutip ganda, Anda harus mengelilingi nilainya dengan tanda kutip tunggal.  

```
aws waf-regional 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"}'
```
Untuk informasi selengkapnya, lihat [Bekerja dengan Ketentuan Pencocokan String](https://docs.aws.amazon.com/waf/latest/developerguide/web-acl-string-conditions.html) di *Panduan Pengembang AWS WAF*.  
+  Untuk detail API, lihat [UpdateByteMatchSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf-regional/update-byte-match-set.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`update-ip-set`.

**AWS CLI**  
**Untuk memperbarui set IP**  
`update-ip-set`Perintah berikut memperbarui IPSet dengan IPv4 alamat dan menghapus IPv6 alamat. Dapatkan nilainya `change-token` dengan menjalankan `get-change-token` perintah. Karena nilai untuk pembaruan menyertakan tanda kutip ganda yang disematkan, Anda harus mengelilingi nilainya dengan tanda kutip tunggal.  

```
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"}'
```
Atau Anda dapat menggunakan file JSON untuk menentukan input. Contoh:  

```
aws waf-regional update-ip-set \
    --ip-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 \
    --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1  \
    --updates file://change.json
```
Isi dari `change.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"
        }
    }
]
```
Untuk informasi selengkapnya, lihat [Bekerja dengan Ketentuan Pencocokan IP](https://docs.aws.amazon.com/waf/latest/developerguide/web-acl-ip-conditions.html) di *Panduan Pengembang AWS WAF*.  
+  Untuk detail API, lihat [UpdateIpSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf-regional/update-ip-set.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`update-rule`.

**AWS CLI**  
**Untuk memperbarui aturan**  
`update-rule`Perintah berikut menghapus `Predicate` objek dalam aturan. Karena `updates` nilainya telah menyematkan tanda kutip ganda, Anda harus mengelilingi seluruh nilai dengan tanda kutip tunggal.  

```
aws waf-regional 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"}'
```
Untuk informasi selengkapnya, lihat [Bekerja dengan Aturan](https://docs.aws.amazon.com/waf/latest/developerguide/web-acl-rules.html) di *Panduan Pengembang AWS WAF*.  
+  Untuk detail API, lihat [UpdateRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf-regional/update-rule.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`update-size-constraint-set`.

**AWS CLI**  
**Untuk memperbarui set batasan ukuran**  
`update-size-constraint-set`Perintah berikut menghapus objek SizeConstraint `(filter) dalam set batasan ukuran. Karena `updates` nilainya berisi tanda kutip ganda yang disematkan, Anda harus mengelilingi seluruh nilai dengan tanda kutip tunggal.  

```
aws waf-regional 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}'
```
Untuk informasi selengkapnya, lihat [Bekerja dengan Ketentuan Kendala Ukuran di Panduan](https://docs.aws.amazon.com/waf/latest/developerguide/web-acl-size-conditions.html) Pengembang *AWS WAF*.  
+  Untuk detail API, lihat [UpdateSizeConstraintSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf-regional/update-size-constraint-set.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`update-sql-injection-match-set`.

**AWS CLI**  
**Untuk memperbarui SQL Injection Match Set**  
`update-sql-injection-match-set`Perintah berikut menghapus `SqlInjectionMatchTuple` objek (filter) dalam set kecocokan injeksi SQL. Karena `updates` nilainya berisi tanda kutip ganda yang disematkan, Anda harus mengelilingi seluruh nilai dalam tanda kutip tunggal. :  
aws waf-regional update-sql-injection-match -set -- sql-injection-match-set -id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --update 'action="Delete”, = \$1= \$1type="Query\$1string "\$1, ="URL\$1DECODE"\$1 'SqlInjectionMatchTupleFieldToMatchTextTransformation  
Untuk informasi selengkapnya, lihat [Bekerja dengan Ketentuan Pencocokan Injeksi SQL](https://docs.aws.amazon.com/waf/latest/developerguide/web-acl-sql-conditions.html) di Panduan *Pengembang AWS WAF*.  
+  Untuk detail API, lihat [UpdateSqlInjectionMatchSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf-regional/update-sql-injection-match-set.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`update-web-acl`.

**AWS CLI**  
**Untuk memperbarui ACL web**  
`update-web-acl`Perintah berikut menghapus `ActivatedRule` objek di WebACL. Karena `updates` nilainya berisi tanda kutip ganda yang disematkan, Anda harus mengelilingi seluruh nilai dalam tanda kutip tunggal.  

```
aws waf-regional update-web-acl \
    --web-acl-id a123fae4-b567-8e90-1234-5ab67ac8ca90 \
    --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 \
    --updates Action="DELETE",ActivatedRule='{Priority=1,RuleId="WAFRule-1-Example",Action={Type="ALLOW"},Type="ALLOW"}'
```
Untuk informasi selengkapnya, lihat [Bekerja dengan Web ACLs](https://docs.aws.amazon.com/waf/latest/developerguide/web-acl-working-with.html) di *Panduan Pengembang AWS WAF*.  
+  Untuk detail API, lihat [UpdateWebAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf-regional/update-web-acl.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`update-xss-match-set`.

**AWS CLI**  
**Untuk memperbarui XSSMatch Set**  
`update-xss-match-set`Perintah berikut menghapus `XssMatchTuple` objek (filter) dalam file`XssMatchSet`. Karena `updates` nilainya berisi tanda kutip ganda yang disematkan, Anda harus mengelilingi seluruh nilai dengan tanda kutip tunggal.  

```
aws waf-regional 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"}'
```
Untuk informasi selengkapnya, lihat [Bekerja dengan Ketentuan Pencocokan Skrip Lintas Situs](https://docs.aws.amazon.com/waf/latest/developerguide/web-acl-xss-conditions.html) di Panduan Pengembang *AWS WAF*.  
+  Untuk detail API, lihat [UpdateXssMatchSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf-regional/update-xss-match-set.html)di *Referensi AWS CLI Perintah*. 