全部产品
Search
文档中心

Simple Log Service:UpdateLogStore

更新时间:Jan 16, 2026

Memperbarui properti sebuah Logstore.

Deskripsi operasi

Catatan Penggunaan

  • Sebelum memperbarui Logstore, panggil operasi GetLogStore untuk mengambil konfigurasi Logstore tersebut. Selanjutnya, ubah konfigurasi tersebut dan teruskan ke operasi UpdateLogStore.

  • Host dalam sintaksis permintaan terdiri dari nama proyek dan titik akhir Simple Log Service (SLS). Anda harus menentukan proyek dalam Host.

  • Dapatkan Pasangan Kunci Akses. Untuk informasi selengkapnya, lihat AccessKey pair.

Pasangan Kunci Akses untuk Akun Alibaba Cloud memiliki izin atas semua operasi API, sehingga menimbulkan risiko keamanan yang tinggi. Kami menyarankan agar Anda membuat dan menggunakan Pengguna RAM untuk melakukan panggilan API atau menjalankan operasi O&M rutin. Pengguna RAM tersebut harus diberikan izin yang diperlukan untuk mengoperasikan resource SLS. Untuk informasi selengkapnya, lihat Create and authorize a RAM user.

  • Dapatkan nama proyek, nama Logstore, dan wilayah tempat proyek tersebut berada. Untuk informasi selengkapnya, lihat Manage projects dan Manage Logstores.

Otorisasi

Tabel berikut menjelaskan otorisasi yang diperlukan untuk operasi ini. Untuk memberikan izin kepada Pengguna RAM atau peran RAM agar dapat memanggil operasi ini, tambahkan aksi yang diperlukan ke elemen Action dalam kebijakan RAM.

ActionDeskripsi resource dalam kebijakan otorisasi
log:UpdateLogStoreacs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#LogstoreName}

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

log:UpdateLogStore

update

*LogStore

acs:log:{#regionId}:{#accountId}:project/{#project}/logstore/{#logstore}

  • log:TLSVersion
  • log:Encrypted
None

Sintaks permintaan

PUT /logstores/{logstore} HTTP/1.1

Path Parameters

Parameter

Type

Required

Description

Example

logstore

string

Yes

Nama Logstore.

test-logstore

Parameter permintaan

Parameter

Type

Required

Description

Example

project

string

Yes

Nama proyek.

ali-test-project

body

object

Yes

Badan permintaan.

logstoreName

string

Yes

Nama Logstore.

test-logstore

shardCount deprecated

integer

No

Jumlah shard.

Catatan

Anda tidak dapat memperbarui jumlah shard dengan operasi ini. Untuk mengubah jumlah shard, panggil operasi SplitShard atau MergeShards.

2

ttl

integer

Yes

Periode retensi data. Satuan: hari. Nilai yang valid: 1 hingga 3650. Jika Anda mengatur parameter ini ke 3650, data akan disimpan secara permanen.

30

encrypt_conf EncryptConf

No

Konfigurasi enkripsi.

autoSplit

boolean

No

Menentukan apakah shard akan dibagi secara otomatis.

  • true: membagi shard secara otomatis.

  • false: tidak membagi shard secara otomatis.

true

enable_tracking

boolean

No

Menentukan apakah pelacakan web diaktifkan. Nilai default: false.

  • true: mengaktifkan pelacakan web.

  • false: tidak mengaktifkan pelacakan web.

false

appendMeta

boolean

No

Menentukan apakah alamat IP publik dicatat. Nilai default: false.

  • true: mencatat alamat IP publik.

  • false: tidak mencatat alamat IP publik.

false

maxSplitShard

integer

No

Jumlah maksimum shard yang dapat dihasilkan dari pembagian satu shard. Nilainya harus berupa bilangan bulat antara 1 hingga 256.

Catatan

Parameter ini wajib jika autoSplit diatur ke true.

64

telemetryType deprecated

string

No

Jenis data observabilitas. Nilai yang valid:

  • None: log. Ini adalah nilai default.

  • Metrics: metrik.

None

hot_ttl

integer

No

Periode retensi data pada tier hot Logstore. Nilai minimum: 7. Satuan: hari. Nilai yang valid: 7 hingga 3000. Setelah periode retensi tier hot berakhir, data akan dipindahkan ke kelas penyimpanan Infrequent Access (IA). Untuk informasi selengkapnya, lihat Automatic Storage Tiering.

60

mode

string

No

SLS menyediakan dua jenis Logstore: Standard dan Query.

  • standard: mendukung analitik data satu atap. Jenis Logstore ini cocok untuk skenario seperti pemantauan waktu nyata, analisis interaktif, dan membangun sistem observabilitas lengkap.

  • query: mendukung kueri berkinerja-tinggi. Biaya trafik indeks Logstore Query sekitar separuh dari Logstore Standard. Namun, Logstore Query tidak mendukung analisis SQL. Jenis Logstore ini cocok untuk skenario yang melibatkan volume data besar, periode retensi panjang (mingguan atau bulanan), dan tanpa analisis log.

standard

infrequentAccessTTL

integer

No

Periode retensi data pada kelas penyimpanan IA. Data pada kelas penyimpanan ini tidak memiliki periode retensi minimum. Data harus disimpan setidaknya selama 30 hari sebelum dipindahkan ke penyimpanan Archive.

30

shardingPolicy ShardingPolicy

No

Konfigurasi penulisan berbasis hash.

Elemen respons

Element

Type

Description

Example

Tidak ada yang didefinisikan.

Contoh

Respons sukses

JSONformat

{}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.