フィルターAPIの作成

フィルターをインスタンス化します。

リクエスト

PUT _ml/filters/<filter_id>

前提条件

manage_ml クラスター権限が必要です。この権限は machine_learning_admin ビルトインロールに含まれています。

説明

フィルターは文字列のリストを含みます。1つ以上のジョブで使用できます。具体的には、フィルターは検出器設定オブジェクトの custom_rules プロパティで参照されます。詳細については、カスタムルールを参照してください。

パスパラメータ

  • <filter_id>
  • （必須、文字列）フィルターを一意に識別する文字列。

リクエストボディ

  • description
  • （オプション、文字列）フィルターの説明。
  • items
  • （必須、文字列の配列）フィルターの項目。ワイルドカード * は項目の先頭または末尾に使用できます。各フィルターには最大10000項目が許可されています。

例

Python

  1. resp = client.ml.put_filter(
  2.    filter_id="safe_domains",
  3.    description="A list of safe domains",
  4.    items=[
  5.    "*.google.com",
  6.    "wikipedia.org"
  7.    ],
  8. )
  9. print(resp)

Ruby

  1. response = client.ml.put_filter(
  2.   filter_id: 'safe_domains',
  3.   body: {
  4.    description: 'A list of safe domains',
  5.    items: [
  6.    '*.google.com',
  7.    'wikipedia.org'
  8.    ]
  9.   }
  10. )
  11. puts response

Js

  1. const response = await client.ml.putFilter({
  2.   filter_id: "safe_domains",
  3.   description: "A list of safe domains",
  4.   items: ["*.google.com", "wikipedia.org"],
  5. });
  6. console.log(response);

コンソール

  1. PUT _ml/filters/safe_domains
  2. {
  3.   "description": "A list of safe domains",
  4.   "items": ["*.google.com", "wikipedia.org"]
  5. }

フィルターが作成されると、次のレスポンスが返されます：

コンソール-結果

  1. {
  2.   "filter_id": "safe_domains",
  3.   "description": "A list of safe domains",
  4.   "items": ["*.google.com", "wikipedia.org"]
  5. }