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 オペレーションを呼び出す権限を付与できます。
| Action | Resource |
log:UpdateLogStore | acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#LogstoreName} |
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
log:UpdateLogStore |
update |
*LogStore。
|
|
なし |
リクエスト構文
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 (デフォルト暗号化を有効にする場合):
例 2 (BYOK 暗号化を有効にする場合): |
|
| autoSplit |
boolean |
任意 |
自動シャーディングを有効にするかどうかを指定します。この特徴を有効にすると、書き込みトラフィックが継続的に制限を超えた場合にシャードが自動的に分割され、書き込み容量が向上します。自動シャーディングを有効にする場合は、maxSplitShard (分割後の最大シャード数) をセットする必要があります。 |
true。 |
| enable_tracking |
boolean |
任意 |
WebTracking 特徴を有効にするかどうかを指定します。デフォルト値: false。WebTracking 特徴を使用すると、ブラウザやミニプログラムにおけるユーザーの動作データ (ページビュー、購入 Record、サイト滞在時間など) を収集・分析できます。
|
false。 |
| appendMeta |
boolean |
任意 |
パブリック IP アドレスとログ到着時間を記録するかどうかを指定します。デフォルト値: false。
|
false。 |
| maxSplitShard |
integer |
任意 |
自動シャーディングの最大シャード数。最小値: 1。最大値: 256。 説明
autoSplit が true に設定されている場合、このパラメーターは必須です。 |
64 |
telemetryType
deprecated
|
string |
任意 |
観測可能なデータのタイプ。デフォルト値はログデータです。有効な値:
|
None。 |
| hot_ttl |
integer |
任意 |
Logstore のホットティアにおけるデータの保持期間。単位: 日。最小値: 7。この値は ttl の値を超えることはできません。デフォルトでは、保持期間内のすべてのデータがホットティアのデータストレージに保存されます。 データのストレージ時間が設定されたホットデータ保持期間を超えると、データは低頻度アクセス (IA) ティアに移動されます。IA ティアを有効にする場合、ホットデータ保持期間は少なくとも 7 日間である必要があります。詳細については、「インテリジェントティアリング」をご参照ください。 例:
|
60 |
| mode |
string |
任意 |
Simple Log Service には、標準 と Query の 2 種類の Logstore があります。
|
standard。 |
| infrequentAccessTTL |
integer |
任意 |
低頻度アクセス (IA) ティア。最小保存時間は必須ではありません。アーカイブ層に移動される前に、データを少なくとも 30 日間保存する必要があります。 ログ保持期間がホットティア保持期間と IA ティア保持期間の合計を超えた場合、残りの保存時間はアーカイブ層ストレージに変換されます。 例:
|
30 |
| shardingPolicy | ShardingPolicy |
任意 |
ハッシュベースの書き込み構成。データ書き込み時に、構成されたハッシュポリシーに基づいてログがシャードにルーティングされます。このパラメーターを構成する前に、シャードのハッシュ範囲が均等に分散されていることを確認してください。この構成は書き込み容量に影響を与える可能性があるため、慎重に実行してください。 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
レスポンスフィールドがありません。
例
成功レスポンス
JSONJSON
{}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。