DownloadSemanticResults - DataWorks - Alibaba Cloud Documentation Center

Deskripsi operasi

Skenario

Mengambil URL unduhan sementara untuk file hasil dari run pekerjaan semantik yang dikirimkan, seperti artefak YAML model semantik. Operasi ini mengembalikan URL unduhan dan tidak secara langsung mengembalikan konten file.

Prosedur

Gunakan nama pekerjaan JobName untuk mencari pekerjaan.
Untuk mengambil artefak dari run tertentu, tentukan JobRunId dari tanggapan RunSemanticJob.Data.JobRunId atau ListSemanticJobRuns. Jika Anda tidak menentukan parameter ini, artefak dari run terbaru akan dikembalikan.
Unduh file yang sesuai dari Data.Results[].DownloadUrl.

Sebelum Anda memulai

URL unduhan adalah kredensial sementara. Gunakan hanya sebentar di sisi klien. Jangan menulisnya ke log atau menyimpannya untuk penggunaan jangka panjang.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter	Type	Required	Description	Example
JobName	string	Yes	Nama pekerjaan. Anda dapat memperoleh nilai ini dari Data.Name dalam tanggapan CreateSemanticJob, Name dalam tanggapan ListSemanticJobs, atau JobName dalam tanggapan ListSemanticJobRuns.	semantic-job-demo
JobRunId	string	No	ID run opsional. Jika Anda menentukan JobRunId dari tanggapan RunSemanticJob (Data.JobRunId) atau tanggapan ListSemanticJobRuns, hanya artefak dari run yang ditentukan yang akan dikembalikan. Jika Anda tidak menentukan parameter ini, artefak dari run terbaru pekerjaan tersebut akan dikembalikan.	01H00000000000000000000000

Susun parameter permintaan berdasarkan deskripsi setiap bidang permintaan.

Elemen respons

Element	Type	Description	Example
	object	Tanggapan standar untuk mengambil URL unduhan artefak run. Setiap item dalam Data.Results berkorespondensi dengan sebuah file hasil.
RequestId	string	ID permintaan. Anda dapat menggunakan ID ini untuk mencari log dan memecahkan masalah.	676271D6-53B4-57BE-89FA-72F7AE1418DF
Success	boolean	Menunjukkan apakah permintaan berhasil.
Data	object	Koleksi file hasil untuk run pekerjaan yang ditentukan. Beberapa item dikembalikan jika satu run menghasilkan beberapa file.
Results	array<object>	Daftar file hasil. Setiap item berisi nama pekerjaan terkait, ID run, dan URL unduhan berumur pendek.
	object	File hasil yang dihasilkan oleh run pekerjaan semantik.
JobName	string	Nama node tempat artefak berada. Nilai ini sama dengan nilai JobName dalam permintaan.	semantic-job-demo
JobRunId	string	ID run tempat artefak berada. Anda dapat membandingkan nilai ini dengan nilai Data.JobRunId dari tanggapan RunSemanticJob atau nilai JobRunId dari ListSemanticJobRuns.	01H00000000000000000000000
DownloadUrl	string	URL unduhan pra-tanda tangan sementara untuk file hasil. Unduh file menggunakan permintaan HTTP GET sesegera mungkin. Jangan mencatat (log), membagikan, atau memperlakukan URL lengkap sebagai alamat jangka panjang.	https://example.com/temporary-download-url

Untuk arti setiap bidang tanggapan dan hubungannya dengan panggilan berikutnya, lihat deskripsi bidang.

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.