az quantum job

  • Pratinjau
  • Referensi

Catatan

Referensi ini adalah bagian dari ekstensi kuantum untuk Azure CLI (versi 2.41.0 atau lebih tinggi). Ekstensi akan secara otomatis menginstal pertama kali Anda menjalankan perintah az quantum job . Pelajari lebih lanjut tentang ekstensi.

Grup perintah 'quantum' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Mengelola pekerjaan untuk Azure Quantum.

Perintah

Nama Deskripsi Jenis Status
az quantum job cancel

Minta untuk membatalkan pekerjaan di Azure Quantum jika belum selesai.

 Ekstensi Pratinjau
az quantum job list

Dapatkan daftar pekerjaan di Ruang Kerja Quantum.

 Ekstensi Pratinjau
az quantum job output

Dapatkan hasil menjalankan pekerjaan.

 Ekstensi Pratinjau
az quantum job show

Dapatkan status dan detail pekerjaan.

 Ekstensi Pratinjau
az quantum job submit

Kirim program atau sirkuit untuk dijalankan di Azure Quantum.

 Ekstensi Pratinjau
az quantum job wait

Tempatkan CLI dalam status tunggu hingga pekerjaan selesai berjalan.

 Ekstensi Pratinjau

az quantum job cancel

Pratinjau

Grup perintah 'quantum' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Minta untuk membatalkan pekerjaan di Azure Quantum jika belum selesai.

az quantum job cancel --job-id
                      --location
                      --resource-group
                      --workspace-name

Contoh

Batalkan pekerjaan Azure Quantum berdasarkan id.

az quantum job cancel -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy

Parameter yang Diperlukan

--job-id -j

Pengidentifikasi unik pekerjaan dalam format GUID.

--location -l

Lokasi. Nilai dari: az account list-locations. Anda dapat mengonfigurasi lokasi default menggunakan az configure --defaults location=<location>.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--workspace-name -w

Nama Ruang Kerja Quantum. Anda dapat mengonfigurasi ruang kerja default menggunakan az quantum workspace set.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az quantum job list

Pratinjau

Grup perintah 'quantum' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Dapatkan daftar pekerjaan di Ruang Kerja Quantum.

az quantum job list --location
                    --resource-group
                    --workspace-name

Contoh

Dapatkan daftar pekerjaan dari ruang kerja Azure Quantum.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation

Parameter yang Diperlukan

--location -l

Lokasi. Nilai dari: az account list-locations. Anda dapat mengonfigurasi lokasi default menggunakan az configure --defaults location=<location>.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--workspace-name -w

Nama Ruang Kerja Quantum. Anda dapat mengonfigurasi ruang kerja default menggunakan az quantum workspace set.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az quantum job output

Pratinjau

Grup perintah 'quantum' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Dapatkan hasil menjalankan pekerjaan.

az quantum job output --job-id
                      --location
                      --resource-group
                      --workspace-name
                      [--item]

Contoh

Cetak hasil pekerjaan Azure Quantum yang sukses.

az quantum job output -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy -o table

Parameter yang Diperlukan

--job-id -j

Pengidentifikasi unik pekerjaan dalam format GUID.

--location -l

Lokasi. Nilai dari: az account list-locations. Anda dapat mengonfigurasi lokasi default menggunakan az configure --defaults location=<location>.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--workspace-name -w

Nama Ruang Kerja Quantum. Anda dapat mengonfigurasi ruang kerja default menggunakan az quantum workspace set.

Parameter Opsional

--item

Indeks item dalam pekerjaan batching.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az quantum job show

Pratinjau

Grup perintah 'quantum' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Dapatkan status dan detail pekerjaan.

az quantum job show --job-id
                    --location
                    --resource-group
                    --workspace-name

Contoh

Dapatkan status pekerjaan Azure Quantum.

az quantum job show -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy --query status

Parameter yang Diperlukan

--job-id -j

Pengidentifikasi unik pekerjaan dalam format GUID.

--location -l

Lokasi. Nilai dari: az account list-locations. Anda dapat mengonfigurasi lokasi default menggunakan az configure --defaults location=<location>.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--workspace-name -w

Nama Ruang Kerja Quantum. Anda dapat mengonfigurasi ruang kerja default menggunakan az quantum workspace set.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az quantum job submit

Pratinjau

Grup perintah 'quantum' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Kirim program atau sirkuit untuk dijalankan di Azure Quantum.

