az ml workspace

  • Referensi

Catatan

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 az ml workspace . Pelajari lebih lanjut tentang ekstensi.

Mengelola ruang kerja Azure ML.

Ruang kerja Azure ML adalah sumber daya tingkat atas untuk Azure Pembelajaran Mesin. Ini menyediakan tempat terpusat untuk melacak aset dan sumber daya yang digunakan dalam alur kerja ML Anda, bersama dengan log dan artefak yang dihasilkan dari pekerjaan pelatihan Anda.

Jika Anda meningkatkan dari CLI v1 ke v2, Anda memerlukan dua perubahan berikut dalam cakupan manajemen ruang kerja:

  • Tingkatkan az ml workspace private-endpoint perintah ke perintah yang setara az network private-endpoint .
  • Selain itu, tingkatkan az ml workspace share perintah ke perintah yang setara az role assignment create .

Perintah

Nama Deskripsi Jenis Status
az ml workspace create

Buat ruang kerja.

 Ekstensi GA
az ml workspace delete

Menghapus ruang kerja.

 Ekstensi GA
az ml workspace diagnose

Mendiagnosis masalah penyiapan ruang kerja.

 Ekstensi GA
az ml workspace list

Mencantumkan semua ruang kerja dalam langganan.

 Ekstensi GA
az ml workspace list-keys

Mencantumkan kunci ruang kerja untuk sumber daya dependen seperti Azure Storage, Azure Container Registry, dan Azure Application Insights.

 Ekstensi GA
az ml workspace outbound-rule

Mengelola aturan keluar untuk jaringan terkelola ruang kerja Azure ML.

 Ekstensi GA
az ml workspace outbound-rule list

Mencantumkan semua aturan keluar jaringan terkelola untuk ruang kerja.

 Ekstensi GA
az ml workspace outbound-rule remove

Hapus aturan keluar dari jaringan terkelola untuk ruang kerja.

 Ekstensi GA
az ml workspace outbound-rule set

Menambahkan atau memperbarui aturan keluar di jaringan terkelola untuk ruang kerja.

 Ekstensi GA
az ml workspace outbound-rule show

Perlihatkan detail untuk aturan keluar jaringan terkelola untuk ruang kerja.

 Ekstensi GA
az ml workspace provision-network

Memprovisikan jaringan terkelola ruang kerja.

 Ekstensi GA
az ml workspace show

Perlihatkan detail untuk ruang kerja.

 Ekstensi GA
az ml workspace sync-keys

Sinkronkan kunci ruang kerja untuk sumber daya dependen seperti Azure Storage, Azure Container Registry, dan Azure Application Insights.

 Ekstensi GA
az ml workspace update

Memperbarui ruang kerja.

 Ekstensi GA

az ml workspace create

Buat ruang kerja.

Saat ruang kerja dibuat, beberapa sumber daya Azure yang akan digunakan oleh Azure ML juga dibuat secara default: Azure Storage, Azure Container Registry, Azure Key Vault, dan Azure Application Insights. Anda dapat menggunakan instans sumber daya Azure yang ada untuk mereka yang saat membuat ruang kerja dengan menentukan ID sumber daya dalam file YAML konfigurasi ruang kerja.

az ml workspace create --resource-group
                       [--application-insights]
                       [--container-registry]
                       [--description]
                       [--display-name]
                       [--enable-data-isolation]
                       [--file]
                       [--image-build-compute]
                       [--key-vault]
                       [--location]
                       [--managed-network]
                       [--name]
                       [--no-wait]
                       [--primary-user-assigned-identity]
                       [--public-network-access]
                       [--set]
                       [--storage-account]
                       [--tags]
                       [--update-dependent-resources]
                       [--workspace-hub]

Contoh

Buat ruang kerja dari file spesifikasi YAML.

az ml workspace create --file workspace.yml --resource-group my-resource-group

Parameter yang Diperlukan

--resource-group -g

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

Parameter Opsional

--application-insights -a

Id ARM dari wawasan aplikasi yang terkait dengan ruang kerja ini.

--container-registry -c

Id ARM dari registri kontainer yang terkait dengan ruang kerja ini.

--description

Deskripsi ruang kerja Azure ML.

--display-name

Nama tampilan untuk ruang kerja.

--enable-data-isolation -e

Bendera untuk menentukan apakah ruang kerja mengaktifkan isolasi data. Bendera hanya dapat diatur pada tahap pembuatan, bendera tidak dapat diperbarui.

nilai default: False
--file -f

Jalur lokal ke file YAML yang berisi spesifikasi ruang kerja Azure ML. Dokumen referensi YAML untuk ruang kerja dapat ditemukan di: https://aka.ms/ml-cli-v2-workspace-yaml-reference.

--image-build-compute -i

Nama target komputasi yang akan digunakan untuk membangun citra Docker lingkungan saat registri kontainer berada di belakang VNet.

