az ml workspace
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 setaraaz network private-endpoint
. - Selain itu, tingkatkan
az ml workspace share
perintah ke perintah yang setaraaz 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
[--allow-roleassignment-on-rg]
[--application-insights]
[--container-registry]
[--default-resource-group]
[--description]
[--display-name]
[--enable-data-isolation]
[--file]
[--hub-id]
[--image-build-compute]
[--key-vault]
[--kind]
[--location]
[--managed-network]
[--name]
[--no-wait]
[--primary-user-assigned-identity]
[--public-network-access]
[--set]
[--storage-account]
[--system-datastores-auth-mode]
[--tags]
[--update-dependent-resources]
Contoh
Buat ruang kerja dari file spesifikasi YAML.
az ml workspace create --file workspace.yml --resource-group my-resource-group
Parameter yang Diperlukan
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Parameter Opsional
Bendera untuk menentukan apakah ruang kerja dapat memiliki penetapan peran pada tingkat grup sumber daya.
Id ARM dari wawasan aplikasi yang terkait dengan ruang kerja ini.
Id ARM dari registri kontainer yang terkait dengan ruang kerja ini.
Jenis hub saja. Jika diatur, maka proyek anak dari hub ini akan memiliki grup sumber daya mereka yang mengatur ini secara default.
Deskripsi ruang kerja Azure ML.
Nama tampilan untuk ruang kerja.
Bendera untuk menentukan apakah ruang kerja mengaktifkan isolasi data. Bendera hanya dapat diatur pada tahap pembuatan, bendera tidak dapat diperbarui.
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.
Hanya jenis proyek: ID ARM yang menentukan hub induk proyek ini.
Nama target komputasi yang akan digunakan untuk membangun citra Docker lingkungan saat registri kontainer berada di belakang VNet.
Id ARM dari brankas kunci yang terkait dengan ruang kerja ini.
Menentukan ruang kerja sebagai jenis tertentu, mengesampingkan nilai yang ditetapkan di YAML, jika ada. Default ke default. Jenis yang valid adalah: default, hub, dan proyek.
Lokasi yang akan digunakan untuk ruang kerja baru.
Mode Isolasi Jaringan Terkelola untuk ruang kerja.
Nama ruang kerja Azure ML.
Jangan menunggu pembuatan ruang kerja selesai.
Pengidentifikasi ARM dari identitas terkelola yang ditetapkan pengguna utama, jika beberapa pengguna ditentukan. Juga identitas terkelola default untuk komputasi tanpa kluster.
Izinkan konektivitas titik akhir publik saat ruang kerja diaktifkan tautan privat.
Perbarui objek dengan menentukan jalur properti dan nilai yang akan diatur. Contoh: --set property1.property2=.
ID ARM dari akun penyimpanan yang terkait dengan ruang kerja ini.
Menentukan mode autentikasi untuk penyimpanan data sistem. Mode yang valid adalah: akseskey dan identitas.
Pasangan kunci-nilai yang dipisahkan spasi untuk tag objek.
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.
Parameter Global
Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.
Menampilkan pesan bantuan ini dan keluar.
Hanya menampilkan kesalahan, menyembunyikan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
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
Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>
.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Parameter Opsional
Hapus semua sumber daya dependen yang terkait dengan ruang kerja (akun Azure Storage, Azure Container Registry, Azure Application Insights, Azure Key Vault).
Jangan tunggu hingga operasi jangka panjang selesai. Defaultnya adalah False.
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.
Jangan meminta konfirmasi.
Parameter Global
Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.
Menampilkan pesan bantuan ini dan keluar.
Hanya menampilkan kesalahan, menyembunyikan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
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
Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>
.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Parameter Opsional
Jangan tunggu hingga operasi jangka panjang selesai. Defaultnya adalah False.
Parameter Global
Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.
Menampilkan pesan bantuan ini dan keluar.
Hanya menampilkan kesalahan, menyembunyikan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
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 [--filtered-kinds]
[--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
Cantumkan hanya jenis ruang kerja yang ditentukan, sebagai daftar yang dipisahkan koma. Jenis yang valid adalah: default, hub, dan proyek.
Jumlah maksimum hasil yang akan dikembalikan.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Parameter Global
Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.
Menampilkan pesan bantuan ini dan keluar.
Hanya menampilkan kesalahan, menyembunyikan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
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
Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>
.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Parameter Global
Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.
Menampilkan pesan bantuan ini dan keluar.
Hanya menampilkan kesalahan, menyembunyikan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
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
Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>
.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Parameter Opsional
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.
Jangan tunggu hingga operasi jangka panjang selesai. Defaultnya adalah False.
Parameter Global
Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.
Menampilkan pesan bantuan ini dan keluar.
Hanya menampilkan kesalahan, menyembunyikan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
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
Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>
.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Parameter Global
Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.
Menampilkan pesan bantuan ini dan keluar.
Hanya menampilkan kesalahan, menyembunyikan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
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
Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>
.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Parameter Opsional
Jangan tunggu hingga operasi jangka panjang selesai. Defaultnya adalah False.
Parameter Global
Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.
Menampilkan pesan bantuan ini dan keluar.
Hanya menampilkan kesalahan, menyembunyikan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
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]
[--allow-roleassignment-on-rg]
[--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]
[--system-datastores-auth-mode]
[--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
Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>
.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<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>
.
Bendera untuk menentukan apakah ruang kerja dapat memiliki penetapan peran pada tingkat grup sumber daya.
Id ARM dari wawasan aplikasi yang terkait dengan ruang kerja ini.
Id ARM dari registri kontainer yang terkait dengan ruang kerja ini.
Deskripsi ruang kerja Azure ML.
Nama tampilan untuk ruang kerja.
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.
Saat menggunakan 'set' atau 'add', pertahankan literal string alih-alih mencoba mengonversi ke JSON.
Nama target komputasi yang akan digunakan untuk membangun citra Docker lingkungan saat registri kontainer berada di belakang VNet.
Mode Isolasi Jaringan Terkelola untuk ruang kerja.
Jangan tunggu hingga operasi jangka panjang selesai. Defaultnya adalah False.
Id ARM dari identitas utama yang ditetapkan pengguna yang terkait dengan ruang kerja ini.
Izinkan konektivitas titik akhir publik saat ruang kerja diaktifkan tautan privat.
Menghapus properti atau elemen dari daftar. Contoh: --remove property.list <indexToRemove>
ATAU --remove propertyToRemove
.
Perbarui objek dengan menentukan jalur properti dan nilai yang akan diatur. Contoh: --set property1.property2=<value>
.
Menentukan mode autentikasi untuk penyimpanan data sistem. Mode yang valid adalah: akseskey dan identitas.
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.
Parameter Global
Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.
Menampilkan pesan bantuan ini dan keluar.
Hanya menampilkan kesalahan, menyembunyikan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.