すべてのプロダクト
Search
ドキュメントセンター

Simple Log Service:CreateLogStore

最終更新日:Jun 03, 2026

Logstore を作成します。

操作説明

注意事項

  • リクエストの Host ヘッダーは、プロジェクト名と Log Service のエンドポイントで構成されます。このヘッダーでプロジェクトを指定する必要があります。

  • AccessKey を作成して取得する必要があります。詳細については、「AccessKey」をご参照ください。

Alibaba Cloud アカウントの AccessKey ペアは、すべての API オペレーションに対する完全な権限を持つため、セキュリティリスクが生じます。セキュリティを強化するため、API オペレーションの呼び出しや日常的な運用保守には、RAM ユーザーを使用することを強く推奨します。RAM ユーザーに Log Service のリソースを管理するための権限を付与する必要があります。詳細については、「RAM ユーザーの作成と権限付与」をご参照ください。

  • Logstore を作成するプロジェクトの名前とリージョンを確認してください。詳細については、「プロジェクトの管理」をご参照ください。

  • 1 つのプロジェクトに最大 200 個の Logstore を作成できます。

  • Log Service は、指定したデータ保持期間が経過すると、ログを自動的に削除します。

権限付与

次の表は、この API を呼び出すために必要な権限を示しています。RAM ユーザーまたは RAM ロールにこの権限を付与するには、対応する Action を RAM ポリシーのステートメントに追加してください。

