All Products
Search
Document Center

Simple Log Service:CreateLogStore

Last Updated:Oct 03, 2026

Membuat penyimpanan log.

Deskripsi operasi

Deskripsi operasi

  • Host dalam sintaks permintaan terdiri dari nama Proyek dan Titik akhir layanan Simple Log Service. Anda harus menentukan Proyek di Host.

  • Buat dan dapatkan AccessKey. Untuk informasi selengkapnya, lihat AccessKey.

AccessKey akun Alibaba Cloud memiliki akses penuh ke semua Operasi API, yang menimbulkan risiko keamanan tinggi. Buat dan gunakan Pengguna RAM untuk memanggil Operasi API atau melakukan O&M rutin. Pengguna RAM harus memiliki izin akses untuk mengelola Sumber daya layanan Simple Log Service. Untuk informasi selengkapnya, lihat Membuat pengguna RAM dan memberikan otorisasi.

  • Identifikasi nama dan Wilayah Proyek tempat log yang ingin Anda kueri berada. Untuk informasi selengkapnya, lihat Mengelola Proyek.

  • Anda dapat membuat maksimal 200 penyimpanan log dalam satu Proyek.

  • Log dihapus ketika periode retensi data yang Anda konfigurasi berakhir.

Informasi otentikasi

Tabel berikut mencantumkan informasi otorisasi untuk Operasi API ini. Anda dapat menambahkan informasi ini ke elemen Action pada pernyataan kebijakan akses RAM untuk memberikan izin kepada Pengguna RAM atau Peran RAM guna memanggil Operasi API ini.

AksiSumber Daya
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 proyek.

ali-test-project

body

object

Yes

Parameter permintaan.

logstoreName

string

Yes

Nama penyimpanan log. Nama harus memenuhi persyaratan berikut:

  • Nama harus unik dalam satu Proyek.

  • Nama hanya dapat berisi huruf kecil, angka, tanda hubung (-), dan garis bawah (_).

  • Nama harus diawali dan diakhiri dengan huruf kecil atau angka.

  • Panjang nama harus 2 hingga 63 karakter.

my-logstore

shardCount

integer

Yes

Jumlah shard.

Catatan

Operasi ini tidak mendukung pembaruan jumlah shard. Gunakan operasi SplitShard atau MergeShard untuk mengubah jumlah shard.

2

ttl

integer

Yes

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

1

encrypt_conf EncryptConf

No

Struktur data konfigurasi Enkripsi, yang berisi parameter enable, encrypt_type, dan user_cmk_info. Untuk informasi selengkapnya, lihat EncryptConf.

Contoh 1 (mengaktifkan Enkripsi default):

{
    "enable": true,
    "encrypt_conf": "default"
}

Contoh 2 (mengaktifkan Enkripsi bawa-kunci-sendiri):

{
    "enable": true,
    "encrypt_conf": "default",
    "user_cmk_info": {
        "cmk_key_id": "xxxxx",
        "arn": "acs:ram::112340000000:peran/rolename",
        "region": "cn-hangzhou"
    }
}

autoSplit

boolean

No

Apakah akan mengaktifkan sharding otomatis. Jika diaktifkan, operasi pemisahan shard akan dipicu secara otomatis ketika trafik penulisan log secara konsisten melebihi batas, yang meningkatkan throughput penulisan. Jika Anda mengaktifkan sharding otomatis, Anda harus mengonfigurasi maxSplitShard (jumlah shard maksimum setelah pemisahan).

true

enable_tracking

boolean

No

Apakah akan mengaktifkan fitur pelacakan web. Nilai default: false. Gunakan fitur pelacakan web untuk mengumpulkan dan menganalisis data perilaku pengguna di browser atau program mini, seperti tampilan halaman, Catatan pembelian, dan waktu di situs.

false

maxSplitShard

integer

No

Jumlah shard maksimum setelah pemisahan otomatis. Nilai minimum: 1. Nilai maksimum: 256.

