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

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

操作説明

注意事項

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

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

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

権限付与

次の表に、この操作に必要な権限付与を示します。RAM ユーザーまたは RAM ロールにこの操作を呼び出す権限を付与するには、RAM ポリシーの 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	任意	ウェブトラッキングを有効にするかどうかを指定します。デフォルト値：false。 true：ウェブトラッキングを有効にします。 false：ウェブトラッキングを有効にしません。	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。ホット層の保持期間が終了すると、データは低頻度アクセス (IA) ストレージクラスに移動します。詳細については、「ストレージ階層化」をご参照ください。	60
mode	string	任意	SLS は、標準とクエリの 2 種類の Logstore を提供します。 standard：ワンストップのデータ分析をサポートします。このタイプの Logstore は、リアルタイムモニタリング、インタラクティブ分析、完全な可観測性システムの構築などのシナリオに適しています。 query：高性能クエリをサポートします。クエリ Logstore のインデックストラフィックコストは、標準 Logstore の約半分です。ただし、クエリ Logstore は SQL 分析をサポートしていません。このタイプの Logstore は、大量のデータ、数週間または数か月の長い保持期間を伴い、ログ分析を行わないシナリオに適しています。	standard
infrequentAccessTTL	integer	任意	IA ストレージクラスのデータの保持期間。このストレージクラスのデータには最小保持期間はありません。データは、アーカイブストレージに移動される前に、少なくとも 30 日間保存する必要があります。	30
shardingPolicy	ShardingPolicy	任意	ハッシュベースの書き込み設定。

レスポンスフィールド

フィールド

型

説明

例

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

例

成功レスポンス

JSONJSON

{}

エラーコード

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

変更履歴

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