データフレーム分析ジョブの停止API
1つ以上のデータフレーム分析ジョブを停止します。
リクエスト
POST _ml/data_frame/analytics/<data_frame_analytics_id>/_stop
POST _ml/data_frame/analytics/<data_frame_analytics_id>,<data_frame_analytics_id>/_stop
POST _ml/data_frame/analytics/_all/_stop
前提条件
manage_ml
クラスター権限が必要です。この権限は machine_learning_admin
ビルトインロールに含まれています。
説明
データフレーム分析ジョブは、そのライフサイクルの間に複数回開始および停止できます。
カンマ区切りのデータフレーム分析ジョブのリストまたはワイルドカード式を使用して、1回のAPIリクエストで複数のデータフレーム分析ジョブを停止できます。_allを使用するか、*を
パスパラメータ
<data_frame_analytics_id>
- (必須、文字列) データフレーム分析ジョブの識別子。この識別子は小文字の英数字(a-zおよび0-9)、ハイフン、アンダースコアを含むことができます。英数字で始まり、英数字で終わる必要があります。
クエリパラメータ
allow_no_match
- (オプション、Boolean) リクエスト時の動作を指定します:
- ワイルドカード式を含み、一致するデータフレーム分析ジョブがない場合。
_all
文字列を含むか、識別子がない場合、一致がない場合。- ワイルドカード式を含み、部分一致のみがある場合。
デフォルト値はtrue
で、一致がない場合は空のdata_frame_analytics
配列を返し、部分一致がある場合は結果のサブセットを返します。このパラメータがfalse
の場合、一致がないか部分一致のみの場合、リクエストは404
ステータスコードを返します。
force
- (オプション、Boolean) trueの場合、データフレーム分析ジョブが強制的に停止されます。
timeout
- (オプション、時間単位) データフレーム分析ジョブが停止するまでの待機時間を制御します。デフォルトは20秒です。
例
次の例は、loganalytics
データフレーム分析ジョブを停止します:
Python
resp = client.ml.stop_data_frame_analytics(
id="loganalytics",
)
print(resp)
Ruby
response = client.ml.stop_data_frame_analytics(
id: 'loganalytics'
)
puts response
Js
const response = await client.ml.stopDataFrameAnalytics({
id: "loganalytics",
});
console.log(response);
コンソール
POST _ml/data_frame/analytics/loganalytics/_stop
データフレーム分析ジョブが停止すると、次の結果が得られます:
コンソール-結果
{
"stopped" : true
}