ログストアの基本情報を更新します。
使用方法
この CLI コマンドを実行する前に、以下の条件が満たされていることを確認してください。
Simple Log Service がアクティブ化されていること。詳細については、「Simple Log Service を使い始めるにはどうすればよいですか?」をご参照ください。
Simple Log Service CLI がインストールおよび構成されていること。詳細については、「Simple Log Service CLI をインストールする」および「Simple Log Service CLI を構成する」をご参照ください。
プロジェクトとログストアが作成されていること。詳細については、「create_project」および「create_logstore」をご参照ください。
コマンド構文
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 | ログストアの名前。名前はグローバルに一意である必要があります。プロジェクトの作成後に名前を変更することはできません。 名前は次の要件を満たしている必要があります。
|
--ttl | Integer | いいえ | 30 | データの保存期間。単位:日。有効値:1 ~ 3650。このパラメーターを 3650 に設定すると、データは永続的に保存されます。指定した保存期間が経過すると、ログデータは削除されます。 ttl パラメーターで指定されたデータ保持期間は、次の時間の値の合計です。
重要 保存期間を変更すると、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 トラッキング機能を有効にするかどうかを指定します。有効値:
|
--append_meta | Boolean | いいえ | false | パブリック IP アドレスを記録するかどうかを指定します。有効値:
|
--auto_split | Boolean | いいえ | true | 自動シャーディングを有効にするかどうかを指定します。有効値:
|
--max_split_shard | Integer | いいえ | 64 | 既存のシャードを自動的に分割できる最大シャード数。有効値:1 ~ 256。--autoSplit を true に設定する場合は、このパラメーターを指定する必要があります。 |
--encrypt_conf | String | いいえ | None | 暗号化構成のデータ構造。 詳細については、「EncryptConf」をご参照ください。 |
--telemetry_type | String | いいえ | None | 可観測性データのタイプ。有効値:
|
--hot_ttl | Integer | いいえ | 7 | ホット ストレージ層のデータ保存期間。単位:日。最小値は 7 で、最大値は ttl パラメーターを超えることはできません。このパラメーターを -1 に設定すると、すべてのデータがホット ストレージ層に保存されます。 ホットストレージ層に指定されたデータ保存期間が経過すると、データは IA ストレージ層に移動されます。ストレージ層とストレージ層間のデータの移動の詳細については、「インテリジェント階層型ストレージを構成する」をご参照ください。
|
--mode | String | いいえ | standard | ログストアのタイプ。Simple Log Service は、標準ログストアとクエリログストアの 2 種類のログストアを提供します。有効値:
|
| 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 を使用してログストアを管理するために使用されるサンプルコードを提供します。