az quantum job submit --location
                      --resource-group
                      --target-id
                      --workspace-name
                      [--entry-point]
                      [--job-input-file]
                      [--job-input-format]
                      [--job-name]
                      [--job-output-format]
                      [--job-params]
                      [--no-build]
                      [--project]
                      [--shots]
                      [--storage]
                      [--target-capability]
                      [<PROGRAM_ARGS>]

Contoh

Kirim program Q# dari folder saat ini.

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t MyTarget --job-name MyJob

Kirim program Q# dari folder saat ini dengan parameter pekerjaan untuk target.

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t MyTarget --job-name MyJob --job-params param1=value1 param2=value2

Kirim program Q# dengan parameter program (misalnya n-qubits = 2).

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t MyTarget --job-name MyJob -- --n-qubits=2

Kirim program Q# dari folder saat ini dengan parameter kemampuan target.

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --target-capability MyTargetCapability

Kirim kode bitcode QIR atau LLVM yang dapat dibaca manusia dari file di folder saat ini.

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-name MyJob --job-input-format qir.v1 --job-input-file MyQirBitcode.bc \
    --entry-point MyQirEntryPoint

Parameter yang Diperlukan

--location -l

Lokasi. Nilai dari: az account list-locations. Anda dapat mengonfigurasi lokasi default menggunakan az configure --defaults location=<location>.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--target-id -t

Mesin eksekusi untuk pekerjaan komputasi kuantum. Saat ruang kerja dikonfigurasi dengan sekumpulan penyedia, mereka masing-masing mengaktifkan satu atau beberapa target. Anda dapat mengonfigurasi target default menggunakan az quantum target set.

--workspace-name -w

Nama Ruang Kerja Quantum. Anda dapat mengonfigurasi ruang kerja default menggunakan az quantum workspace set.

Parameter Opsional

--entry-point

Titik masuk untuk program atau sirkuit QIR. Diperlukan untuk QIR. Diabaikan pada pekerjaan Q#.

--job-input-file

Lokasi file input yang akan dikirimkan. Diperlukan untuk pekerjaan QIR, QIO, dan pass-through. Diabaikan pada pekerjaan Q#.

--job-input-format

Format file yang akan dikirimkan. Hilangkan parameter ini pada pekerjaan Q#.

--job-name

Nama yang mudah diingat untuk menjalankan program ini.

--job-output-format

Format output pekerjaan yang diharapkan. Diabaikan pada pekerjaan Q#.

--job-params

Parameter pekerjaan diteruskan ke target sebagai daftar pasangan key=value, string json, atau @{file} dengan konten json.

--no-build

[Tidak digunakan lagi] Jika ditentukan, program Q# tidak dibangun sebelum mengirimkan.

nilai default: False
--project

[Tidak digunakan lagi] Lokasi proyek Q# yang akan dikirimkan. Default ke folder saat ini.

--shots

Berapa kali menjalankan program Q# pada target yang diberikan.

--storage

Jika ditentukan, Koneksi string Azure Storage digunakan untuk menyimpan data dan hasil pekerjaan.

--target-capability

Parameter kemampuan target diteruskan ke pengkompilasi.

<PROGRAM_ARGS>

Daftar argumen yang diharapkan oleh operasi Q# yang ditentukan sebagai --name=value setelah --.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az quantum job wait

Pratinjau

Grup perintah 'quantum' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Tempatkan CLI dalam status tunggu hingga pekerjaan selesai berjalan.

az quantum job wait --job-id
                    --location
                    --resource-group
                    --workspace-name
                    [--max-poll-wait-secs]

Contoh

Tunggu penyelesaian pekerjaan, periksa interval 60 detik.

az quantum job wait -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy --max-poll-wait-secs 60 -o table

Parameter yang Diperlukan

--job-id -j

Pengidentifikasi unik pekerjaan dalam format GUID.

--location -l

Lokasi. Nilai dari: az account list-locations. Anda dapat mengonfigurasi lokasi default menggunakan az configure --defaults location=<location>.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--workspace-name -w

Nama Ruang Kerja Quantum. Anda dapat mengonfigurasi ruang kerja default menggunakan az quantum workspace set.

Parameter Opsional

--max-poll-wait-secs

Waktu polling dalam hitungan detik untuk mengkueri Azure Quantum untuk hasil pekerjaan yang sesuai.

nilai default: 5
Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.