すべてのプロダクト
Search

このプロダクト

    Simple Log Service:update_logstore

    ドキュメントセンター

    Simple Log Service:update_logstore

    最終更新日:Sep 05, 2024

    Logstoreに関する基本情報を更新します。

    使用上の注意

    このLog Service 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

    プロジェクトの名前。

    -- logstore_name

    String

    課金されます

    logstore-a

    ログストアの名前

    -- ttl

    Integer

    課金されません

    30

    データ保持期間。 単位：日 有効な値: 1 ~ 3650 このパラメーターを3650に設定すると、データは永続的に保存されます。

    -- shard_count

    Integer

    ×

    2

    シャードの数。

    重要

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

    -- enable_tracking

    ブール値

    課金されません

    true

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

    • true

    • false

    -- append_meta

    ブール値

    課金されません

    false

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

    • true

    • false

    -- auto_split

    ブール値

    課金されません

    true

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

    • true

    • false

    -- max_split_shard

    Integer

    課金されません

    64

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

    -- encrypt_conf

    String

    ✕

    なし

    暗号化設定のデータ構造。

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

    -- telemetry_type

    String

    ✕

    なし

    観測可能なデータの型。 有効な値：

    • なし (デフォルト): ログ

    • Metrics: metrics

    -- hot_ttl

    Integer

    課金されません

    60

    Logstoreのホットストレージ層のデータの保持期間。 単位：日 有効な値: 7 ~ 3000

    ホットデータの保持期間が -- hot_ttlで指定された期間を超えた場合、データは低頻度アクセス (IA) ストレージ層に保存されます。 詳細については、「インテリジェント階層ストレージの有効化」をご参照ください。

    -- mode

    String

    課金されません

    standard

    Logstoreのタイプ。 Log Serviceには、標準ログストアとクエリログストアの2種類のログストアがあります。 有効な値：

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

    • query: Logstoreを照会します。 このタイプのLogstoreは、高性能なクエリをサポートします。 クエリログストアのインデックストラフィック料金は、標準ログストアの約半分です。 クエリLogstoreはSQL分析をサポートしていません。 クエリログストアは、データ量が多い、ログの保持期間が長い、またはログ分析が不要なシナリオに適しています。 ログが数週間または数か月保存される場合、ログの保持期間は長いと見なされます。

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

    コマンドの例

    • コマンド

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

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

    • Output

      コマンドが正常に実行された場合、応答は返されません。 次のコマンドを実行して、Logstoreの詳細を照会できます。 

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

    関連ドキュメント

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

    • Alibaba Cloud OpenAPI Explorerは、デバッグ機能、SDK、サンプル、および関連ドキュメントを提供します。 OpenAPI Explorerを使用して、リクエストを手動でカプセル化したり署名したりすることなく、Log Service API操作をデバッグできます。 詳細については、をご覧ください。 OpenAPIポータル。

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

    • Log Serviceは、Log Service SDK for JavaおよびLog Service SDK for Pythonを使用してLogstoreを管理するために使用されるサンプルコードを提供します。 詳細については、「Log Service SDK For Javaを使用したLogstoreの管理」および「Simple Log Service SDK for Pythonを使用したLogstoreの管理」をご参照ください。