全部产品
Search
文档中心

Simple Log Service:CreateLogStore

更新时间:Jan 16, 2026

Membuat Logstore.

Deskripsi operasi

Catatan Penggunaan

  • Host dalam sintaks permintaan terdiri atas nama project dan endpoint Simple Log Service. Tentukan project dalam Host tersebut.

  • Buat Pasangan Kunci Akses (AccessKey pair). Untuk informasi selengkapnya, lihat AccessKey pair.

Pasangan Kunci Akses untuk Akun Alibaba Cloud memiliki akses penuh ke semua Operasi API, yang menimbulkan risiko keamanan tinggi. Kami menyarankan Anda membuat dan menggunakan Pengguna Resource Access Management (RAM) untuk memanggil Operasi API atau melakukan operasi dan pemeliharaan (O&M) rutin. Pengguna RAM tersebut harus memiliki izin untuk mengelola resource Simple Log Service. Untuk informasi selengkapnya, lihat Buat dan otorisasi pengguna RAM.

  • Dapatkan nama project dan wilayah tempat project tersebut berada. Untuk informasi selengkapnya, lihat Kelola project.

  • Setiap project dapat berisi maksimal 200 Logstore.

  • Log akan dihapus setelah periode retensi data yang ditentukan berakhir.

Otorisasi

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

ActionDeskripsi resource dalam kebijakan otorisasi
log:CreateLogStoreacs: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:CreateLogStore

create

*LogStore

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

  • log:TLSVersion
  • log:Encrypted
None

Sintaks permintaan

POST /logstores HTTP/1.1

Parameter permintaan

Parameter

Type

Required

Description

Example

project

string

Yes

Nama project.

ali-test-project

body

object

Yes

Parameter permintaan.

logstoreName

string

Yes

Nama Logstore. Nama tersebut harus memenuhi persyaratan berikut:

  • Nama harus unik dalam satu project.

  • Hanya boleh berisi huruf kecil, angka, tanda hubung (-), dan garis bawah (_).

  • Harus dimulai dan diakhiri dengan huruf kecil atau angka.

  • Panjangnya harus antara 2 hingga 63 karakter.

my-logstore

shardCount

integer

Yes

Jumlah shard.

Catatan

Anda tidak dapat mengubah jumlah shard melalui operasi ini. Untuk mengubah jumlah shard, panggil operasi `SplitShard` atau `MergeShards`.

2

ttl

integer

Yes

Periode retensi data, dalam satuan hari. Nilai yang valid: 1 hingga 3650. Jika Anda menetapkan nilai 3650, data akan disimpan secara permanen.

1

encrypt_conf EncryptConf

No

Struktur data konfigurasi enkripsi. Parameter mencakup enable, encrypt_type, dan user_cmk_info. Untuk informasi selengkapnya, lihat EncryptConf.

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: menonaktifkan pelacakan web.

false

maxSplitShard

integer

No

Jumlah maksimum shard yang dapat dibuat melalui pembagian otomatis. Nilainya harus antara 1 hingga 256.

Catatan

Parameter ini wajib jika Anda menetapkan parameter autoSplit ke true.

64

appendMeta

boolean

No

Menentukan apakah Alamat IP publik klien dan waktu penerimaan log akan dicatat. Nilai default adalah false.

  • true: mencatat Alamat IP publik klien dan waktu penerimaan log. Jika fitur ini diaktifkan, Simple Log Service secara otomatis menambahkan Alamat IP publik sumber log dan waktu penerimaan log oleh server ke bidang tag pada log.

  • false: tidak mencatat Alamat IP publik klien atau waktu penerimaan log.

false

telemetryType

string

No

Jenis data observabilitas. Nilai yang valid:

  • None: data log. Ini adalah nilai default.

  • Metrics: metrik.

None

hot_ttl

integer

No

Periode retensi data di tier penyimpanan hot Logstore, dalam satuan hari. Nilai minimum adalah 7. Nilainya tidak boleh lebih besar dari nilai `ttl`. Jika Anda menetapkan parameter ini ke -1, data akan disimpan secara permanen di tier hot.

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

Mode Logstore. Simple Log Service menyediakan dua mode: Standard dan Query.

  • standard: Mendukung analitik data komprehensif. Mode ini cocok untuk kasus penggunaan seperti Pemantauan waktu nyata, analisis interaktif, dan membangun sistem observabilitas lengkap.

  • query: Mendukung kueri berkinerja-tinggi. Biaya trafik indeks untuk mode ini sekitar separuh dari mode Standard. Mode ini tidak mendukung analisis SQL. Cocok untuk kasus penggunaan yang melibatkan volume data besar, periode retensi panjang, dan tanpa kebutuhan analisis log.

standard

infrequentAccessTTL

integer

No

Periode retensi data di kelas penyimpanan Infrequent Access (IA), dalam satuan hari. Nilainya harus 30 atau lebih.

30

processorId

string

No

ID prosesor ingest.

processor-nginx-parser-001

shardingPolicy ShardingPolicy

No

Konfigurasi untuk penulisan berbasis hash.

resourceGroupId

string

No

ID kelompok sumber daya.

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.