Memperbarui informasi dasar tentang logstore.
Catatan penggunaan
Sebelum menjalankan perintah CLI ini, pastikan kondisi berikut telah terpenuhi:
Layanan Log Sederhana diaktifkan. Untuk informasi lebih lanjut, lihat Bagaimana cara memulai dengan Layanan Log Sederhana?
CLI Layanan Log Sederhana telah diinstal dan dikonfigurasi. Untuk informasi lebih lanjut, lihat Instal CLI Layanan Log Sederhana dan Konfigurasikan CLI Layanan Log Sederhana.
Proyek dan logstore telah dibuat. Untuk informasi lebih lanjut, lihat create_project dan create_logstore.
Sintaks perintah
aliyunlog log update_logstore --project_name=<value> --logstore_name=<value> [--ttl=<value>] [--enable_tracking=<value>] [--shard_count=<value>] [--append_meta=<value>] [--auto_split=<value>] [--max_split_shard=<value>] [--preserve_storage=<value>] [--encrypt_conf=<value>] [--hot_ttl=<value>] [--mode=<value>] [--telemetry_type=<value>] [--access-id=<value>] [--access-key=<value>] [--sts-token=<value>] [--region-endpoint=<value>] [--client-name=<value>] [--jmes-filter=<value>] [--format-output=<value>] [--decode-output=<value>] [--profile=<value>]Parameter perintah
Tabel berikut menggambarkan parameter yang diperlukan untuk perintah ini serta parameter spesifik perintah ini.
Parameter | Tipe | Diperlukan | Contoh | Deskripsi |
--project_name | String | Ya | aliyun-test-project | Nama proyek. Proyek dalam Layanan Log Sederhana digunakan untuk mengisolasi sumber daya pengguna yang berbeda dan mengontrol akses ke sumber daya tertentu. Lihat Kelola proyek. |
--logstore_name | String | Ya | logstore-a | Nama logstore. Nama tersebut harus unik secara global. Anda tidak dapat mengubah nama setelah proyek dibuat. Nama tersebut harus memenuhi persyaratan berikut:
|
--ttl | Integer | Tidak | 30 | Periode retensi data. Unit: hari. Nilai valid: 1 hingga 3650. Jika Anda menetapkan parameter ini ke 3650, data disimpan secara permanen. Jika periode retensi yang ditentukan berakhir, data log akan dihapus. Periode retensi data yang ditentukan oleh parameter ttl adalah jumlah dari nilai waktu berikut:
Penting Jika Anda mengubah periode retensi, Layanan Log Sederhana akan menghapus semua data yang kedaluwarsa dalam waktu 1 jam. Volume data yang ditampilkan untuk Rincian Penggunaan di halaman utama konsol Layanan Log Sederhana diperbarui pada hari berikutnya. Misalnya, jika Anda mengubah periode retensi dari lima hari menjadi satu hari, Layanan Log Sederhana akan menghapus data log dari empat hari sebelumnya dalam waktu 1 jam. |
--shard_count | Integer | Tidak | 2 | Jumlah shard. Nilai valid: 1 hingga 10. Untuk informasi lebih lanjut, lihat Rentang nilai MD5. Penting Anda tidak dapat mengubah jumlah shard dengan menjalankan perintah update_logstore. Untuk mengubah jumlah shard, Anda dapat memanggil operasi SplitShard dan MergeShard. |
--enable_tracking | Boolean | Tidak | true | Menentukan apakah akan mengaktifkan fitur pelacakan web. Nilai valid:
|
--append_meta | Boolean | Tidak | false | Menentukan apakah akan mencatat alamat IP publik. Nilai valid:
|
--auto_split | Boolean | Tidak | true | Menentukan apakah akan mengaktifkan sharding otomatis. Nilai valid:
|
--max_split_shard | Integer | Tidak | 64 | Jumlah maksimum shard ke mana shard yang ada dapat dibagi secara otomatis. Nilai valid: 1 hingga 256. Jika Anda menetapkan --autoSplit ke true, Anda harus menentukan parameter ini. |
--encrypt_conf | String | Tidak | None | Struktur data konfigurasi enkripsi. Untuk informasi lebih lanjut, lihat EncryptConf. |
--telemetry_type | String | Tidak | None | Tipe data yang dapat diamati. Nilai valid:
|
--hot_ttl | Integer | Tidak | 7 | Periode retensi data untuk tier penyimpanan panas. Unit: hari. Nilai minimum adalah 7, dan nilai maksimum tidak boleh melebihi parameter ttl. Jika Anda menetapkan parameter ini ke -1, semua data disimpan di tier penyimpanan panas. Setelah periode retensi data yang ditentukan untuk tier penyimpanan panas berakhir, data dipindahkan ke tier penyimpanan IA. Untuk informasi lebih lanjut tentang tier penyimpanan dan pergerakan data antar tier penyimpanan, lihat Konfigurasikan penyimpanan bertingkat cerdas.
|
--mode | String | Tidak | standard | Tipe logstore. Layanan Log Sederhana menyediakan dua tipe logstore: Logstore Standar dan Logstore Query. Nilai valid:
|
| Integer | Tidak | 30 | Periode retensi data untuk tier penyimpanan IA. Unit: hari. Data di tier penyimpanan IA harus disimpan setidaknya 30 hari sebelum data dapat dipindahkan ke tier penyimpanan Arsip. Untuk informasi lebih lanjut, lihat Konfigurasikan penyimpanan bertingkat cerdas. |
Untuk informasi lebih lanjut tentang parameter global perintah ini, lihat Parameter Global.
Contoh perintah
Perintah
Gunakan akun default untuk memperbarui informasi tentang logstore-a.
aliyunlog log update_logstore --project_name="aliyun-test-project" --logstore_name="logstore-a" --ttl=30 --enable_tracking=trueKeluaran
Jika perintah berhasil dijalankan, tidak ada respons yang dikembalikan. Anda dapat menjalankan perintah berikut untuk menanyakan detail logstore:
aliyunlog log get_logstore --project_name="aliyun-test-project" --logstore_name="logstore-a" --format-output=json
Referensi
Jika respons yang dikembalikan oleh Layanan Log Sederhana berisi informasi kesalahan setelah Anda memanggil operasi API, panggilan gagal. Anda dapat menangani kesalahan berdasarkan kode kesalahan yang dikembalikan saat panggilan API gagal. Untuk informasi lebih lanjut, lihat Kode Kesalahan.
Layanan Log Sederhana juga kompatibel dengan SDK Alibaba Cloud. Untuk informasi lebih lanjut, lihat Simple Log Service_SDK Center_Alibaba Cloud OpenAPI Explorer.
Untuk informasi lebih lanjut tentang operasi API yang sesuai dengan perintah ini, lihat UpdateLogStore.
Layanan Log Sederhana menyediakan contoh kode yang digunakan untuk mengelola logstore dengan menggunakan SDK Layanan Log Sederhana untuk Java dan SDK Layanan Log Sederhana untuk Python.