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

# Referensi sintaks kueri pencarian untuk Resource Explorer
<a name="using-search-query-syntax"></a>

Penjelajah Sumber Daya AWS membantu Anda menemukan AWS sumber daya individu di Anda Akun AWS. Untuk membantu Anda menemukan sumber daya yang tepat yang Anda cari, Resource Explorer menerima string kueri penelusuran yang mendukung sintaks yang dijelaskan dalam topik ini. Misalnya kueri yang menunjukkan cara menggunakan fitur yang dijelaskan di sini, lihat[Contoh permintaan pencarian Resource Explorer](using-search-query-examples.md).

**catatan**  
Pada saat ini, tag yang dilampirkan ke sumber daya AWS Identity and Access Management (IAM), seperti peran atau pengguna, tidak diindeks.

## Cara kerja kueri di Resource Explorer
<a name="query-background"></a>

Kueri penelusuran selalu menggunakan tampilan. Jika Anda tidak menentukannya secara eksplisit, Resource Explorer menggunakan tampilan yang ditetapkan sebagai default untuk tempat Wilayah AWS Anda bekerja. 

Tampilan menentukan sumber daya mana yang tersedia untuk Anda kueri. Anda dapat membuat tampilan berbeda yang masing-masing mengembalikan kumpulan sumber daya yang berbeda. 

Misalnya, Anda dapat membuat tampilan yang hanya menyertakan sumber daya yang ditandai dengan kunci `Environment` dan nilainya`Production`. Kemudian, Anda dapat memilih untuk memberikan akses untuk tampilan itu hanya kepada pengguna yang memiliki alasan bisnis untuk melihat sumber daya tersebut. Tampilan terpisah yang mencakup sumber daya `Alpha` atau `Beta` lingkungan dapat diakses oleh pengguna yang berbeda yang perlu melihat sumber daya tersebut. Untuk informasi tentang mengontrol siapa yang mendapatkan akses ke tampilan mana, lihat[Memberikan akses ke tampilan Resource Explorer untuk pencarian](manage-views-grant-access.md).

## Sintaks string kueri
<a name="query-syntax"></a>

Bagian ini memberikan informasi tentang aspek dasar sintaks kueri, filter, dan operator filter.

### Hal-hal mendasar
<a name="query-syntax-basics"></a>

Pada dasarnya, a `QueryString` adalah satu set kata kunci teks bentuk bebas yang secara *implisit bergabung dengan operator* logis. `OR` Pisahkan setiap kata kunci dari yang lain dengan menggunakan spasi, seperti yang ditunjukkan pada contoh berikut:

`ec2 billing test gamma`

Resource Explorer mengevaluasi daftar kata kunci ini untuk berarti:

`ec2 OR billing OR test OR gamma`

Resource Explorer mengurutkan hasil berdasarkan relevansi, memberikan preferensi yang lebih tinggi ke sumber daya yang cocok dengan jumlah istilah pencarian yang lebih banyak. Sumber daya yang tidak cocok dengan satu atau beberapa persyaratan tidak dikecualikan dari hasil. Namun, Resource Explorer menganggapnya memiliki relevansi yang lebih rendah dan mendorongnya lebih jauh ke bawah dalam hasil pencarian.

Jika Anda menentukan string kosong untuk `QueryString` parameter, kueri Anda mengembalikan 1.000 sumber daya pertama yang tersedia melalui tampilan yang digunakan untuk operasi. Jumlah maksimum sumber daya yang dapat dikembalikan oleh kueri apa pun adalah 1.000.

**catatan**  
AWS berhak memperbarui logika pencocokan dan algoritma relevansi untuk mengevaluasi kata kunci teks bentuk bebas sehingga kami dapat memberikan hasil yang paling relevan kepada pelanggan. Oleh karena itu, hasil yang dikembalikan untuk kueri yang sama menggunakan kata kunci teks bentuk bebas mungkin berubah seiring waktu. Jika Anda memerlukan hasil yang lebih deterministik, kami sarankan Anda menggunakan filter. Logika pencocokan filter tidak berubah seiring waktu.

### Filter
<a name="query-syntax-filters"></a>