--key-vault -k

Id ARM dari brankas kunci yang terkait dengan ruang kerja ini.

--location -l

Lokasi yang akan digunakan untuk ruang kerja baru.

--managed-network -m
Pratinjau

Mode Isolasi Jaringan Terkelola untuk ruang kerja.

--name -n

Nama ruang kerja Azure ML.

--no-wait

Jangan menunggu pembuatan ruang kerja selesai.

nilai default: False
--primary-user-assigned-identity -p

Pengidentifikasi ARM dari identitas terkelola yang ditetapkan pengguna utama, jika beberapa pengguna ditentukan. Juga identitas terkelola default untuk komputasi tanpa kluster.

--public-network-access

Izinkan konektivitas titik akhir publik saat ruang kerja diaktifkan tautan privat.

--set

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

--storage-account -s

ID ARM dari akun penyimpanan yang terkait dengan ruang kerja ini.

--tags

Pasangan kunci-nilai yang dipisahkan spasi untuk tag objek.

--update-dependent-resources -u

Menentukan --update_dependent_resources, memberikan persetujuan Anda untuk memperbarui sumber daya dependen ruang kerja. Memperbarui sumber daya Azure Container Registry atau Application Insights yang terpasang di ruang kerja dapat memutus silsilah pekerjaan sebelumnya, titik akhir inferensi yang disebarkan, atau kemampuan Anda untuk menjalankan ulang pekerjaan sebelumnya di ruang kerja ini.

nilai default: False
--workspace-hub
Pratinjau

ID ARM yang disediakan untuk membuat ruang kerja, ruang kerja menjadi ruang kerja proyek dan semua sumber daya dependen digunakan dari WorkspaceHub.

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 ml workspace delete

Menghapus ruang kerja.

Secara default, sumber daya dependen yang terkait dengan ruang kerja (Azure Storage, Azure Container Registry, Azure Key Vault, Azure Application Insights) tidak dihapus. Untuk menghapusnya juga, sertakan --all-resources. Untuk menghapus ruang kerja secara permanen, sertakan --permanen-delete.

az ml workspace delete --name
                       --resource-group
                       [--all-resources]
                       [--no-wait]
                       [--permanently-delete]
                       [--yes]

Parameter yang Diperlukan

--name -n

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

--resource-group -g

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

Parameter Opsional

--all-resources

Hapus semua sumber daya dependen yang terkait dengan ruang kerja (akun Azure Storage, Azure Container Registry, Azure Application Insights, Azure Key Vault).

nilai default: False
--no-wait

Jangan tunggu hingga operasi jangka panjang selesai. Defaultnya adalah False.

nilai default: False
--permanently-delete -p

Ruang kerja adalah status dihapus sementara secara default untuk memungkinkan pemulihan data ruang kerja. Atur bendera ini untuk mengambil alih perilaku penghapusan sementara dan menghapus ruang kerja Anda secara permanen.

nilai default: False
--yes -y

Jangan meminta konfirmasi.

nilai default: False
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 ml workspace diagnose

Mendiagnosis masalah penyiapan ruang kerja.

Jika ruang kerja Anda tidak berfungsi seperti yang diharapkan, Anda dapat menjalankan diagnosis ini untuk memeriksa apakah ruang kerja telah rusak. Untuk ruang kerja titik akhir privat, ini juga akan membantu memeriksa apakah penyiapan jaringan ke ruang kerja ini dan sumber daya dependennya bermasalah atau tidak.

az ml workspace diagnose --name
                         --resource-group
                         [--no-wait]

Contoh

mendiagnosis ruang kerja.

az ml workspace diagnose --name my-workspace-name --no-wait -g my-resource-group

Parameter yang Diperlukan

--name -n

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

--resource-group -g

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

Parameter Opsional

--no-wait

Jangan tunggu hingga operasi jangka panjang selesai. Defaultnya adalah False.

nilai default: False
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 ml workspace list

Mencantumkan semua ruang kerja dalam langganan.

Daftar ruang kerja dapat difilter menurut grup sumber daya.

az ml workspace list [--max-results]
                     [--resource-group]

Contoh

Mencantumkan semua ruang kerja dalam grup sumber daya

az ml workspace list --resource-group my-resource-group

Cantumkan semua ruang kerja menggunakan argumen --query untuk menjalankan kueri JMESPath pada hasil perintah.

az ml workspace list --query "[].{Name:name}"  --output table --resource-group my-resource-group

Parameter Opsional

--max-results -r

Jumlah maksimum hasil yang akan dikembalikan.

--resource-group -g

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

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 ml workspace list-keys

Mencantumkan kunci ruang kerja untuk sumber daya dependen seperti Azure Storage, Azure Container Registry, dan Azure Application Insights.

az ml workspace list-keys --name
                          --resource-group

Parameter yang Diperlukan

--name -n

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

--resource-group -g

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

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 ml workspace provision-network

Memprovisikan jaringan terkelola ruang kerja.

Memicu ruang kerja untuk menyediakan jaringan terkelola. Menentukan bendera yang diaktifkan spark menyiapkan jaringan terkelola ruang kerja untuk mendukung Spark. Defaultnya adalah false jika tidak ditentukan tetapi dapat diaktifkan nanti dengan menjalankan perintah ini lagi dengan bendera ini. Setelah diaktifkan, itu tidak dapat dinonaktifkan.

az ml workspace provision-network --name
                                  --resource-group
                                  [--include-spark]
                                  [--no-wait]

Contoh

menyediakan jaringan terkelola.

az ml workspace provision-network --include-spark --name my-workspace-name --no-wait -g my-resource-group

Parameter yang Diperlukan

--name -n

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

--resource-group -g

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

Parameter Opsional

--include-spark

Boolean [true/false] untuk jika jaringan terkelola harus disediakan untuk memperhitungkan pekerjaan spark. Defaultnya adalah false jika bendera tidak diatur. Ini dapat diaktifkan nanti dengan menjalankan perintah ini lagi dengan bendera ini.

nilai default: False
--no-wait

Jangan tunggu hingga operasi jangka panjang selesai. Defaultnya adalah False.

nilai default: False
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 ml workspace show

Perlihatkan detail untuk ruang kerja.

az ml workspace show --name
                     --resource-group

Parameter yang Diperlukan

--name -n

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

--resource-group -g

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

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 ml workspace sync-keys

Sinkronkan kunci ruang kerja untuk sumber daya dependen seperti Azure Storage, Azure Container Registry, dan Azure Application Insights.

Jika kunci untuk sumber daya apa pun di ruang kerja diubah, diperlukan waktu sekitar satu jam agar dapat diperbarui secara otomatis. Perintah ini memicu ruang kerja untuk segera menyinkronkan kunci. Skenario yang mungkin memerlukan akses langsung ke penyimpanan setelah meregenerasi kunci penyimpanan.

az ml workspace sync-keys --name
                          --resource-group
                          [--no-wait]

Parameter yang Diperlukan

--name -n

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

--resource-group -g

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

Parameter Opsional

--no-wait

Jangan tunggu hingga operasi jangka panjang selesai. Defaultnya adalah False.

nilai default: False
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 ml workspace update

Memperbarui ruang kerja.

Properti 'description', 'tags', dan 'friendly_name' dapat diperbarui.

az ml workspace update --name
                       --resource-group
                       [--add]
                       [--application-insights]
                       [--container-registry]
                       [--description]
                       [--display-name]
                       [--file]
                       [--force-string]
                       [--image-build-compute]
                       [--managed-network]
                       [--no-wait]
                       [--primary-user-assigned-identity]
                       [--public-network-access]
                       [--remove]
                       [--set]
                       [--update-dependent-resources]

Contoh

memperbarui ruang kerja dari file spesifikasi YAML.

az ml workspace update --resource-group my-resource-group --name my-workspace-name --file workspace.yml

Parameter yang Diperlukan

--name -n

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

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<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: []
--application-insights -a

Id ARM dari wawasan aplikasi yang terkait dengan ruang kerja ini.

--container-registry -c

Id ARM dari registri kontainer yang terkait dengan ruang kerja ini.

--description

Deskripsi ruang kerja Azure ML.

--display-name

Nama tampilan untuk ruang kerja.

--file -f

Jalur lokal ke file YAML yang berisi spesifikasi ruang kerja Azure ML. Dokumen referensi YAML untuk ruang kerja dapat ditemukan di: https://aka.ms/ml-cli-v2-workspace-yaml-reference.

--force-string

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

nilai default: False
--image-build-compute -i

Nama target komputasi yang akan digunakan untuk membangun citra Docker lingkungan saat registri kontainer berada di belakang VNet.

--managed-network -m
Pratinjau

Mode Isolasi Jaringan Terkelola untuk ruang kerja.

--no-wait

Jangan tunggu hingga operasi jangka panjang selesai. Defaultnya adalah False.

nilai default: False
--primary-user-assigned-identity -p

Id ARM dari identitas utama yang ditetapkan pengguna yang terkait dengan ruang kerja ini.

--public-network-access

Izinkan konektivitas titik akhir publik saat ruang kerja diaktifkan tautan privat.

--remove

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

nilai default: []
--set

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

nilai default: []
--update-dependent-resources -u

Menentukan --update_dependent_resources, memberikan persetujuan Anda untuk memperbarui sumber daya dependen ruang kerja. Memperbarui sumber daya Azure Container Registry atau Application Insights yang terpasang di ruang kerja dapat memutus silsilah pekerjaan sebelumnya, titik akhir inferensi yang disebarkan, atau kemampuan Anda untuk menjalankan ulang pekerjaan sebelumnya di ruang kerja ini.

nilai default: False
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.