Bagikan melalui

az ml component

  • Referensi

Nota

Referensi ini adalah bagian dari ekstensi ml untuk Azure CLI (versi 2.15.0 atau yang lebih tinggi). Ekstensi akan secara otomatis menginstal pertama kali Anda menjalankan perintah komponen az ml. Pelajari selengkapnya tentang ekstensi.

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

--name -n

Nama komponen.

Parameter Opsional

--label -l

Label komponen.

--registry-name

Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.

--resource-group -g

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

--version -v

Versi komponen.

--workspace-name -w

Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan 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 dan contoh selengkapnya.

--subscription

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

--verbose

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

--file -f

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

--name -n

Nama komponen.

--registry-name

Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.

--resource-group -g

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

--set

Perbarui objek dengan menentukan jalur properti dan nilai yang akan diatur. Contoh: --set property1.property2=value.

--skip-validation

Lewati validasi dalam membuat sumber daya. Perhatikan bahwa sumber daya dependen tidak akan melewati validasinya dalam pembuatan.

Nilai default: False
--version -v

Versi komponen.

--workspace-name -w

Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan 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 dan contoh selengkapnya.

--subscription

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

--verbose

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

--archived-only

Cantumkan komponen yang diarsipkan saja.

Nilai default: False
--include-archived

Mencantumkan komponen yang diarsipkan dan komponen aktif.

Nilai default: False
--max-results -r

Jumlah maksimum hasil yang akan dikembalikan.

--name -n

Nama komponen.

--registry-name

Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.

--resource-group -g

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

--workspace-name -w

Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan 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 dan contoh selengkapnya.

--subscription

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

--verbose

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

--file -f

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

--registry-name

Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.

--resource-group -g

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

--workspace-name -w

Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan 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 dan contoh selengkapnya.

--subscription

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

--verbose

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

--name -n

Nama komponen.

Parameter Opsional

--label -l

Label komponen.

--registry-name

Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.

--resource-group -g

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

--version -v

Versi komponen.

--workspace-name -w

Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan 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 dan contoh selengkapnya.

--subscription

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

--verbose

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

--name -n

Nama komponen.

Parameter Opsional

--label -l

Label komponen.

--registry-name

Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.

--resource-group -g

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

--version -v

Versi komponen.

--workspace-name -w

Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan 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 dan contoh selengkapnya.

--subscription

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

--verbose

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

--name -n

Nama komponen.

--resource-group -g

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

--workspace-name -w

Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>.

Parameter Opsional

--add

Tambahkan objek ke daftar objek dengan menentukan jalur dan pasangan nilai kunci. Contoh: --add property.listProperty <key=value, string or JSON string>.

Nilai default: []
--force-string

Saat menggunakan 'set' atau 'add', pertahankan literal string alih-alih mencoba mengonversi ke JSON.

Nilai default: False
--label -l

Label komponen.

--registry-name

Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.

--remove

Menghapus properti atau elemen dari daftar. Contoh: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Nilai default: []
--set

Perbarui objek dengan menentukan jalur properti dan nilai yang akan diatur. Contoh: --set property1.property2=<value>.

Nilai default: []
--version -v

Versi komponen.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan 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 dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.