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

# Pencocokan nilai string
<a name="string-value-matching"></a>

Filter pesan dengan mencocokkan nilai string dengan nilai atribut pesan atau nilai properti isi pesan. Nilai-nilai string diapit tanda kutip ganda dalam kebijakan JSON. Anda dapat menggunakan operasi string berikut untuk mencocokkan atribut pesan atau properti isi pesan:

## Pencocokan tepat
<a name="string-exact-matching"></a>

Pencocokan yang tepat terjadi ketika nilai properti kebijakan cocok dengan satu atau beberapa nilai atribut pesan. Untuk atribut `String.Array` tipe, setiap elemen dalam array diperlakukan sebagai string terpisah untuk tujuan pencocokan.

Pertimbangkan properti kebijakan berikut:

```
"customer_interests": ["rugby", "tennis"]
```

Cocok dengan atribut olahpesan berikut:

```
"customer_interests": {"Type": "String", "Value": "rugby"}
```

```
"customer_interests": {"Type": "String", "Value": "tennis"}
```

```
"customer_interests": {"Type": "String.Array", "Value": "[\"rugby\", \"tennis\"]"}
```

Ini juga cocok dengan badan pesan berikut:

```
{
   "customer_interests": "rugby"
}
```

```
{
   "customer_interests": "tennis"
}
```

Namun, itu tidak cocok dengan atribut pesan berikut:

```
"customer_interests": {"Type": "String", "Value": "baseball"}
```

```
"customer_interests": {"Type": "String.Array", "Value": "[\"baseball\"]"}
```

Juga tidak cocok dengan badan pesan berikut:

```
{
   "customer_interests": "baseball"
}
```

## Apa saja tapi tidak cocok
<a name="string-anything-but-matching"></a>

Jika nilai properti kebijakan menyertakan kata kunci`anything-but`, nilai tersebut cocok dengan atribut pesan atau nilai isi pesan apa pun yang *tidak* menyertakan nilai properti kebijakan apa pun. `anything-but`dapat dikombinasikan dengan`"exists": false`. Untuk atribut `String.Array` type, akan cocok jika tidak ada elemen array yang terdaftar di properti policy.

Pertimbangkan properti kebijakan berikut:

```
"customer_interests": [{"anything-but": ["rugby", "tennis"]}]
```

Ini cocok dengan salah satu atribut pesan berikut:

```
"customer_interests": {"Type": "String", "Value": "baseball"}
```

```
"customer_interests": {"Type": "String", "Value": "football"}
```

```
"customer_interests": {"Type": "String.Array", "Value": "[\"rugby\", \"baseball\"]"}
```

Ini juga cocok dengan salah satu badan pesan berikut:

```
{
   "customer_interests": "baseball"
}
```

```
{
   "customer_interests": "football"
}
```

Selain itu, ini cocok dengan atribut pesan berikut (karena berisi nilai yang *bukan* `rugby` atau`tennis`):

```
"customer_interests": {"Type": "String.Array", "Value": "[\"rugby\", \"baseball\"]"}
```

Dan itu juga cocok dengan badan pesan berikut (karena berisi nilai yang bukan `rugby` atau`tennis`):

```
{
   "customer_interests": ["rugby", "baseball"]
}
```

Namun, itu tidak cocok dengan atribut pesan berikut:

```
"customer_interests": {"Type": "String", "Value": "rugby"}
```

```
"customer_interests": {"Type": "String.Array", "Value": "[\"rugby\"]"}
```

Juga tidak cocok dengan badan pesan berikut:

```
{
   "customer_interests": ["rugby"]
}
```

**Menggunakan awalan dengan `anything-but`**

Untuk pencocokan string, Anda juga dapat menggunakan awalan dengan `anything-but` operator. Misalnya, properti kebijakan berikut menyangkal `order-` awalan:

```
"event":[{"anything-but": {"prefix": "order-"}}]
```

Cocok salah satu dari atribut berikut:

```
"event": {"Type": "String", "Value": "data-entry"}
```

```
"event": {"Type": "String", "Value": "order_number"}
```

Ini juga cocok dengan salah satu badan pesan berikut:

```
{
   "event": "data-entry"
}
```

```
{
   "event": "order_number"
}
```

Namun, tidak cocok dengan atribut olahpesan berikut:

```
"event": {"Type": "String", "Value": "order-cancelled"}
```

Juga tidak cocok dengan badan pesan berikut:

```
{
   "event": "order-cancelled"
}
```

**apa pun-kecuali wildcard**

Properti kebijakan berikut menyangkal `*ball` wildcard:

```
"customer_interests" : [{ "anything-but": { "wildcard": "*ball" }}]
```

Ini cocok dengan atribut berikut:

```
{"customer_interests": ["hockey", "rugby", "soccer] }
```

Namun, itu tidak cocok dengan atribut pesan berikut:

