Referensi sintaks kueri pencarian untuk Resource Explorer

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, lihatContoh permintaan pencarian Resource Explorer.

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

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 nilainyaProduction. 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, lihatMemberikan akses ke tampilan Resource Explorer untuk pencarian.

Sintaks string kueri

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

Hal-hal mendasar

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 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

Anda dapat membatasi hasil kueri Anda lebih ketat dengan memasukkan filter. Tidak seperti kata kunci teks, filter dievaluasi dalam kueri dengan operator AND. 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 logis AND. 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 implisitAND, 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, sepertitag:,tag.key:, dantag.value:.

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

Nama filter	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 aplikasi ARN. 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 catatan Untuk menggunakan filter ini, tampilan Anda harus memiliki akses ke data penandaan.
id:	Pengidentifikasi sumber daya individu, dinyatakan sebagai nama sumber daya Amazon (ARN). 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 catatan Mengetik hanya kode Wilayah (tanpa filter, sepertius-east-1) tidak mengembalikan hasil yang sama sepertiregion: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 sebagaius,east, dan1. 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 catatan 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. tagsadalah satu-satunya nilai yang didukung. Resource Explorer menyertakan dalam hasil hanya sumber daya yang dapat diberi tag. resourcetype.supports:tags
service:	AWS layanan 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:none	Kasus khusus tag: filter yang memungkinkan Anda mencari sumber daya apa pun yang tidak memiliki tag yang dibuat pengguna. catatan Sumber daya dengan tag AWS yang dibuat layanan masih muncul di hasil untuk filter ini.
tag.key:	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

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 “frase tanda hubung”	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:"enviornment=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 dimulaius-east. region:us-east* penting 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 di konsol Resource Explorer tidak secara otomatis menambahkan karakter wildcard. Anda dapat memasukkan secara * manual setelah istilah apa pun dalam string pencarian.
-keyword	Notoperator. 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 layanan Amazon EC2 dikecualikan dari hasil. -service:ec2 penting 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. aws resource-explorer-2 search --query-string "-tag:none region:us-east-1" String kueri yang dikoreksi berikut, dengan = mengganti spasi, berfungsi seperti yang diharapkan. aws resource-explorer-2 search --query-string="-tag:none region:us-east-1" 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. aws resource-explorer-2 search --query-string "region:us-east-1 -tag:none"
\<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 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: