az quantum

  • 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 . Pelajari lebih lanjut tentang ekstensi.

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

Mengelola Ruang Kerja Azure Quantum dan mengirimkan pekerjaan ke Penyedia Azure Quantum.

Perintah

Nama Deskripsi Jenis Status
az quantum execute

Kirim pekerjaan untuk dijalankan di Azure Quantum, dan menunggu hasilnya.

 Ekstensi Pratinjau
az quantum job

Mengelola pekerjaan untuk Azure Quantum.

 Ekstensi Pratinjau
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 offerings

Mengelola penawaran penyedia untuk Azure Quantum.

 Ekstensi Pratinjau
az quantum offerings accept-terms

Terima ketentuan kombinasi penyedia dan SKU untuk mengaktifkannya untuk pembuatan ruang kerja.

 Ekstensi Pratinjau
az quantum offerings list

Dapatkan daftar semua penawaran penyedia yang tersedia di lokasi tertentu.

 Ekstensi Pratinjau
az quantum offerings show-terms

Tampilkan ketentuan kombinasi penyedia dan SKU termasuk URL lisensi dan status penerimaan.

 Ekstensi Pratinjau
az quantum run

Setara dengan az quantum execute.

 Ekstensi Pratinjau
az quantum target

Mengelola target untuk ruang kerja Azure Quantum.

 Ekstensi Pratinjau
az quantum target clear

Hapus target-id default.

 Ekstensi Pratinjau
az quantum target list

Dapatkan daftar penyedia dan targetnya di ruang kerja Azure Quantum.

 Ekstensi Pratinjau
az quantum target set

Pilih target default yang akan digunakan saat mengirimkan pekerjaan ke Azure Quantum.

 Ekstensi Pratinjau
az quantum target show

Dapatkan ID Target dari target default saat ini untuk digunakan saat mengirimkan pekerjaan ke Azure Quantum.

 Ekstensi Pratinjau
az quantum workspace

Mengelola ruang kerja Azure Quantum.

 Ekstensi Pratinjau
az quantum workspace clear

Hapus ruang kerja Azure Quantum default.

 Ekstensi Pratinjau
az quantum workspace create

Buat ruang kerja Azure Quantum baru.

 Ekstensi Pratinjau
az quantum workspace delete

Hapus ruang kerja Azure Quantum yang diberikan (atau saat ini).

 Ekstensi Pratinjau
az quantum workspace keys

Mengelola kunci api Azure Quantum Workspace.

 Ekstensi Pratinjau
az quantum workspace keys list

Mencantumkan kunci api untuk ruang kerja Azure Quantum yang diberikan (atau saat ini).

 Ekstensi Pratinjau
az quantum workspace keys regenerate

Regenerasi kunci api untuk ruang kerja Azure Quantum yang diberikan (atau saat ini).

 Ekstensi Pratinjau
az quantum workspace list

Dapatkan daftar ruang kerja Azure Quantum yang tersedia.

 Ekstensi Pratinjau
az quantum workspace quotas

Cantumkan kuota untuk ruang kerja Azure Quantum yang diberikan (atau saat ini).

 Ekstensi Pratinjau
az quantum workspace set

Pilih ruang kerja Azure Quantum default untuk perintah mendatang.

 Ekstensi Pratinjau
az quantum workspace show

Dapatkan detail ruang kerja Azure Quantum yang diberikan (atau saat ini).

 Ekstensi Pratinjau
az quantum workspace update

Perbarui ruang kerja Azure Quantum yang diberikan (atau saat ini).

 Ekstensi Pratinjau

az quantum execute

Pratinjau

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

Kirim pekerjaan untuk dijalankan di Azure Quantum, dan menunggu hasilnya.

az quantum execute --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 dan tunggu hasilnya.

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget

Kirim dan tunggu program Q# dari folder saat ini dengan parameter pekerjaan dan program.

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-params key1=value1 key2=value2 -- --n-qubits=3

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

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

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 run

Pratinjau

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

Setara dengan az quantum execute.

az quantum run --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 dan tunggu hasilnya.

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget

Kirim dan tunggu program Q# dari folder saat ini dengan parameter pekerjaan dan program.

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-params key1=value1 key2=value2 -- --n-qubits=3

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

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

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.