Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Menanyakan Status Sumber Daya Konfigurasi Saat Ini AWS
Memperkenalkan fitur pratinjau untuk kueri lanjutan yang memungkinkan Anda menggunakan kemampuan kecerdasan buatan generatif (AI generatif) untuk memasukkan petunjuk dalam bahasa Inggris biasa dan mengubahnya menjadi format kueri. ready-to-use Untuk informasi selengkapnya, lihat Pemroses kueri bahasa alami untuk kueri lanjutan. |
Anda dapat menggunakan AWS Config untuk menanyakan status konfigurasi sumber AWS daya saat ini berdasarkan properti konfigurasi untuk satu akun dan Wilayah atau di beberapa akun dan Wilayah. Anda dapat melakukan kueri berbasis properti terhadap metadata status AWS sumber daya saat ini di seluruh daftar sumber daya yang mendukung. AWS Config Untuk informasi selengkapnya tentang daftar jenis sumber daya yang didukung, lihat Jenis Sumber Daya yang Didukung untuk Kueri Lanjutan
Kueri lanjutan menyediakan satu titik akhir kueri dan bahasa kueri untuk mendapatkan metadata status sumber daya saat ini tanpa melakukan panggilan deskripsi khusus layanan. API Anda dapat menggunakan agregator konfigurasi untuk menjalankan kueri yang sama dari akun pusat di beberapa akun dan Wilayah. AWS
Topik
Fitur
AWS Config menggunakan subset SELECT
sintaks bahasa kueri terstruktur (SQL) untuk melakukan kueri dan agregasi berbasis properti pada data item konfigurasi (CI) saat ini. Kueri berkisar dalam kompleksitas dari kecocokan terhadap tag dan/atau pengidentifikasi sumber daya, hingga kueri yang lebih kompleks, seperti melihat semua bucket Amazon S3 yang menonaktifkan versi. Ini memungkinkan Anda untuk menanyakan dengan tepat status sumber daya saat ini yang Anda butuhkan tanpa melakukan AWS panggilan khusus layananAPI.
Ini mendukung fungsi agregasi sepertiAVG
,,COUNT
, MAX
MIN
, danSUM
.
Anda dapat menggunakan kueri lanjutan untuk:
-
Manajemen inventaris; misalnya, untuk mengambil daftar EC2 instans Amazon dengan ukuran tertentu.
-
Keamanan dan intelijen operasional; misalnya, untuk mengambil daftar sumber daya yang memiliki properti konfigurasi tertentu diaktifkan atau dinonaktifkan.
-
Optimalisasi biaya; misalnya, untuk mengidentifikasi daftar EBS volume Amazon yang tidak dilampirkan ke EC2 instance apa pun.
-
Data kepatuhan; misalnya, untuk mengambil daftar semua paket kesesuaian Anda dan status kepatuhannya.
Untuk informasi tentang cara menggunakan Bahasa AWS SQL Kueri, lihat Apa itu SQL (Bahasa Kueri Terstruktur)?
Batasan
catatan
Kueri lanjutan tidak mendukung sumber daya kueri yang belum dikonfigurasi untuk direkam oleh perekam konfigurasi. AWS Config membuat Item Konfigurasi (CIs) dengan ResourceNotRecorded
configurationItemStatus
ketika sumber daya telah ditemukan tetapi tidak dikonfigurasi untuk direkam oleh perekam konfigurasi. Sementara agregator akan menggabungkan iniCIs, kueri lanjutan tidak mendukung kueri dengan. CIs ResourceNotRecorded
Perbarui pengaturan perekam Anda untuk mengaktifkan perekaman jenis sumber daya yang ingin Anda kueri.
Sebagai bagian dari SQLSELECT
, sintaks kueri memiliki batasan berikut:
-
Tidak ada dukungan untuk
ALL
,AS
,DISTINCT
,FROM
,HAVING
,JOIN
, danUNION
kata kunci dalam kueri.NULL
kueri nilai tidak didukung. -
Tidak ada dukungan untuk kueri pada sumber daya pihak ketiga. Sumber daya pihak ketiga yang diambil menggunakan kueri lanjutan akan memiliki bidang konfigurasi yang ditetapkan sebagai.
NULL
-
Tidak ada dukungan untuk struktur bersarang (seperti tag) untuk dibongkar dengan SQL kueri.
-
CIDRNotasi dikonversi ke rentang IP untuk pencarian. Ini berarti bahwa
"="
dan"BETWEEN"
mencari rentang apa pun yang mencakup IP yang disediakan, bukan yang tepat. Untuk mencari rentang IP yang tepat, Anda perlu menambahkan kondisi tambahan untuk mengecualikan IPs di luar rentang. Misalnya, untuk mencari 10.0.0.0/24 dan hanya blok IP itu, Anda dapat melakukan:SELECT * WHERE resourceType = 'AWS::EC2::SecurityGroup' AND configuration.ipPermissions.ipRanges BETWEEN '10.0.0.0' AND '10.0.0.255' AND NOT configuration.ipPermissions.ipRanges < '10.0.0.0' AND NOT configuration.ipPermissions.ipRanges > '10.0.0.255'
Untuk 192.168.0.2/32, Anda dapat mencari dengan cara yang sama:
SELECT * WHERE resourceType = 'AWS::EC2::SecurityGroup' AND configuration.ipPermissions.ipRanges = '192.168.0.2' AND NOT configuration.ipPermissions.ipRanges > '192.168.0.2' AND NOT configuration.ipPermissions.ipRanges < '192.168.0.2'
-
Saat melakukan kueri terhadap beberapa properti dalam array objek, kecocokan dihitung terhadap semua elemen array. Misalnya, untuk sumber daya R dengan aturan A dan B, sumber daya sesuai dengan aturan A tetapi tidak sesuai dengan aturan B. Sumber daya R disimpan sebagai:
{ configRuleList: [ { configRuleName: 'A', complianceType: 'compliant' }, { configRuleName: 'B', complianceType: 'non_compliant' } ] }
R akan dikembalikan oleh kueri ini:
SELECT configuration WHERE configuration.configRuleList.complianceType = 'non_compliant' AND configuration.configRuleList.configRuleName = 'A'
Kondisi pertama
configuration.configRuleList.complianceType = 'non_compliant'
diterapkan ke ALL elemen di R.configRuleList, karena R memiliki aturan (aturan B) dengan complianceType = 'non_compliant', kondisi dievaluasi sebagai true. Kondisi keduaconfiguration.configRuleList.configRuleName
diterapkan pada ALL elemen dalam R.configRuleList, karena R memiliki aturan (aturan A) dengan configRuleName = 'A', kondisi dievaluasi sebagai benar. Karena kedua kondisi tersebut benar, R akan dikembalikan. -
Singkatan
SELECT
semua kolom (yaituSELECT *
) hanya memilih properti skalar tingkat atas dari CI. Sifat skalar yang dikembalikan adalahaccountId
awsRegion
,,arn
,availabilityZone
,configurationItemCaptureTime
,resourceCreationTime
,resourceId
,resourceName
resourceType
, danversion
. -
Batasan wildcard:
-
Wildcard hanya didukung untuk nilai properti dan bukan untuk kunci properti (misalnya,
...WHERE someKey LIKE 'someValue%'
didukung tetapi tidak...WHERE 'someKey%' LIKE 'someValue%'
didukung). -
Support hanya untuk wildcard akhiran (misalnya,
...LIKE 'AWS::EC2::%'
dan...LIKE 'AWS::EC2::_'
didukung tetapi...LIKE '%::EC2::Instance'
dan tidak...LIKE '_::EC2::Instance'
didukung). -
Pencocokan wildcard harus memiliki panjang minimal tiga karakter (misalnya,
...LIKE 'ab%'
dan tidak...LIKE 'ab_'
diperbolehkan tetapi...LIKE 'abc%'
diizinkan)....LIKE 'abc_'
catatan
“
_
" (garis bawah tunggal) juga diperlakukan sebagai wildcard. -
-
Batasan agregasi:
-
Fungsi agregat hanya dapat menerima satu argumen atau properti.
-
Fungsi agregat tidak dapat mengambil fungsi lain sebagai argumen.
-
GROUP BY
denganORDER BY
klausa referensi fungsi agregat mungkin hanya berisi satu properti. -
Untuk semua
GROUP BY
klausa agregasi lainnya mungkin berisi hingga tiga properti. -
Pagination didukung untuk semua kueri agregat kecuali ketika
ORDER BY
klausa memiliki fungsi agregat. Misalnya,GROUP BY X, ORDER BY Y
tidak berfungsi jikaY
merupakan fungsi agregat. -
Tidak ada dukungan untuk
HAVING
klausa dalam agregasi.
-
-
Batasan pengenal yang tidak cocok:
Pengidentifikasi yang tidak cocok adalah properti yang memiliki ejaan yang sama tetapi kasus yang berbeda (huruf besar dan kecil). Kueri lanjutan tidak mendukung kueri pemrosesan yang berisi pengidentifikasi yang tidak cocok. Sebagai contoh:
-
Dua properti yang memiliki ejaan yang sama persis tetapi dengan casing yang berbeda (
configuration.dbclusterIdentifier
danconfiguration.dBClusterIdentifier
). -
Dua properti di mana satu properti adalah bagian dari yang lain, dan mereka memiliki casing yang berbeda (
configuration.ipAddress
danconfiguration.ipaddressPermissions
).
-
Support Wilayah
Kueri lanjutan didukung di Wilayah berikut:
Nama Wilayah | Wilayah | Titik Akhir | Protokol |
---|---|---|---|
AS Timur (Ohio) | us-east-2 | config.us-east-2.amazonaws.com | HTTPS |
AS Timur (Virginia Utara) | us-east-1 | config.us-east-1.amazonaws.com | HTTPS |
AS Barat (California Utara) | us-west-1 | config.us-west-1.amazonaws.com | HTTPS |
AS Barat (Oregon) | us-west-2 | config.us-west-2.amazonaws.com | HTTPS |
Afrika (Cape Town) | af-south-1 | config.af-south-1.amazonaws.com | HTTPS |
Asia Pasifik (Hong Kong) | ap-east-1 | config.ap-east-1.amazonaws.com | HTTPS |
Asia Pasifik (Hyderabad) | ap-south-2 | config.ap-south-2.amazonaws.com | HTTPS |
Asia Pasifik (Jakarta) | ap-southeast-3 | config.ap-southeast-3.amazonaws.com | HTTPS |
Asia Pasifik (Malaysia) | ap-southeast-5 | config.ap-southeast-5.amazonaws.com | HTTPS |
Asia Pasifik (Melbourne) | ap-southeast-4 | config.ap-southeast-4.amazonaws.com | HTTPS |
Asia Pasifik (Mumbai) | ap-south-1 | config.ap-south-1.amazonaws.com | HTTPS |
Asia Pasifik (Osaka) | ap-northeast-3 | config.ap-northeast-3.amazonaws.com | HTTPS |
Asia Pasifik (Seoul) | ap-northeast-2 | config.ap-northeast-2.amazonaws.com | HTTPS |
Asia Pasifik (Singapura) | ap-southeast-1 | config.ap-southeast-1.amazonaws.com | HTTPS |
Asia Pasifik (Sydney) | ap-southeast-2 | config.ap-southeast-2.amazonaws.com | HTTPS |
Asia Pasifik (Tokyo) | ap-northeast-1 | config.ap-northeast-1.amazonaws.com | HTTPS |
Kanada (Pusat) | ca-central-1 | config.ca-central-1.amazonaws.com | HTTPS |
Kanada Barat (Calgary) | ca-west-1 | config.ca-west-1.amazonaws.com | HTTPS |
Eropa (Frankfurt) | eu-central-1 | config.eu-central-1.amazonaws.com | HTTPS |
Eropa (Irlandia) | eu-west-1 | config.eu-west-1.amazonaws.com | HTTPS |
Eropa (London) | eu-west-2 | config.eu-west-2.amazonaws.com | HTTPS |
Eropa (Milan) | eu-south-1 | config.eu-south-1.amazonaws.com | HTTPS |
Eropa (Paris) | eu-west-3 | config.eu-west-3.amazonaws.com | HTTPS |
Eropa (Spanyol) | eu-south-2 | config.eu-south-2.amazonaws.com | HTTPS |
Eropa (Stockholm) | eu-north-1 | config.eu-north-1.amazonaws.com | HTTPS |
Eropa (Zürich) | eu-central-2 | config.eu-central-2.amazonaws.com | HTTPS |
Israel (Tel Aviv) | il-central-1 | config.il-central-1.amazonaws.com | HTTPS |
Timur Tengah (Bahrain) | me-south-1 | config.me-south-1.amazonaws.com | HTTPS |
Timur Tengah (UAE) | me-central-1 | config.me-central-1.amazonaws.com | HTTPS |
Amerika Selatan (Sao Paulo) | sa-east-1 | config.sa-east-1.amazonaws.com | HTTPS |
AWS GovCloud (AS-Timur) | us-gov-east-1 | config.us-gov-east-1.amazonaws.com | HTTPS |
AWS GovCloud (AS-Barat) | us-gov-west-1 | config.us-gov-west-1.amazonaws.com | HTTPS |