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

タスク名とオプションの実行 ID を指定して、実行完了後にアーティファクトのダウンロード URL を取得します。JobRunId が指定されていない場合は、そのタスクの最新の実行結果が返されます。

操作説明

シナリオ

送信された意味理解タスク実行の結果ファイル（意味理解モデル YAML アーティファクトなど）の一時的なダウンロード URL を取得します。この操作はダウンロード URL を返すものであり、ファイルの内容を直接返すものではありません。

手順

タスク名 JobName を使用してタスクを特定します。
特定の実行のアーティファクトを取得するには、RunSemanticJob.Data.JobRunId または ListSemanticJobRuns の応答から JobRunId を指定します。このパラメーターを指定しない場合、最新の実行のアーティファクトが返されます。
Data.Results[].DownloadUrl から対応するファイルをダウンロードします。

事前準備

ダウンロード URL は一時的な認証情報です。クライアント側でのみ短時間使用してください。ログに書き込んだり、長期間保存したりしないでください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
JobName	string	必須	タスク名。この値は、CreateSemanticJob 応答の Data.Name、ListSemanticJobs 応答の Name、または ListSemanticJobRuns 応答の JobName から取得できます。	semantic-job-demo
JobRunId	string	任意	オプションの実行 ID。RunSemanticJob 応答 (Data.JobRunId) または ListSemanticJobRuns 応答の JobRunId を指定すると、指定された実行のアーティファクトのみが返されます。このパラメーターを指定しない場合、タスクの最新の実行のアーティファクトが返されます。	01H00000000000000000000000

各リクエストフィールドの説明に基づいてリクエストパラメーターを構築します。

レスポンスフィールド

フィールド	型	説明	例
	object	実行アーティファクトのダウンロード URL を取得するための標準的な応答です。Data.Results の各項目は結果ファイルに対応します。
RequestId	string	リクエスト ID。この ID を使用してログを特定し、問題のトラブルシューティングを行えます。	676271D6-53B4-57BE-89FA-72F7AE1418DF
Success	boolean	リクエストが成功したかどうかを示します。
Data	object	指定されたタスク実行の結果ファイルのコレクション。単一の実行で複数のファイルが生成される場合、複数の項目が返されます。
Results	array<object>	結果ファイルのリスト。各項目には、関連するタスク名、実行 ID、および有効期限の短いダウンロード URL が含まれます。
	object	意味理解タスク実行によって生成された結果ファイル。
JobName	string	アーティファクトが属するノード名。この値はリクエスト内の JobName 値と同じです。	semantic-job-demo
JobRunId	string	アーティファクトが属する実行 ID。この値を RunSemanticJob 応答の Data.JobRunId 値または ListSemanticJobRuns の JobRunId 値と比較できます。	01H00000000000000000000000
DownloadUrl	string	結果ファイルの一時的な署名付きダウンロード URL。HTTP GET リクエストを使用して、できるだけ早くファイルをダウンロードしてください。完全な URL をログに記録したり、共有したり、長期的なアドレスとして扱ったりしないでください。	https://example.com/temporary-download-url

各応答フィールドの意味および後続の呼び出しとの関係については、フィールドの説明を参照してください。

例

成功レスポンス

JSONJSON

{
  "RequestId": "676271D6-53B4-57BE-89FA-72F7AE1418DF",
  "Success": false,
  "Data": {
    "Results": [
      {
        "JobName": "semantic-job-demo",
        "JobRunId": "01H00000000000000000000000",
        "DownloadUrl": "https://example.com/temporary-download-url"
      }
    ]
  }
}

エラーコード

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

変更履歴

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