**Dokumentasi ini AWS CLI hanya untuk Versi 1. **
Kami mengumumkan akhir dukungan yang akan datang untuk AWS CLI versi 1. Kami menyarankan Anda bermigrasi ke AWS CLI versi 2. Untuk tanggal, detail tambahan, dan informasi tentang cara bermigrasi, lihat [ pengumuman](https://aws.amazon.com/blogs/developer/cli-v1-maintenance-mode-announcement/). Untuk dokumentasi yang terkait dengan Versi 2 AWS CLI, lihat Panduan Pengguna [ Versi 2](https://docs.aws.amazon.com/cli/latest/userguide/).
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
Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan 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
### `asosiasi-web-acl`
Contoh kode berikut menunjukkan cara menggunakan`associate-web-acl`.
**AWS CLI**
**Untuk mengaitkan ACL web dengan sumber daya **
Per `associate-web-acl` intah berikut mengaitkan ACL web, ditentukan oleh web-acl-id, dengan sumber daya, yang ditentukan oleh resource-arn. Sumber daya ARN dapat merujuk ke penyeimbang beban aplikasi atau Gateway API:
```
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 ACL Web ](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 Refer *AWS CLI ensi Perintah*.
### `konfigurasi put-logging`
Contoh kode berikut menunjukkan cara menggunakan`put-logging-configuration`.
**AWS CLI**
**Untuk membuat konfigurasi logging untuk web ACL ARN dengan aliran Kinesis Firehose ARN 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 Refer *AWS CLI ensi Perintah*.
### `perbarui set kecocokan byte`
Contoh kode berikut menunjukkan cara menggunakan`update-byte-match-set`.
**AWS CLI**
**Untuk memperbarui set kecocokan byte **
Per `update-byte-match-set` intah berikut menghapus `ByteMatchTuple` objek (filter) di a`ByteMatchSet`. Karena nil `updates` ainya telah disematkan tanda kutip ganda, Anda harus mengelilingi nilai 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 Kondisi 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 Refer *AWS CLI ensi Perintah*.
### `perbarui-ip-set`
Contoh kode berikut menunjukkan cara menggunakan`update-ip-set`.
**AWS CLI**
**Untuk memperbarui set IP **
Per `update-ip-set` intah berikut memperbarui IPset dengan alamat IPv4 dan menghapus alamat IPv6. Dapatkan nilai untuk `change-token` dengan menjalankan `get-change-token` perintah. Karena nilai untuk pembaruan termasuk tanda kutip ganda yang disematkan, Anda harus mengelilingi nilai 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 `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 Kondisi 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 Refer *AWS CLI ensi Perintah*.
### `perbaruan-aturan`
Contoh kode berikut menunjukkan cara menggunakan`update-rule`.
**AWS CLI**
**Untuk memperbarui aturan **
Per `update-rule` intah berikut menghapus `Predicate` objek dalam aturan. Karena nil `updates` ainya telah disematkan 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 Refer *AWS CLI ensi Perintah*.
### `perbaruan-ukuran-batasan-set`
Contoh kode berikut menunjukkan cara menggunakan`update-size-constraint-set`.
**AWS CLI**
**Untuk memperbarui kumpulan batasan ukuran **
Per `update-size-constraint-set` intah berikut menghapus objek SizeConstraint `(filter) dalam kumpulan batasan ukuran. Karena `updates` nilai 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 Kondisi Batasan Ukuran ](https://docs.aws.amazon.com/waf/latest/developerguide/web-acl-size-conditions.html) di Panduan 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 Refer *AWS CLI ensi Perintah*.
### `perbaruilah set kecocokan injeksi sql-`
Contoh kode berikut menunjukkan cara menggunakan`update-sql-injection-match-set`.
**AWS CLI**
**Untuk memperbarui Set Pencocokan Injeksi SQL **
Per `update-sql-injection-match-set` intah berikut menghapus `SqlInjectionMatchTuple` objek (filter) dalam set pencocokan injeksi SQL. Karena `updates` nilai berisi tanda kutip ganda yang disematkan, Anda harus mengelilingi seluruh nilai dalam tanda kutip tunggal. :
aws waf-pembaruan regional-sql-injeksi-match-set --sql-injeksi-match-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates 'action="Delete”, = {= {type="Query\_string "}, ="URL\_DECODE"} SqlInjectionMatchTuple FieldToMatch TextTransformation
Untuk informasi selengkapnya, lihat Bek [ erja dengan Kondisi 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 Refer *AWS CLI ensi Perintah*.
### `perbarui-web-acl`
Contoh kode berikut menunjukkan cara menggunakan`update-web-acl`.
**AWS CLI**
**Untuk memperbarui ACL web **
Per `update-web-acl` intah berikut menghapus `ActivatedRule` objek dalam WebACL. Karena `updates` nilai 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 ACL Web ](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 Refer *AWS CLI ensi Perintah*.
### `perbarui-xss-match-set`
Contoh kode berikut menunjukkan cara menggunakan`update-xss-match-set`.
**AWS CLI**
**Untuk memperbarui XSSMatchSet **
Per `update-xss-match-set` intah berikut menghapus `XssMatchTuple` objek (filter) dalam. `XssMatchSet` Karena `updates` nilai 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 Cross-site Kondisi Pencocokan Skrip ](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 Refer *AWS CLI ensi Perintah*.