UpdateLogStore - - Alibaba Cloud ドキュメントセンター

Logstore のプロパティを更新します。

操作説明

注意事項

Logstore を更新する前に、GetLogStore を呼び出して元の設定を取得します。設定を変更し、パラメーターとして UpdateLogStore に渡します。
リクエスト構文の Host は、プロジェクト名と Simple Log Service のエンドポイントで構成されます。Host にはプロジェクトを指定する必要があります。
AccessKey ペアを作成して取得する必要があります。詳細については、「AccessKey ペア」をご参照ください。

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

プロジェクト名、そのリージョン、および Logstore の名前を取得する必要があります。詳細については、「プロジェクトの管理」および「Logstore の管理」をご参照ください。

権限付与

次の表に、この操作の権限付与情報を示します。RAM ユーザーまたは RAM ロールにこの API の呼び出し権限を付与するには、この情報を RAM ポリシーの Action 要素に追加します。

Action	権限付与ポリシーでのリソース記述
`log:UpdateLogStore`	`acs: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	任意	暗号化設定のデータ構造。
autoSplit	boolean	任意	シャードを自動的に分割するかどうかを指定します。 true：シャードを自動的に分割します。 false：シャードを自動的に分割しません。	true
enable_tracking	boolean	任意	Web トラッキングを有効にするかどうかを指定します。デフォルト値は false です。 true：Web トラッキングを有効にします。 false：Web トラッキングを有効にしません。	false
appendMeta	boolean	任意	パブリック IP アドレスを記録するかどうかを指定します。デフォルト値は false です。 true：パブリック IP アドレスを記録します。 false：パブリック IP アドレスを記録しません。	false
maxSplitShard	integer	任意	シャードを分割できる最大シャード数。有効値：1～256。説明このパラメーターは、autoSplit が true に設定されている場合に必須です。	64
telemetryType `deprecated`	string	任意	可観測性データのタイプ。有効値： None：ログ。これはデフォルト値です。 Metrics：メトリック。	None
hot_ttl	integer	任意	Logstore のホットストレージレイヤーのデータ保持期間。最小値は 7 です。単位：日。有効値：7～3000。ホットストレージレイヤーの保持期間が終了すると、データは低頻度アクセスストレージクラスに変換されます。詳細については、「ホット/コールドデータの階層型ストレージ」をご参照ください。	60
mode	string	任意	Simple Log Service は、標準とクエリの 2 種類の Logstore を提供します。 standard：ワンストップのデータ分析をサポートします。このタイプの Logstore は、リアルタイムモニタリング、インタラクティブ分析、完全な可観測性システムの構築などのシナリオに適しています。 query：パフォーマンス専有型のクエリをサポートします。クエリ Logstore のインデックストラフィックコストは、標準 Logstore の約半分です。ただし、クエリ Logstore は SQL 分析をサポートしていません。このタイプの Logstore は、大量のデータ、数週間または数か月の長いストレージ期間、およびログ分析の要件がないシナリオに適しています。	standard
infrequentAccessTTL	integer	任意	低頻度アクセスストレージクラス。このストレージクラスのデータには最小保持期間がありません。データをアーカイブストレージに変換するには、少なくとも 30 日間保存する必要があります。	30
shardingPolicy	ShardingPolicy	任意

レスポンスフィールド

フィールド

型

説明

例

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

例

成功レスポンス

JSONJSON

{}

エラーコード

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

変更履歴

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