Logstore を作成します。
操作説明
注意事項
リクエストの Host ヘッダーは、プロジェクト名と Log Service のエンドポイントで構成されます。このヘッダーでプロジェクトを指定する必要があります。
AccessKey を作成して取得する必要があります。詳細については、「AccessKey」をご参照ください。
Alibaba Cloud アカウントの AccessKey ペアは、すべての API オペレーションに対する完全な権限を持つため、セキュリティリスクが生じます。セキュリティを強化するため、API オペレーションの呼び出しや日常的な運用保守には、RAM ユーザーを使用することを強く推奨します。RAM ユーザーに Log Service のリソースを管理するための権限を付与する必要があります。詳細については、「RAM ユーザーの作成と権限付与」をご参照ください。
-
Logstore を作成するプロジェクトの名前とリージョンを確認してください。詳細については、「プロジェクトの管理」をご参照ください。
-
1 つのプロジェクトに最大 200 個の Logstore を作成できます。
-
Log Service は、指定したデータ保持期間が経過すると、ログを自動的に削除します。
権限付与
次の表は、この API を呼び出すために必要な権限を示しています。RAM ユーザーまたは RAM ロールにこの権限を付与するには、対応する Action を RAM ポリシーのステートメントに追加してください。
| Action | Resource |
log:CreateLogStore | acs:log:{#regionId}:{#accountId}:project/{#project}/logstore/{#logstoreName} |
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
log:CreateLogStore |
create |
*LogStore
|
|
なし |
リクエスト構文
POST /logstores HTTP/1.1
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| project |
string |
必須 |
プロジェクトの名前です。 |
ali-test-project |
| body |
object |
必須 |
リクエストボディのパラメーターです。 |
|
| logstoreName |
string |
必須 |
Logstore の名前です。名前は次の要件を満たす必要があります。
|
my-logstore |
| shardCount |
integer |
必須 |
シャード数です。 説明
この操作ではシャード数を更新できません。更新するには、SplitShard または MergeShards API を呼び出す必要があります。 |
2 |
| ttl |
integer |
必須 |
データ保持期間 (日) です。有効な値は 1~3,650 です。3,650 に設定した場合、データは永続的に保存されます。 |
1 |
| encrypt_conf | EncryptConf |
任意 |
暗号化設定です。このデータ構造には、 例 1:デフォルト暗号化を有効にする場合
例 2:BYOK 暗号化を有効にする場合 |
|
| autoSplit |
boolean |
任意 |
自動シャード分割を有効にするかどうかを指定します。このパラメーターを true に設定すると、シャードへの書き込みトラフィックが継続的にサービス制限を超過した場合、Log Service は書き込みスループットを向上させるためにシャードを自動的に分割します。自動シャード分割を有効にする場合は、 |
true |
| enable_tracking |
boolean |
任意 |
ウェブトラッキングを有効にするかどうかを指定します。デフォルト値は false です。この機能を使用すると、ページビュー、購入履歴、滞在時間など、ブラウザーまたはミニプログラムからユーザー行動データを収集して分析できます。 |
false |
| maxSplitShard |
integer |
任意 |
自動分割後のシャードの最大数です。値は 1~256 の整数である必要があります。 説明
|
64 |
| appendMeta |
boolean |
任意 |
ソースのパブリック IP アドレスとサーバー受信時刻を記録するかどうかを指定します。デフォルト値は false です。
|
false |
| telemetryType |
string |
任意 |
可観測データの種類です。有効な値は次のとおりです。
|
None |
| hot_ttl |
integer |
任意 |
Logstore のホットストレージ層におけるデータの保持期間 (日) です。値は 7 から ホットストレージの保持期間が終了すると、データは低頻度アクセス (IA) ストレージ層に移動します。IA ストレージを有効にするには、ホットストレージの保持期間を少なくとも 7 日に設定する必要があります。詳細については、「Smart Tiered Storage」をご参照ください。 例:
|
60 |
| mode |
string |
任意 |
Log Service では、standard と query の 2 種類の Logstore を提供しています。
|
standard |
| infrequentAccessTTL |
integer |
任意 |
低頻度アクセス (IA) ストレージの保持期間 (日) です。このパラメーターに最小値はありませんが、データをアーカイブストレージに移動する前に、少なくとも 30 日間は IA ストレージ層に保持する必要があります。 合計保持期間 ( 例:
|
30 |
| processorId |
string |
任意 |
IngestProcessor の ID です。 |
processor-nginx-parser-001 |
| shardingPolicy | ShardingPolicy |
任意 |
ハッシュベースの書き込み設定です。データを書き込むと、ログは設定したシャーディングポリシーに基づいて選択されたシャードに保存されます。このパラメーターを設定する前に、シャードのハッシュ範囲が均等に分散していることを確認してください。不適切な設定は書き込みパフォーマンスに影響を及ぼす可能性があるため、慎重に設定してください。 |
|
| resourceGroupId |
string |
任意 |
Logstore が属するリソースグループの ID です。 |
rg-xxxxxxxx |
| enableModify |
boolean |
任意 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
レスポンスフィールドがありません。
例
成功レスポンス
JSONJSON
{}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。