```
{"customer_interests": ["baseball", "basketball"] }
```

**apa pun-kecuali akhiran** 

Properti kebijakan berikut menyangkal `-ball`

 akhiran:

```
"customer_interests": [ { "anything-but": { "suffix": "ball" } } ]
```

Ini cocok dengan atribut berikut:

```
{"customer_interests": ["hockey", "rugby", "soccer] }
```

Namun, itu tidak cocok dengan atribut pesan berikut:

```
 {"customer_interests": ["baseball", "basketball"] }
```

## Equals-ignore-case pencocokan
<a name="string-equals-ignore"></a>

Ketika properti kebijakan menyertakan kata kunci`equals-ignore-case`, properti tersebut akan melakukan kecocokan case-insensitive dengan atribut pesan atau nilai properti body apa pun.

Pertimbangkan properti kebijakan berikut:

```
"customer_interests": [{"equals-ignore-case": "tennis"}]
```

Cocok dengan salah satu dari atribut olahpesan berikut:

```
"customer_interests": {"Type": "String", "Value": "TENNIS"}
```

```
"customer_interests": {"Type": "String", "Value": "Tennis"}
```

Ini juga cocok dengan salah satu badan pesan berikut:

```
{
    "customer_interests": "TENNIS"
}
```

```
{
    "customer_interests": "teNnis"
{
```

## Pencocokan alamat IP
<a name="string-address-matching"></a>

Anda dapat menggunakan operator `cidr` untuk memeriksa apakah olahpesan masuk berasal dari alamat IP tertentu atau subnet. 

Pertimbangkan properti kebijakan berikut:

```
"source_ip":[{"cidr": "10.0.0.0/24"}]
```

Cocok dengan salah satu dari atribut olahpesan berikut:

```
"source_ip": {"Type": "String", "Value": "10.0.0.0"}
```

```
"source_ip": {"Type": "String", "Value": "10.0.0.255"}
```

Ini juga cocok dengan salah satu badan pesan berikut:

```
{
   "source_ip": "10.0.0.0"
}
```

```
{
   "source_ip": "10.0.0.255"
}
```

Namun, tidak cocok dengan atribut olahpesan berikut:

```
"source_ip": {"Type": "String", "Value": "10.1.1.0"}
```

Juga tidak cocok dengan badan pesan berikut:

```
{
   "source_ip": "10.1.1.0"
}
```

## Pencocokan prefiks
<a name="string-prefix-matching"></a>

Jika properti kebijakan menyertakan kata kunci`prefix`, properti tersebut cocok dengan atribut pesan atau nilai properti isi apa pun yang dimulai dengan karakter yang ditentukan.

Pertimbangkan properti kebijakan berikut:

```
"customer_interests": [{"prefix": "bas"}]
```

Cocok dengan salah satu dari atribut olahpesan berikut:

```
"customer_interests": {"Type": "String", "Value": "baseball"}
```

```
"customer_interests": {"Type": "String", "Value": "basketball"}
```

Ini juga cocok dengan salah satu badan pesan berikut:

```
{
   "customer_interests": "baseball"
}
```

```
{
   "customer_interests": "basketball"
}
```

Namun, tidak cocok dengan atribut olahpesan berikut:

```
"customer_interests": {"Type": "String", "Value": "rugby"}
```

Juga tidak cocok dengan badan pesan berikut:

```
{
   "customer_interests": "rugby"
}
```

## Pencocokan akhiran
<a name="string-suffix-matching"></a>

Jika properti kebijakan menyertakan kata kunci`suffix`, properti tersebut cocok dengan atribut pesan atau nilai properti isi yang diakhiri dengan karakter yang ditentukan.

Pertimbangkan properti kebijakan berikut:

```
"customer_interests": [{"suffix": "ball"}]
```

Cocok dengan salah satu dari atribut olahpesan berikut:

```
"customer_interests": {"Type": "String", "Value": "baseball"}
```

```
"customer_interests": {"Type": "String", "Value": "basketball"}
```

Ini juga cocok dengan salah satu badan pesan berikut:

```
{
    "customer_interests": "baseball"
}
```

```
{
    "customer_interests": "basketball"
}
```

Namun, tidak cocok dengan atribut olahpesan berikut:

```
"customer_interests": {"Type": "String", "Value": "rugby"}
```

Juga tidak cocok dengan badan pesan berikut:

```
{
    "customer_interests": "rugby"
}
```

## Wildcard
<a name="string-value-wildcard"></a>

 Anda dapat menggunakan karakter wildcard (\*) untuk mencocokkan nilai string dalam pola acara. 

Kebijakan berikut menggunakan karakter wildcard (\*):

```
"customer_interests": [ { "wildcard": "*ball" } ]
```

Ini cocok dengan atribut berikut:

```
{"customer_interests": ["baseball", "basketball"] }
```