メインコンテンツまでスキップ

Spark ジョブの詳細取得 (V2)

This operation describes a Spark job in a specified project.

GET/v2/projects/{projectId}/jobs/{jobId}
接続エンドポイント

https://api.cloud.zilliz.com

shell
export BASE_URL="https://api.cloud.zilliz.com"
パラメータ
Authorizationstringheader必要

認証トークンは、適切な権限を持つ API キーである必要があります。

値の例： Bearer {{TOKEN}}
projectIdstringpath必要

プロジェクト ID。

値の例： proj-xxxxxxxxxxxxxxxxxxx
jobIdstringpath必要

Spark ジョブ ID。

値の例： job-xxxxxxxxxxxxxxxxxx
bash
export TOKEN="YOUR_API_KEY"
export projectId="proj-xxxxxxxxxxxxxxxxxxx"
export jobId="job-xxxxxxxxxxxxxxxxxx"

curl --request GET \
--url "${BASE_URL}/v2/projects/${projectId}/jobs/${jobId}" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json"
レスポンス200 OK - application/json

Spark ジョブの詳細を返します。

codeinteger

レスポンスコード。

dataobject

Spark ジョブの詳細を含むレスポンスペイロード。

jobIdstring必要

ジョブ ID。

projectIdstring必要

ジョブが属するプロジェクト ID。

typestring必要

ジョブタイプ。

descriptionstring

ジョブの説明。

statusstring必要

ジョブのステータス。

regionIdstring必要

クラウドリージョン ID。

clusterIdstring

クラスター ID。

artifactobject

ジョブによって生成された出力アーティファクト。

volumeNamestring必要

アーティファクトが保存されているボリューム名。

pathstring必要

ボリューム内のアーティファクトのパス。

detailsobject

バックフィルジョブの詳細。

dbNamestring

データベース名。

collectionNamestring

コレクション名。

inputobject

ジョブの入力または出力データへの参照。

typestring

データ参照タイプ。

volumeNamestring

ボリューム名。

pathstring

ボリューム内のデータパス。

formatstring

データ形式。

fieldsarray

ターゲットフィールド。

[]fieldsstring
(近日追加予定)
columnMappingobject

ソースからターゲットへの列マッピング。

modestring

バックフィルモード。

resourceSizestring

リソースサイズ。

failureReasonobject

ジョブが失敗した理由。

codestring

エラーコード。

messagestring

エラーメッセージ。

retryableboolean

ジョブを再試行できるかどうか。

precheckReportobject

バックフィルジョブの事前チェックレポート。

passedboolean

事前チェックに合格したかどうか。

dbNamestring

データベース名。

collectionNamestring

コレクション名。

inputstring

入力の説明。

fieldsarray

ターゲットフィールド。

[]fieldsstring
(近日追加予定)
columnMappingobject

ソースからターゲットへの列マッピング。

requiredSourceColumnsarray

必須のソース列。

[]requiredSourceColumnsstring
(近日追加予定)
errorsarray

事前チェックエラー。

[]errorsobject

単一の事前チェックエラー。

codestring

エラーコード。

sourceColumnstring

ソース列。

targetFieldstring

ターゲットフィールド。

expectedTypestring

期待されるタイプ。

actualTypestring

実際のタイプ。

messagestring

エラーメッセージ。

checkedRowsinteger<int64>

チェックされた行数。

createdAtstring

作成時刻 (ISO 8601)。

submittedAtstring

送信時刻 (ISO 8601)。

startedAtstring

開始時刻 (ISO 8601)。

finishedAtstring

終了時刻 (ISO 8601)。

durationSecondsinteger<int64>

秒単位の所要時間。

エラーメッセージを返します。

codeinteger

レスポンスコード。

messagestring

エラーメッセージ。

Successjson
{
    "code": 0,
    "data": {
        "jobId": "job-xxxxxxxxxxxxxxxxxx",
        "type": "SPARK",
        "description": "daily-vector-etl",
        "status": "RUNNING",
        "regionId": "aws-us-west-2",
        "clusterId": "in01-xxxxxxxxxxxxxxx",
        "createdAt": "2026-05-20T10:00:00Z",
        "startedAt": "2026-05-20T10:01:00Z",
        "finishedAt": null,
        "durationSeconds": 300,
        "artifact": {
            "volumeName": "stg-xxxxxxxxxxxxxxxxxxx",
            "path": "/jars/example-job.jar",
            "artifactUri": "volume://my-volume/jars/example-job.jar"
        },
        "submittedAt": "2026-05-20T10:00:30Z",
        "projectId": "proj-xxxxxxxxxxxxxxxxxxxx"
    }
}
Ctrl I