Anda dapat membatasi hasil kueri Anda lebih ketat dengan memasukkan ***filter***. Tidak seperti kata kunci teks, filter dievaluasi dalam kueri dengan **AND**operator. Misalnya, pertimbangkan kueri berikut yang terdiri dari dua kata kunci bentuk bebas dan dua filter:

```
test instance service:EC2 region:us-west-2
```

Kueri ini dievaluasi sebagai berikut:

```
( test OR instance ) AND service:EC2 AND region:us-west-2
```

Filter selalu dievaluasi menggunakan operator **AND**logis. Jika sumber daya tidak cocok dengan filter, sumber daya tersebut tidak disertakan dalam hasil. Hasil kueri contoh mencakup sumber daya apa pun yang terkait dengan Amazon EC2 dan berada di AS Barat (Oregon) Wilayah AWS dan memiliki setidaknya satu kata kunci yang dilampirkan dalam beberapa cara.

**catatan**  
Karena implisit`AND`, Anda dapat berhasil menggunakan hanya satu filter untuk atribut yang hanya dapat memiliki satu nilai yang terkait dengan sumber daya. Misalnya, sumber daya hanya dapat menjadi bagian dari satu Wilayah AWS. Oleh karena itu, query berikut tidak mengembalikan hasil.  

```
region:us-east-1 region:us-west-1
```
Batasan ini ***tidak*** berlaku untuk filter untuk atribut yang dapat memiliki beberapa nilai pada saat yang sama, seperti`tag:`,`tag.key:`, dan`tag.value:`.

Tabel berikut mencantumkan nama filter yang tersedia yang dapat Anda gunakan dalam kueri penelusuran Resource Explorer.


| Filter nama | Deskripsi dan contoh | 
| --- | --- | 
|  `accountid:`  |   Akun AWS Yang memiliki sumber daya. Resource Explorer termasuk dalam hasil hanya sumber daya yang dimiliki oleh akun yang ditentukan. `accountid:123456789012`  | 
|  `application:`  |  Filter ini memungkinkan Anda untuk mencari sumber daya dengan kunci `awsApplication` tag dan nilai grup sumber daya. Anda dapat mencari berdasarkan nama aplikasi atau grup sumber daya aplikasiARN. `application:MyApplicationName` `application:arn:aws:resource-groups:us-east-1:123456789012:group/MyApplicationName/123456789abced` `arn:aws:resource-groups:us-east-1:123456789012:group/MyApplicationName/123456789abced`  Untuk menggunakan filter ini, tampilan Anda harus memiliki akses ke data penandaan.   | 
|  `id:`  |  Pengidentifikasi sumber daya individu, dinyatakan sebagai [nama sumber daya Amazon (ARN)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html). `id:arn:aws:license-manager:us-east-1:123456789012:license-configuration:lic-ecbd5574fd92cb0d312baea26EXAMPLE`  | 
|  `region:`  |  Di Wilayah AWS mana sumber daya berada. Resource Explorer termasuk dalam hasil hanya sumber daya yang berada di ditentukan Wilayah AWS. `region:us-east-1`  Mengetik hanya kode Wilayah (tanpa filter, seperti`us-east-1`) tidak mengembalikan hasil yang sama seperti`region:us-east-1`. Hasil ini karena, sebagai kata kunci teks bentuk bebas yang bukan filter, kode Wilayah dipecah menjadi potongan-potongan individualnya. Misalnya, `us-east-1` dicari sebagai`us`,`east`, dan`1`. Perincian menjadi komponen ini tidak terjadi saat Anda menggunakan `region:` awalan.   | 
|  `region:global`  |  Kasus khusus untuk `region:` filter yang dapat Anda gunakan untuk menemukan sumber daya yang tidak terkait dengan individu Wilayah AWS tetapi dianggap cakupan global. `region:global`  Mengetik hanya kata kunci `global` tidak mengembalikan hasil yang sama `region:global` karena kata literal “global” tidak melekat pada sumber daya global. Mengetik `global` sebagai kata kunci hanya mengembalikan sumber daya yang memiliki string literal yang terkait dengan sumber daya.   | 
|  `resourcetype:`  |  Jenis sumber daya dalam `service:type` notasi. Resource Explorer termasuk dalam hasil hanya sumber daya dari jenis yang ditentukan. `resourcetype:ec2:instance`  | 
|  `resourcetype.supports:`  |  Filter ini memungkinkan Anda untuk mencari sumber daya yang mendukung tag. `tags`adalah satu-satunya nilai yang didukung. Resource Explorer menyertakan dalam hasil hanya sumber daya yang dapat diberi tag.  `resourcetype.supports:tags`  | 
|  `service:`  |   Layanan AWS Yang terkait dengan jenis sumber daya. Resource Explorer termasuk dalam hasil hanya sumber daya yang dibuat dan dikelola oleh layanan yang ditentukan. `service:ec2`  | 
|  `tag:`  |  Sebuah pasangan kunci tag/nilai dinyatakan sebagai. `<key>=<value>` Resource Explorer menyertakan dalam hasil hanya sumber daya yang memiliki tag dengan kunci yang cocok dan nilai yang ditentukan. `tag:environment=production`  | 
|  `tag:all`  |  Kasus khusus `tag:` filter yang memungkinkan Anda mencari sumber daya yang memiliki satu atau beberapa tag buatan pengguna yang dilampirkan, meskipun jenis sumber daya tidak didukung di Resource Explorer.   Sumber daya dengan tag *AWS yang dibuat layanan* masih muncul di hasil untuk filter ini.   | 
|  `tag:none`  |  Kasus khusus `tag:` filter yang memungkinkan Anda mencari sumber daya apa pun yang tidak memiliki tag yang dibuat pengguna.  Sumber daya dengan tag *AWS yang dibuat layanan* masih muncul di hasil untuk filter ini.   | 
|  `tag.key:`  |  Sebuah kunci tag. Resource Explorer menyertakan dalam hasil hanya sumber daya yang memiliki tag dengan kunci yang cocok, terlepas dari nilainya. `tag.key:environment`  | 
|  `tag.value:`  |  Nilai tag. Resource Explorer menyertakan dalam hasil hanya sumber daya yang memiliki tag dengan nilai yang cocok, terlepas dari nama kuncinya. `tag.value:production`  | 

