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

Logstore を作成します。

操作説明

権限付与

リクエスト構文の Host は、プロジェクト名と Simple Log Service のエンドポイントで構成されます。Host にはプロジェクトを指定します。
AccessKey ペアを作成します。詳細については、「AccessKey ペア」をご参照ください。

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

プロジェクト名とプロジェクトが所在するリージョンを取得します。詳細については、「プロジェクトの管理」をご参照ください。
各プロジェクトには、最大 200 個の Logstore を含めることができます。
指定されたデータ保存期間を過ぎると、ログは削除されます。

認可

次の表では、この操作に必要な権限について説明します。RAM ユーザーまたは RAM ロールにこの操作を呼び出す権限を付与するには、この情報を RAM ポリシーの Action 要素に追加します。

Action	権限付与ポリシーでのリソース記述
`log:CreateLogStore`	`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:CreateLogStore

create

*LogStore

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

log:TLSVersion
log:Encrypted

なし

リクエスト構文

POST /logstores HTTP/1.1

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
project	string	必須	プロジェクトの名前。	ali-test-project
body	object	必須	リクエストパラメーター。
logstoreName	string	必須	Logstore の名前。名前は次の要件を満たす必要があります：名前はプロジェクト内で一意である必要があります。小文字、数字、ハイフン (-)、アンダースコア (_) のみ使用できます。先頭と末尾は小文字または数字である必要があります。長さは 2～63 文字である必要があります。	my-logstore
shardCount	integer	必須	シャードの数。説明この操作ではシャードの数を変更できません。シャードの数を変更するには、`SplitShard` または `MergeShards` 操作を呼び出します。	2
ttl	integer	必須	データ保持期間 (日数)。有効値：1～3650。値を 3650 に設定すると、データは永続的に保存されます。	1
encrypt_conf	EncryptConf	任意	暗号化設定のデータ構造。パラメーターには、`enable`、`encrypt_type`、`user_cmk_info` が含まれます。詳細については、「EncryptConf」をご参照ください。
autoSplit	boolean	任意	シャードを自動的に分割するかどうかを指定します。 true：シャードを自動的に分割します。 false：シャードを自動的に分割しません。	true
enable_tracking	boolean	任意	ウェブトラッキングを有効にするかどうかを指定します。デフォルト値：false。 true：ウェブトラッキングを有効にします。 false：ウェブトラッキングを無効にします。	false
maxSplitShard	integer	任意	自動分割によって作成できるシャードの最大数。値は 1～256 の範囲である必要があります。説明このパラメーターは、autoSplit パラメーターを true に設定した場合に必須です。	64
appendMeta	boolean	任意	クライアントのパブリック IP アドレスとログ受信時間を記録するかどうかを指定します。デフォルト値は false です。 true：クライアントのパブリック IP アドレスとログ受信時間を記録します。この機能を有効にすると、Simple Log Service はログソースのパブリック IP アドレスとログ受信のサーバー時間をログのタグフィールドに自動的に追加します。 false：クライアントのパブリック IP アドレスまたはログ受信時間を記録しません。	false
telemetryType	string	任意	可観測性データのタイプ。有効値： None：ログデータ。これがデフォルト値です。 Metrics：メトリック。	None
hot_ttl	integer	任意	Logstore のホットストレージ層でのデータ保持期間 (日数)。最小値は 7 です。値は `ttl` の値を超えることはできません。このパラメーターを -1 に設定すると、データはホット層に永続的に保存されます。ホット層の保持期間が過ぎると、データは低頻度アクセス (IA) ストレージクラスに移動します。詳細については、「自動ストレージ階層化」をご参照ください。	60
mode	string	任意	Logstore モード。 Simple Log Service は、標準モードとクエリモードの 2 つのモードを提供します。 standard：包括的なデータ分析をサポートします。このモードは、リアルタイムモニタリング、対話型分析、完全な可観測性システムの構築などのユースケースに適しています。 query：高性能クエリをサポートします。このモードのインデックスのトラフィックコストは、標準モードの約半分です。このモードは SQL 分析をサポートしていません。大量のデータ、長い保持期間、ログ分析の要件がないユースケースに適しています。	standard
infrequentAccessTTL	integer	任意	低頻度アクセス (IA) ストレージクラスでのデータ保持期間 (日数)。値は 30 以上である必要があります。	30
processorId	string	任意	インジェストプロセッサの ID。	processor-nginx-parser-001
shardingPolicy	ShardingPolicy	任意	ハッシュベースの書き込みの設定。
resourceGroupId	string	任意	リソースグループの ID。

レスポンスフィールド

フィールド

型

説明

例

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

例

成功レスポンス

JSONJSON

{}

エラーコード

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

変更履歴

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