Catatan

Parameter ini wajib diisi ketika autoSplit diatur ke true.

64

appendMeta

boolean

No

Apakah akan mencatat alamat IP publik dan waktu penerimaan log. Nilai default: false.

  • true: Mengaktifkan pencatatan alamat IP publik pengatur waktu penerimaan log. Simple Log Service secara otomatis menambahkan alamat IP publik perangkat sumber log pengatur waktu saat log tiba di server ke bidang Tag log.

  • false: Menonaktifkan pencatatan alamat IP publik pengatur waktu penerimaan log.

false

telemetryType

string

No

Tipe data observabel. Tipe default adalah data log. Nilai valid:

  • None: data log. Ini adalah nilai default.

  • Metrics: data deret waktu.

None

hot_ttl

integer

No

Periode retensi data di tier hot penyimpanan log. Unit: hari. Nilai minimum: 7. Nilai maksimum tidak boleh melebihi nilai ttl. Secara default, semua data dalam periode retensi ttl disimpan di tier hot.

Ketika Durasi penyimpanan data melebihi periode retensi data hot yang Anda konfigurasi, data akan dipindahkan ke tier Akses Jarang (IA). Jika Anda mengaktifkan tier IA, periode retensi data hot harus minimal 7 hari. Untuk informasi selengkapnya, lihat Intelligent tiering.

Contoh:

  • Skenario 1 (hanya tier hot, 30 hari): {"ttl": 30} atau {"ttl": 30, "hot_ttl": 30}

  • Skenario 2 (tier hot 7 hari, tier IA 23 hari): {"ttl": 30, "hot_ttl": 7}

60

mode

string

No

Simple Log Service menyediakan dua tipe penyimpanan log: Jenis Penyimpanan Standar dan Query.

  • standard: Mendukung rangkaian lengkap fitur analitik data Simple Log Service. Cocok untuk Pemantauan waktu nyata, analisis interaktif, dan pembangunan sistem observabilitas lengkap.

  • query: Mendukung kueri berkinerja tinggi. Biaya Trafik Indeks sekitar setengah dari Jenis Penyimpanan Standar. Tidak mendukung analisis SQL. Cocok untuk skenario dengan volume data Tingkat Tinggi, periode retensi panjang (mingguan, bulanan, atau lebih lama), dan tanpa persyaratan analisis log.

standard

infrequentAccessTTL

integer

No

Tier infrequent access (IA). Tidak ada persyaratan durasi penyimpanan minimum. Data dipindahkan ke tier arsip setelah minimal 30 hari.

Ketika durasi penyimpanan log melebihi jumlah periode retensi tier hot dan periode retensi tier IA, durasi penyimpanan yang tersisa dikonversi ke penyimpanan arsip.

Contoh:

  • Skenario 1 (tier hot 7 hari, tier IA 23 hari): {"ttl": 30, "hot_ttl": 7}

  • Skenario 2 (tier hot 7 hari, tier IA 30 hari, arsip 60 hari): {"ttl": 97, "hot_ttl": 7, "infrequentAccessTTL": 30}

  • Skenario 3 (tier hot 60 hari, tier IA 0 hari, arsip 60 hari): {"ttl": 120, "hot_ttl": 60, "infrequentAccessTTL": 0}

30

processorId

string

No

ID IngestProcessor.

processor-nginx-parser-001

shardingPolicy ShardingPolicy

No

Konfigurasi penulisan hash. Saat menulis data, log dirutekan ke shard berdasarkan kebijakan hash yang dikonfigurasi. Sebelum mengonfigurasi ini, pastikan rentang hash shard terdistribusi secara merata. Pengaturan ini dapat memengaruhi throughput penulisan, jadi konfigurasikan dengan hati-hati.

resourceGroupId

string

No

ID kelompok sumber daya. Jika ditentukan, penyimpanan log akan dikaitkan dengan kelompok sumber daya.

rg-xxxxxxxx

enableModify

boolean

No

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.