ActionResource
log:CreateLogStoreacs:log:{#regionId}:{#accountId}:project/{#project}/logstore/{#logstoreName}

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

log:CreateLogStore

create

*LogStore

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

  • log:TLSVersion
  • log:Encrypted
なし

リクエスト構文

POST /logstores HTTP/1.1

リクエストパラメーター

パラメーター

必須 / 任意

説明

project

string

必須

プロジェクトの名前です。

ali-test-project

body

object

必須

リクエストボディのパラメーターです。

logstoreName

string

必須

Logstore の名前です。名前は次の要件を満たす必要があります。

  • プロジェクト内で一意である必要があります。

  • 小文字、数字、ハイフン (-)、アンダースコア (_) のみ使用できます。

  • 先頭と末尾は、小文字または数字である必要があります。

  • 長さは 2~63 文字である必要があります。

my-logstore

shardCount

integer

必須

シャード数です。

説明

この操作ではシャード数を更新できません。更新するには、SplitShard または MergeShards API を呼び出す必要があります。

2

ttl

integer

必須

データ保持期間 (日) です。有効な値は 1~3,650 です。3,650 に設定した場合、データは永続的に保存されます。

1

encrypt_conf EncryptConf

任意

暗号化設定です。このデータ構造には、enableencrypt_typeuser_cmk_info の各パラメーターが含まれます。詳細については、「EncryptConf」をご参照ください。

例 1:デフォルト暗号化を有効にする場合

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

例 2:BYOK 暗号化を有効にする場合

{
    "enable": true,
    "encrypt_type": "byok",
    "user_cmk_info": {
        "cmk_key_id": "xxxxx",
        "arn": "acs:ram::112340000000:role/rolename",
        "region": "cn-hangzhou"
    }
}

autoSplit

boolean

任意

自動シャード分割を有効にするかどうかを指定します。このパラメーターを true に設定すると、シャードへの書き込みトラフィックが継続的にサービス制限を超過した場合、Log Service は書き込みスループットを向上させるためにシャードを自動的に分割します。自動シャード分割を有効にする場合は、maxSplitShard も指定する必要があります。

true

enable_tracking

boolean

任意

ウェブトラッキングを有効にするかどうかを指定します。デフォルト値は false です。この機能を使用すると、ページビュー、購入履歴、滞在時間など、ブラウザーまたはミニプログラムからユーザー行動データを収集して分析できます。

false

maxSplitShard

integer

任意

自動分割後のシャードの最大数です。値は 1~256 の整数である必要があります。

説明

autoSplit を true に設定する場合、このパラメーターは必須です。

64

appendMeta

boolean

任意

ソースのパブリック IP アドレスサーバー受信時刻を記録するかどうかを指定します。デフォルト値は false です。

  • true:Log Service は、ソースデバイスのパブリック IP アドレスとサーバー受信時刻をログの Tag フィールドに自動的に追加します。

  • false:Log Service は、ソースのパブリック IP アドレスとサーバー受信時刻を追加しません。

false

telemetryType

string

任意

可観測データの種類です。有効な値は次のとおりです。

  • None:ログデータ (デフォルト値)。

  • Metrics:メトリクスデータ。

None

hot_ttl

integer

任意

Logstore のホットストレージ層におけるデータの保持期間 (日) です。値は 7 から ttl の値までの整数である必要があります。このパラメーターを指定しない場合、データは ttl で指定したデータ保持期間の全期間にわたりホットストレージ層に保存されます。

ホットストレージの保持期間が終了すると、データは低頻度アクセス (IA) ストレージ層に移動します。IA ストレージを有効にするには、ホットストレージの保持期間を少なくとも 7 日に設定する必要があります。詳細については、「Smart Tiered Storage」をご参照ください。

例:

  • シナリオ 1:ホットストレージ層に 30 日間データを保存する場合 {"ttl": 30} または {"ttl": 30, "hot_ttl": 30}

  • シナリオ 2:ホットストレージ層に 7 日間、IA ストレージ層に 23 日間データを保存する場合 {"ttl": 30, "hot_ttl": 7}

60

mode

string

任意

Log Service では、standard と query の 2 種類の Logstore を提供しています。

  • standard:エンドツーエンドのデータ分析をサポートします。このモードは、リアルタイム監視、対話型分析、完全なオブザーバビリティシステムの構築などのシナリオに適しています。

  • query:高パフォーマンスのクエリをサポートします。インデックスのトラフィックコストは standard モードの約半分ですが、SQL 分析はサポートされません。このモードは、大量データ、週または月などの長い保持期間、SQL ベースの分析が不要なシナリオに適しています。

standard

infrequentAccessTTL

integer

任意

低頻度アクセス (IA) ストレージの保持期間 (日) です。このパラメーターに最小値はありませんが、データをアーカイブストレージに移動する前に、少なくとも 30 日間は IA ストレージ層に保持する必要があります。

合計保持期間 (ttl) が、ホットストレージ期間 (hot_ttl) と IA ストレージ期間 (infrequentAccessTTL) の合計より長い場合、残りの期間がアーカイブストレージ期間になります。

例:

  • シナリオ 2:ホットストレージ層に 7 日間、IA ストレージ層に 23 日間データを保存する場合 {"ttl": 30, "hot_ttl": 7}

  • シナリオ 3:ホットストレージ層に 7 日間、IA ストレージ層に 30 日間、アーカイブストレージ層に 60 日間データを保存する場合 {"ttl": 97, "hot_ttl": 7, "infrequentAccessTTL": 30}

  • シナリオ 4:ホットストレージ層に 60 日間、アーカイブストレージ層に 60 日間データを保存し、IA ストレージ期間が 0 日である場合 {"ttl": 120, "hot_ttl": 60, "infrequentAccessTTL": 0}

30

processorId

string

任意

IngestProcessor の ID です。

processor-nginx-parser-001

shardingPolicy ShardingPolicy

任意

ハッシュベースの書き込み設定です。データを書き込むと、ログは設定したシャーディングポリシーに基づいて選択されたシャードに保存されます。このパラメーターを設定する前に、シャードのハッシュ範囲が均等に分散していることを確認してください。不適切な設定は書き込みパフォーマンスに影響を及ぼす可能性があるため、慎重に設定してください。

resourceGroupId

string

任意

Logstore が属するリソースグループの ID です。

rg-xxxxxxxx

enableModify

boolean

任意

レスポンスフィールド

フィールド

説明

レスポンスフィールドがありません。

成功レスポンス

JSONJSON

{}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。