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

Simple Log Service:UpdateLogStore

最終更新日:Jul 24, 2026

Logstore の属性を更新します。

操作説明

操作の説明

  • Logstore を更新する前に、GetLogStore オペレーションを呼び出して現在の Logstore 構成を取得してください。必要に応じて構成を変更し、UpdateLogStore オペレーションのパラメーターとして渡します。

  • リクエスト構文の Host は、プロジェクト名と Simple Log Service エンドポイントで構成されます。Host にプロジェクトを指定してください。

  • AccessKey ペアが作成され、取得されていること。詳細については、「AccessKey ペア」をご参照ください。

Alibaba Cloud アカウントの AccessKey ペアは、すべての API オペレーションに対するアクセス権限を持ちます。これはセキュリティリスクが高いため、RAM ユーザーを作成して使用し、API オペレーションの呼び出しや日常的な O&M を実行することを推奨します。RAM ユーザーには、Simple Log Service EPS リソースに対する必須の権限が付与されている必要があります。詳細については、「RAM ユーザーの作成と権限付与」をご参照ください。

  • クエリを実行するログのプロジェクト名、リージョン、および Logstore 名を確認していること。詳細については、「プロジェクトの管理」および「Logstore の管理」をご参照ください。

このオペレーションを呼び出すと、操作ログが生成されます。

認可リソース

次の表に、この API オペレーションの認可情報を示します。この情報を RAM アクセスポリシーの文の Action 要素に追加することで、RAM ユーザーまたは RAM ロールにこの API オペレーションを呼び出す権限を付与できます。

ActionResource
log:UpdateLogStoreacs:log:{#regionId}:{#accountId}:project/{#ProjectName}/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:UpdateLogStore

update

*LogStore。

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

  • log:TLSVersion
  • log:Encrypted
なし

リクエスト構文

PUT /logstores/{logstore} HTTP/1.1

パスパラメーター

パラメーター

型

必須 / 任意

説明

例

logstore

string

必須

Logstore の名前。

test-logstore。

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

project

string

必須

プロジェクトの名前。

ali-test-project

body

object

必須

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

logstoreName

string

必須

Logstore の名前。

test-logstore。

shardCount deprecated

integer

任意

シャードの数。

説明

この操作ではシャード数の更新はサポートされていません。シャード数を変更するには、SplitShard または MergeShards オペレーションを呼び出す必要があります。

2

ttl

integer

必須

データの保持期間。単位: 日。有効な値: 1~3650。3650 は永久保持を示します。

30

encrypt_conf EncryptConf

任意

暗号化構成。デフォルトでは暗号化は無効です。

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

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

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

{
    "enable": true,
    "encrypt_conf": "default",
    "user_cmk_info": {
        "cmk_key_id": "xxxxx",
        "arn": "acs:ram::112340000000:role/rolename",
        "region": "ap-southeast-1"
    }
}

autoSplit

boolean

任意

自動シャーディングを有効にするかどうかを指定します。この特徴を有効にすると、書き込みトラフィックが継続的に制限を超えた場合にシャードが自動的に分割され、書き込み容量が向上します。自動シャーディングを有効にする場合は、maxSplitShard (分割後の最大シャード数) をセットする必要があります。

true。

enable_tracking

boolean

任意

WebTracking 特徴を有効にするかどうかを指定します。デフォルト値: false。WebTracking 特徴を使用すると、ブラウザやミニプログラムにおけるユーザーの動作データ (ページビュー、購入 Record、サイト滞在時間など) を収集・分析できます。

  • true: WebTracking を有効にします。

  • false: WebTracking を無効にします。

false。

appendMeta

boolean

任意

パブリック IP アドレスとログ到着時間を記録するかどうかを指定します。デフォルト値: false。

  • true: 特徴を有効にします。この特徴を有効にすると、Simple Log Service はログソースデバイスのパブリック IP アドレスとログがサーバーに到着した時間をログの Tag フィールドに自動的に追加します。

  • false: 特徴を無効にします。

false。

maxSplitShard

integer

任意

自動シャーディングの最大シャード数。最小値: 1。最大値: 256。

説明

autoSplit が true に設定されている場合、このパラメーターは必須です。

64

telemetryType deprecated

string

任意

観測可能なデータのタイプ。デフォルト値はログデータです。有効な値:

  • None: ログデータ。これがデフォルト値です。

  • Metrics: 時系列データ。

None。

hot_ttl

integer

任意

Logstore のホットティアにおけるデータの保持期間。単位: 日。最小値: 7。この値は ttl の値を超えることはできません。デフォルトでは、保持期間内のすべてのデータがホットティアのデータストレージに保存されます。

データのストレージ時間が設定されたホットデータ保持期間を超えると、データは低頻度アクセス (IA) ティアに移動されます。IA ティアを有効にする場合、ホットデータ保持期間は少なくとも 7 日間である必要があります。詳細については、「インテリジェントティアリング」をご参照ください。

例:

  • シナリオ 1 (ホットティアのみ、30 日間): {"ttl": 30} または {"ttl": 30, "hot_ttl": 30}

  • シナリオ 2 (ホットティア 7 日間、IA ティア 23 日間): {"ttl": 30, "hot_ttl": 7}

60

mode

string

任意

Simple Log Service には、標準 と Query の 2 種類の Logstore があります。

  • standard: Simple Log Service のワンストップデータ分析機能をサポートします。リアルタイムモニタリング、インタラクティブな分析、完全な可観測性システムの構築などのシナリオに適しています。

  • query: 高パフォーマンスのクエリをサポートします。インデックストラフィック料金は 標準 タイプの約半分ですが、SQL 分析はサポートされていません。データ量が large で、ストレージ期間が長く (数週間または数か月)、ログ分析の要件がないシナリオに適しています。

standard。

infrequentAccessTTL

integer

任意

低頻度アクセス (IA) ティア。最小保存時間は必須ではありません。アーカイブ層に移動される前に、データを少なくとも 30 日間保存する必要があります。

ログ保持期間がホットティア保持期間と IA ティア保持期間の合計を超えた場合、残りの保存時間はアーカイブ層ストレージに変換されます。

例:

  • シナリオ 1 (ホットティア 7 日間、IA ティア 23 日間): {"ttl": 30, "hot_ttl": 7}

  • シナリオ 2 (ホットティア 7 日間、IA ティア 30 日間、アーカイブ層 60 日間): {"ttl": 97, "hot_ttl": 7, "infrequentAccessTTL": 30}

  • シナリオ 3 (ホットティア 60 日間、IA ティア 0 日間、アーカイブ層 60 日間): {"ttl": 120, "hot_ttl": 60, "infrequentAccessTTL": 0}

30

shardingPolicy ShardingPolicy

任意

ハッシュベースの書き込み構成。データ書き込み時に、構成されたハッシュポリシーに基づいてログがシャードにルーティングされます。このパラメーターを構成する前に、シャードのハッシュ範囲が均等に分散されていることを確認してください。この構成は書き込み容量に影響を与える可能性があるため、慎重に実行してください。

レスポンスフィールド

フィールド

型

説明

例

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

例

成功レスポンス

JSONJSON

{}

エラーコード

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

変更履歴

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