### Operator filter
<a name="query-syntax-operators"></a>

Anda dapat memodifikasi kata kunci dan filter dengan menyertakan salah satu operator yang ditampilkan dalam tabel berikut sebagai bagian dari string.


| Operator | Deskripsi dan contoh | 
| --- | --- | 
|  `"multiple word phrase"` atau "*hyphenated-phrase*"  |  Kelilingi frase multi-kata yang harus diperlakukan sebagai kata kunci tunggal dengan tanda kutip ganda karakter (). `" "` Resource Explorer hanya mencakup sumber daya yang cocok dengan seluruh frasa, dengan semua kata bersama-sama, dan dalam urutan yang ditentukan. Jika Anda tidak menggunakan tanda kutip ganda, Resource Explorer memecah frasa menjadi komponennya dengan spasi atau tanda hubung, dan menyertakan sumber daya yang cocok dengan masing-masing komponen, meskipun tidak bersama-sama atau dalam urutan yang berbeda. Kutipan harus ada di sekitar segalanya setelah operator. `"This matches only resources with the whole sentence."` `This matches resources with any of the words.` `"us-east-1"`— hanya cocok dengan sumber daya yang terkait dengan Wilayah yang tepat itu. `us-east-1`— cocok dengan sumber daya apa pun yang berisi “kami” atau “timur” atau “1". `-tag:"environment=production"`   | 
|  `keyword*`  |   Pencocokan wildcard awalan. Anda dapat menempatkan karakter wildcard (tanda bintang`*`) hanya di akhir string. Resource Explorer menyertakan dalam hasil hanya sumber daya dengan nilai yang dimulai dengan teks awalan sebelum. `*` Contoh berikut cocok dengan semua Wilayah AWS yang dimulai`us-east`. `region:us-east*`  Pencarian terpadu secara otomatis menyisipkan operator karakter wildcard (`*`) di akhir kata kunci pertama dalam string. Ini berarti bahwa hasil pencarian terpadu menyertakan sumber daya yang cocok dengan string apa pun yang dimulai dengan kata kunci yang ditentukan. Pencarian yang dilakukan oleh kotak teks **Kueri** pada halaman [pencarian Sumber daya](https://console.aws.amazon.com/resource-explorer/home#/explorer) di konsol Resource Explorer ***tidak*** secara otomatis menambahkan karakter wildcard. Anda dapat memasukkan secara `*` manual setelah istilah apa pun dalam string pencarian.   | 
|  `-keyword`  |  `Not`operator. Anda dapat menempatkan tanda hubung (`-`) di awal kata kunci atau filter untuk membalikkan hasil pencarian. Resource Explorer ***mengecualikan*** dari hasil sumber daya apa pun yang cocok dengan kata kunci atau filter yang mengikuti operator ini. Contoh berikut menyebabkan semua sumber daya yang terkait dengan EC2 layanan Amazon dikecualikan dari hasil. `-service:ec2`  Jika Anda menggunakan AWS CLI `search` perintah dan nilai `--query-string` parameter Anda memiliki `-` operator sebagai karakter pertama, Anda harus memisahkan nama parameter dari nilainya dengan karakter tanda sama dengan (`=`) alih-alih karakter spasi biasa. Jika Anda menggunakan karakter spasi, CLI salah menafsirkan string. Misalnya, kueri berikut gagal. <pre>aws resource-explorer-2 search --query-string "-tag:none region:us-east-1"</pre> String kueri yang dikoreksi berikut, dengan `=` mengganti spasi, berfungsi seperti yang diharapkan. <pre>aws resource-explorer-2 search --query-string="-tag:none region:us-east-1"</pre> Jika Anda mengubah urutan filter dalam string kueri sehingga `-` bukan karakter pertama dalam nilai parameter, Anda dapat menggunakan karakter spasi standar. String query berikut berfungsi. <pre>aws resource-explorer-2 search --query-string "region:us-east-1 -tag:none"</pre>   | 
| \$1<special character> |  Anda dapat melarikan diri dari karakter khusus yang harus disertakan persis seperti yang ditunjukkan daripada ditafsirkan. Jika teks Anda menyertakan salah satu karakter khusus (` * " - : = \`), Anda harus mendahului karakter tersebut dengan garis miring terbalik (`\`) untuk memastikan bahwa karakter tersebut diambil secara harfiah. Contoh berikut menunjukkan cara menggunakan kata kunci teks bentuk bebas yang menyertakan tanda hubung (`-`) karakter (). `"my-key-word"`  Selain itu, untuk mencegah Resource Explorer memecah ekspresi pada tanda hubung menjadi tiga kata kunci terpisah, Anda dapat mengelilingi seluruh frasa dalam tanda kutip ganda.  `"my\-key\-word"`  Untuk menyisipkan garis miring terbalik literal, masukkan dua karakter garis miring terbalik berturut-turut. Garis miring terbalik pertama ditafsirkan sebagai escape dan backslash kedua adalah karakter literal untuk disisipkan. `"some_text\\some_more_text"`  | 

**catatan**  
Jika tampilan menyertakan tag yang dilampirkan ke sumber daya, maka `Search` operasi tidak menampilkan kesalahan validasi untuk string pencarian, karena filter yang tidak valid juga dapat ditafsirkan sebagai pencarian teks bentuk bebas. Misalnya, meskipun `cat:blue` ***terlihat*** seperti filter, Resource Explorer tidak dapat menguraikannya sebagai satu karena `cat:` bukan salah satu filter yang valid dan ditentukan. Sebagai gantinya Resource Explorer menafsirkan seluruh string sebagai string pencarian bentuk bebas untuk memungkinkannya mencocokkan hal-hal seperti nama kunci tag atau sepotong file. ARN  
Operasi ini memunculkan kesalahan validasi jika salah satu dari berikut ini benar:  
Tampilan tidak menyertakan informasi tentang tag
Kueri penelusuran secara eksplisit menggunakan filter tag (`tag.key:`,`tag.value:`, atau) `tag:`