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

Simple Log Service:update_logstore

最終更新日:Feb 27, 2025

ログストアの基本情報を更新します。

使用方法

この CLI コマンドを実行する前に、以下の条件が満たされていることを確認してください。

コマンド構文

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>]

コマンドパラメーター

次の表は、このコマンドの必須パラメーターと、このコマンドに固有のパラメーターについて説明しています。

パラメーター

タイプ

必須

説明

--project_name

String

はい

aliyun-test-project

プロジェクトの名前。Simple Log Service のプロジェクトは、異なるユーザーのリソースを分離し、特定のリソースへのアクセスを制御するために使用されます。詳細については、「プロジェクトを管理する」をご参照ください。

--logstore_name

String

はい

logstore-a

ログストアの名前。名前はグローバルに一意である必要があります。プロジェクトの作成後に名前を変更することはできません。

名前は次の要件を満たしている必要があります。

  • 小文字、数字、ハイフン(-)、およびアンダースコア(_)を含めることができます。

  • 小文字で始まり、小文字または数字で終わる必要があります。

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

--ttl

Integer

いいえ

30

データの保存期間。単位:日。有効値:1 ~ 3650。このパラメーターを 3650 に設定すると、データは永続的に保存されます。指定した保存期間が経過すると、ログデータは削除されます。

ttl パラメーターで指定されたデータ保持期間は、次の時間の値の合計です。

  • hot_ttl パラメーターで指定されるホット ストレージ層のデータ保存期間

  • infrequent_access_ttl パラメーターで指定される、低頻度アクセス(IA)ストレージ層のデータ保存期間

  • アーカイブストレージ層のデータ保存期間

重要

保存期間を変更すると、Simple Log Service は 1 時間以内にすべての期限切れデータを削除します。 Simple Log Service コンソールのホームページの利用状況の詳細に表示されるデータ量は、翌日更新されます。たとえば、保存期間を 5 日から 1 日に変更すると、Simple Log Service は 1 時間以内に過去 4 日間のログデータを削除します。

--shard_count

Integer

いいえ

2

シャードの数。有効値:1 ~ 10。詳細については、「MD5 値の範囲」をご参照ください。

重要

update_logstore コマンドを実行してシャードの数を変更することはできません。シャードの数を変更するには、SplitShard および MergeShard 操作を呼び出すことができます。

--enable_tracking

Boolean

いいえ

true

Web トラッキング機能を有効にするかどうかを指定します。有効値:

  • true

  • false

--append_meta

Boolean

いいえ

false

パブリック IP アドレスを記録するかどうかを指定します。有効値:

  • true

  • false

--auto_split

Boolean

いいえ

true

自動シャーディングを有効にするかどうかを指定します。有効値:

  • true

  • false

--max_split_shard

Integer

いいえ

64

既存のシャードを自動的に分割できる最大シャード数。有効値:1 ~ 256。--autoSplittrue に設定する場合は、このパラメーターを指定する必要があります。

--encrypt_conf

String

いいえ

None

暗号化構成のデータ構造。

詳細については、「EncryptConf」をご参照ください。

--telemetry_type

String

いいえ

None

可観測性データのタイプ。有効値:

  • None(デフォルト):ログ

  • Metrics:メトリック

--hot_ttl

Integer

いいえ

7

ホット ストレージ層のデータ保存期間。単位:日。最小値は 7 で、最大値は ttl パラメーターを超えることはできません。このパラメーターを -1 に設定すると、すべてのデータがホット ストレージ層に保存されます。

ホットストレージ層に指定されたデータ保存期間が経過すると、データは IA ストレージ層に移動されます。ストレージ層とストレージ層間のデータの移動の詳細については、「インテリジェント階層型ストレージを構成する」をご参照ください。

  • ホットストレージ層のデータは、IA ストレージ層に移動する前に少なくとも 7 日間保存する必要があります。 IA ストレージ層のデータは、アーカイブストレージ層に移動する前に少なくとも 30 日間保存する必要があります。

  • ホットストレージ層のデータは、アーカイブストレージ層に移動する前に少なくとも 30 日間保存する必要があります。

--mode

String

いいえ

standard

ログストアのタイプ。Simple Log Service は、標準ログストアとクエリログストアの 2 種類のログストアを提供します。有効値:

  • standard:標準ログストア。このタイプのログストアはログ分析機能をサポートしており、リアルタイムモニタリングやインタラクティブ分析などのシナリオに適しています。このタイプのログストアを使用して、包括的な可観測性システムを構築することもできます。

  • query:クエリログストア。このタイプのログストアは高パフォーマンスクエリをサポートしています。クエリログストアのインデックストラフィック料金は、標準ログストアの約半分です。クエリログストアは SELECT 文をサポートしていません。クエリログストアは、データ量が大きく、ログ保存期間が長い、またはログ分析が不要なシナリオに適しています。ログが数週間または数か月間保存される場合、ログ保存期間は長いと見なされます。詳細については、「付録:タイプ別ログストア比較」をご参照ください。

--infrequent_access_ttl

Integer

いいえ

30

IA ストレージ層のデータ保存期間。単位:日。IA ストレージ層のデータは、アーカイブストレージ層に移動する前に少なくとも 30 日間保存する必要があります。詳細については、「インテリジェント階層型ストレージを構成する」をご参照ください。

このコマンドのグローバルパラメーターの詳細については、「グローバルパラメーター」をご参照ください。

コマンド例

  • コマンド

    デフォルトアカウントを使用して、logstore-a に関する情報を更新します。

    aliyunlog log update_logstore --project_name="aliyun-test-project" --logstore_name="logstore-a" --ttl=30 --enable_tracking=true 
  • 出力

    コマンドが正常に実行された場合、応答は返されません。次のコマンドを実行して、ログストアの詳細をクエリできます。

    aliyunlog log get_logstore --project_name="aliyun-test-project" --logstore_name="logstore-a" --format-output=json

関連情報

  • API 操作の呼び出し後に Simple Log Service から返された応答にエラー情報が含まれている場合、呼び出しは失敗します。 API 呼び出しが失敗したときに返されるエラーコードに基づいてエラーを処理できます。詳細については、「エラーコード」をご参照ください。

  • Simple Log Service は、Alibaba Cloud SDK とも互換性があります。詳細については、Simple Log Service_SDK Center_Alibaba Cloud OpenAPI Explorer をご参照ください。

  • このコマンドに対応する API 操作の詳細については、「UpdateLogStore」をご参照ください。

  • Simple Log Service は、Java 用 Simple Log Service SDK および Python 用 Simple Log Service SDK を使用してログストアを管理するために使用されるサンプルコードを提供します。