az ml component
Nota
Referensi ini adalah bagian dari ekstensi ml
Mengelola komponen Azure ML.
Komponen Azure ML menentukan konfigurasi komponen untuk pekerjaan alur. Anda dapat mengonfigurasi port input/output, lingkungan eksekusi, dan perintah komponen. Setelah komponen dibuat, Anda dapat mereferensikan komponen dalam pekerjaan alur untuk menjalankannya dalam kontainer docker.
Perintah
Nama | Deskripsi | Jenis | Status |
---|---|---|---|
az ml component archive |
Mengarsipkan komponen. |
Ekstensi | GA |
az ml component create |
Buat komponen. |
Ekstensi | GA |
az ml component list |
Mencantumkan komponen di ruang kerja. |
Ekstensi | GA |
az ml component prepare-for-sign |
Siapkan komponen untuk penandatanganan. |
Ekstensi | GA |
az ml component restore |
Memulihkan komponen yang diarsipkan. |
Ekstensi | GA |
az ml component show |
Tampilkan detail untuk komponen. |
Ekstensi | GA |
az ml component update |
Memperbarui komponen. Saat ini hanya beberapa bidang (deskripsi, display_name) yang mendukung pembaruan. |
Ekstensi | GA |
az ml component archive
Mengarsipkan komponen.
Pengarsipan komponen akan menyembunyikannya secara default dari kueri daftar (az ml component list
). Anda masih dapat terus mereferensikan dan menggunakan komponen yang diarsipkan di alur Anda. Anda dapat mengarsipkan kontainer komponen atau versi komponen tertentu. Pengarsipan kontainer komponen akan mengarsipkan semua versi komponen dengan nama yang diberikan. Anda dapat memulihkan komponen yang diarsipkan menggunakan az ml component restore
. Jika seluruh kontainer komponen diarsipkan, Anda tidak dapat memulihkan versi komponen individual - Anda harus memulihkan kontainer komponen.
az ml component archive --name
[--label]
[--registry-name]
[--resource-group]
[--version]
[--workspace-name]
Contoh
Mengarsipkan kontainer komponen (mengarsipkan semua versi komponen tersebut)
az ml component archive --name my-component --resource-group my-resource-group --workspace-name my-workspace
Mengarsipkan versi komponen tertentu
az ml component archive --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace
Parameter yang Diperlukan
Nama komponen.
Parameter Opsional
Label komponen.
Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Versi komponen.
Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>
.
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
az ml component create
Buat komponen.
az ml component create --file
[--name]
[--registry-name]
[--resource-group]
[--set]
[--skip-validation]
[--version]
[--workspace-name]
Contoh
Membuat komponen dari file spesifikasi YAML
az ml component create --file my_component.yml --resource-group my-resource-group --workspace-name my-workspace
Membuat komponen dari file spesifikasi YAML dengan versi yang ditentukan
az ml component create --file my_component.yml --version 1 --resource-group my-resource-group --workspace-name my-workspace
Membuat komponen dalam registri dari file spesifikasi YAML
az ml component create --file my_component.yml --registry-name my-registry-name --resource-group my-resource-group
Membuat komponen dalam registri dari file spesifikasi YAML dengan versi yang ditentukan
az ml component create --file my_component.yml --version 1 --registry-name my-registry-name --resource-group my-resource-group
Parameter yang Diperlukan
Jalur lokal ke file YAML yang berisi spesifikasi komponen Azure ML. Dokumen referensi YAML untuk komponen dapat ditemukan di: https://aka.ms/ml-cli-v2-component-command-yaml-reference.
Parameter Opsional
Nama komponen.
Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Perbarui objek dengan menentukan jalur properti dan nilai yang akan diatur. Contoh: --set property1.property2=value.
Lewati validasi dalam membuat sumber daya. Perhatikan bahwa sumber daya dependen tidak akan melewati validasinya dalam pembuatan.
Versi komponen.
Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>
.
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
az ml component list
Mencantumkan komponen di ruang kerja.
az ml component list [--archived-only]
[--include-archived]
[--max-results]
[--name]
[--registry-name]
[--resource-group]
[--workspace-name]
Contoh
Mencantumkan semua komponen di ruang kerja
az ml component list --resource-group my-resource-group --workspace-name my-workspace
Mencantumkan semua versi komponen untuk nama yang ditentukan di ruang kerja
az ml component list --name my-component --resource-group my-resource-group --workspace-name my-workspace
Cantumkan semua komponen di ruang kerja menggunakan argumen --query untuk menjalankan kueri JMESPath pada hasil perintah.
az ml component list --query "[].{Name:name}" --output table --resource-group my-resource-group --workspace-name my-workspace
Mencantumkan semua komponen dalam registri
az ml component list --registry-name my-registry-name --resource-group my-resource-group
Mencantumkan semua versi komponen untuk nama yang ditentukan dalam registri
az ml component list --name my-component --registry-name my-registry-name --resource-group my-resource-group
Cantumkan semua komponen dalam registri menggunakan argumen --query untuk menjalankan kueri JMESPath pada hasil perintah.
az ml component list --query "[].{Name:name}" --output table --registry-name my-registry-name --resource-group my-resource-group
Parameter Opsional
Cantumkan komponen yang diarsipkan saja.
Mencantumkan komponen yang diarsipkan dan komponen aktif.
Jumlah maksimum hasil yang akan dikembalikan.
Nama komponen.
Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>
.
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
az ml component prepare-for-sign
Siapkan komponen untuk penandatanganan.
Menyiapkan komponen untuk tanda menghasilkan 2 file: catalog.json dan catalog.json.sig, file-file ini berisi SHA256 yang dihasilkan untuk setiap file yang ada di folder target. Jika file sudah ada, file tersebut akan dihapus dan file baru akan dibuat dengan tanda tangan yang diperbarui.
az ml component prepare-for-sign --file
[--registry-name]
[--resource-group]
[--workspace-name]
Contoh
Menyiapkan komponen dari file spesifikasi YAML untuk penandatanganan
az ml component prepare-for-sign --file my_component.yml --resource-group my-resource-group --workspace-name my-workspace
Menyiapkan komponen dalam registri dari file spesifikasi YAML untuk penandatanganan
az ml component prepare-for-sign --file my_component.yml --registry-name my-registry-name --resource-group my-resource-group
Parameter yang Diperlukan
Jalur lokal ke file YAML yang berisi spesifikasi komponen Azure ML. Dokumen referensi YAML untuk komponen dapat ditemukan di: https://aka.ms/ml-cli-v2-component-command-yaml-reference.
Parameter Opsional
Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>
.
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
az ml component restore
Memulihkan komponen yang diarsipkan.
Ketika komponen yang diarsipkan dipulihkan, komponen tersebut tidak akan lagi disembunyikan dari kueri daftar (az ml component list
). Jika seluruh kontainer komponen diarsipkan, Anda dapat memulihkan kontainer yang diarsipkan tersebut. Ini akan memulihkan semua versi komponen dengan nama yang diberikan. Anda tidak dapat memulihkan hanya versi komponen tertentu jika seluruh kontainer komponen diarsipkan - Anda harus memulihkan seluruh kontainer. Jika hanya versi komponen individual yang diarsipkan, Anda dapat memulihkan versi tertentu tersebut.
az ml component restore --name
[--label]
[--registry-name]
[--resource-group]
[--version]
[--workspace-name]
Contoh
Memulihkan kontainer komponen yang diarsipkan (memulihkan semua versi komponen tersebut)
az ml component restore --name my-component --resource-group my-resource-group --workspace-name my-workspace
Memulihkan versi komponen yang diarsipkan tertentu
az ml component restore --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace
Parameter yang Diperlukan
Nama komponen.
Parameter Opsional
Label komponen.
Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Versi komponen.
Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>
.
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
az ml component show
Tampilkan detail untuk komponen.
az ml component show --name
[--label]
[--registry-name]
[--resource-group]
[--version]
[--workspace-name]
Contoh
Tampilkan detail untuk komponen dengan nama dan versi yang ditentukan
az ml component show --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace
Tampilkan detail untuk komponen dalam registri dengan nama dan versi yang ditentukan
az ml component show --name my-component --version 1 --registry-name my-registry-name --resource-group my-resource-group
Parameter yang Diperlukan
Nama komponen.
Parameter Opsional
Label komponen.
Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Versi komponen.
Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>
.
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
az ml component update
Memperbarui komponen. Saat ini hanya beberapa bidang (deskripsi, display_name) yang mendukung pembaruan.
az ml component update --name
--resource-group
--workspace-name
[--add]
[--force-string]
[--label]
[--registry-name]
[--remove]
[--set]
[--version]
Contoh
Memperbarui deskripsi komponen
az ml component update -n my_component -v 1 --set description="new description" -g my-resource-group -w my-workspace
Parameter yang Diperlukan
Nama komponen.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>
.
Parameter Opsional
Tambahkan objek ke daftar objek dengan menentukan jalur dan pasangan nilai kunci. Contoh: --add property.listProperty <key=value, string or JSON string>
.
Saat menggunakan 'set' atau 'add', pertahankan literal string alih-alih mencoba mengonversi ke JSON.
Label komponen.
Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.
Menghapus properti atau elemen dari daftar. Contoh: --remove property.list <indexToRemove>
OR --remove propertyToRemove
.
Perbarui objek dengan menentukan jalur properti dan nilai yang akan diatur. Contoh: --set property1.property2=<value>
.
Versi komponen.
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.