az ml workspace
Not
Bu başvuru, Azure CLI (sürüm 2.15.0 veya üzeri) için ml uzantısının bir parçasıdır. Uzantı, az ml workspace komutunu ilk kez çalıştırdığınızda otomatik olarak yüklenir. Uzantılar hakkında daha fazla bilgi edinin.
Azure ML çalışma alanlarını yönetme.
Azure ML çalışma alanı, Azure Machine Learning için en üst düzey kaynaktır. Eğitim işlerinizden oluşturulan günlükler ve yapıtlarla birlikte ML iş akışlarınızda kullanılan varlıkları ve kaynakları izlemek için merkezi bir yer sağlar.
CLI v1'den v2'ye yükseltiyorsanız, çalışma alanı yönetimi kapsamında aşağıdaki iki değişikliğe ihtiyacınız vardır:
- Komutları eşdeğer
az ml workspace private-endpoint
komutlara yükseltinaz network private-endpoint
. - Ayrıca, komutları eşdeğer
az ml workspace share
komutlara yükseltinaz role assignment create
.
Komutlar
Name | Description | Tür | Durum |
---|---|---|---|
az ml workspace create |
Çalışma alanı oluşturun. |
Dahili | GA |
az ml workspace delete |
Çalışma alanını silme. |
Dahili | GA |
az ml workspace diagnose |
Çalışma alanı kurulum sorunlarını tanılama. |
Dahili | GA |
az ml workspace list |
Abonelikteki tüm çalışma alanlarını listeleme. |
Dahili | GA |
az ml workspace list-keys |
Azure Depolama, Azure Container Registry ve Azure Uygulaması lication Insights gibi bağımlı kaynaklar için çalışma alanı anahtarlarını listeleyin. |
Dahili | GA |
az ml workspace outbound-rule |
Azure ML çalışma alanının yönetilen ağı için giden kurallarını yönetin. |
Dahili | GA |
az ml workspace outbound-rule list |
Bir çalışma alanı için tüm yönetilen ağ giden kurallarını listeleyin. |
Dahili | GA |
az ml workspace outbound-rule remove |
Bir çalışma alanı için yönetilen ağdan giden kuralı kaldırın. |
Dahili | GA |
az ml workspace outbound-rule set |
Bir çalışma alanı için yönetilen ağda giden kuralı ekleyin veya güncelleştirin. |
Dahili | GA |
az ml workspace outbound-rule show |
Bir çalışma alanı için yönetilen ağ giden kuralının ayrıntılarını gösterin. |
Dahili | GA |
az ml workspace provision-network |
Çalışma alanı yönetilen ağı sağlama. |
Dahili | GA |
az ml workspace show |
Çalışma alanının ayrıntılarını gösterme. |
Dahili | GA |
az ml workspace sync-keys |
Azure Depolama, Azure Container Registry ve Azure Uygulaması lication Insights gibi bağımlı kaynaklar için çalışma alanı anahtarlarını eşitleyin. |
Dahili | GA |
az ml workspace update |
Çalışma alanını güncelleştirme. |
Dahili | GA |
az ml workspace create
Çalışma alanı oluşturun.
Çalışma alanı oluşturulduğunda Azure ML tarafından kullanılacak birkaç Azure kaynağı da varsayılan olarak oluşturulur: Azure Depolama, Azure Container Registry, Azure Key Vault ve Azure Uygulaması lication Insights. Bunun yerine, çalışma alanı yapılandırma YAML dosyasında kaynak kimliklerini belirterek çalışma alanını oluştururken mevcut Azure kaynak örneklerini kullanabilirsiniz.
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]
[--provision-network-now]
[--public-network-access]
[--set]
[--storage-account]
[--system-datastores-auth-mode]
[--tags]
[--update-dependent-resources]
Örnekler
YAML belirtim dosyasından çalışma alanı oluşturun.
az ml workspace create --file workspace.yml --resource-group my-resource-group
Gerekli Parametreler
Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>
yapılandırabilirsiniz.
İsteğe Bağlı Parametreler
Bir çalışma alanının kaynak grubu düzeyinde rol atamaları olup olmadığını belirlemek için bir bayrak.
Bu çalışma alanıyla ilişkili uygulama içgörülerinin ARM kimliği.
Bu çalışma alanıyla ilişkili kapsayıcı kayıt defterinin ARM kimliği.
Yalnızca merkez türü. Ayarlanırsa, bu hub'ın alt projelerinde kaynak grubu varsayılan olarak bunu ayarlar.
Azure ML çalışma alanının açıklaması.
Çalışma alanının görünen adı.
Bir çalışma alanının veri yalıtımının etkinleştirilip etkinleştirilmediğini belirlemek için bir bayrak. Bayrak yalnızca oluşturma aşamasında ayarlanabilir, güncelleştirilemez.
Azure ML çalışma alanı belirtimini içeren YAML dosyasının yerel yolu. Çalışma alanı için YAML başvuru belgelerine şu konumdan ulaşabilirsiniz: https://aka.ms/ml-cli-v2-workspace-yaml-reference.
Yalnızca proje türü: Bu projenin üst hub'ını tanımlayan ARM kimliği.
Kapsayıcı kayıt defteri bir sanal ağın arkasındayken ortam Docker görüntüleri oluşturmak için kullanılacak işlem hedefinin adı.
Bu çalışma alanıyla ilişkili anahtar kasasının ARM kimliği.
Çalışma alanlarını, varsa YAML'de atanan değeri geçersiz kılarak belirli bir tür olarak belirtir. Varsayılan olarak varsayılandır. Geçerli türleri şunlardır: varsayılan, hub ve proje.
Yeni çalışma alanı için kullanılacak konum.
Çalışma alanı için Yönetilen Ağ Yalıtım Modu.
Azure ML çalışma alanının adı.
Çalışma alanı oluşturma işleminin bitmesini beklemeyin.
Birden çok kullanıcı belirtilmiş olması durumunda, birincil kullanıcı tarafından atanan yönetilen kimliğin ARM tanımlayıcısı. Ayrıca kümesiz işlem için varsayılan yönetilen kimlik.
Yönetilen ağın manged network etkinleştirilmiş bir çalışma alanı oluştururken sağlanmasını tetiklemesi için ayarlayın, aksi halde hiçbir şey yapmaz.
Çalışma alanı özel bağlantı etkinleştirildiğinde genel uç nokta bağlantısına izin verin.
Ayarlanacağı özellik yolunu ve değerini belirterek nesneyi güncelleştirin. Örnek: --set property1.property2=value.
Bu çalışma alanıyla ilişkili depolama hesabının ARM kimliği.
Sistem veri depoları için kimlik doğrulama modunu belirtir. Geçerli modlar şunlardır: erişim anahtarı ve kimlik.
Nesnenin etiketleri için boşlukla ayrılmış anahtar-değer çiftleri.
--update_dependent_resources belirterek çalışma alanına bağımlı kaynakları güncelleştirmek için onay verir. Çalışma alanına bağlı Azure Container Registry veya Application Insights kaynağının güncelleştirilmesi önceki işlerin kökenini, dağıtılan çıkarım uç noktalarını veya bu çalışma alanında önceki işleri yeniden çalıştırma yeteneğinizi bozabilir.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
az ml workspace delete
Çalışma alanını silme.
Varsayılan olarak, çalışma alanıyla ilişkili bağımlı kaynaklar (Azure Depolama, Azure Container Registry, Azure Key Vault, Azure Uygulaması lication Insights) silinmez. Bunları da silmek için --all-resources öğesini ekleyin. Çalışma alanını kalıcı olarak silmek için --permanently-delete öğesini ekleyin.
az ml workspace delete --name
--resource-group
[--all-resources]
[--no-wait]
[--permanently-delete]
[--yes]
Gerekli Parametreler
Azure ML çalışma alanının adı. varsayılan çalışma alanını kullanarak az configure --defaults workspace=<name>
yapılandırabilirsiniz.
Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>
yapılandırabilirsiniz.
İsteğe Bağlı Parametreler
Çalışma alanıyla ilişkili tüm bağımlı kaynakları silin (Azure Depolama hesabı, Azure Container Registry, Azure Uygulaması lication Insights, Azure Key Vault).
Uzun süre çalışan işlemin bitmesini beklemeyin. Varsayılan değer False'tur.
Çalışma alanı verilerinin kurtarılmasını sağlamak için çalışma alanları varsayılan olarak geçici olarak silinmiş durumdadır. Geçici silme davranışını geçersiz kılmak ve çalışma alanınızı kalıcı olarak silmek için bu bayrağı ayarlayın.
Onay istemde bulunmayın.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
az ml workspace diagnose
Çalışma alanı kurulum sorunlarını tanılama.
Çalışma alanınız beklendiği gibi çalışmıyorsa, çalışma alanının bozuk olup olmadığını denetlemek için bu tanılamayı çalıştırabilirsiniz. Özel uç nokta çalışma alanı için, bu çalışma alanının ve bağımlı kaynağının ağ kurulumunda sorun olup olmadığını denetlemeye de yardımcı olur.
az ml workspace diagnose --name
--resource-group
[--no-wait]
Örnekler
çalışma alanını tanılama.
az ml workspace diagnose --name my-workspace-name --no-wait -g my-resource-group
Gerekli Parametreler
Azure ML çalışma alanının adı. varsayılan çalışma alanını kullanarak az configure --defaults workspace=<name>
yapılandırabilirsiniz.
Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>
yapılandırabilirsiniz.
İsteğe Bağlı Parametreler
Uzun süre çalışan işlemin bitmesini beklemeyin. Varsayılan değer False'tur.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
az ml workspace list
Abonelikteki tüm çalışma alanlarını listeleme.
Çalışma alanlarının listesi kaynak grubuna göre filtrelenebilir.
az ml workspace list [--filtered-kinds]
[--max-results]
[--resource-group]
Örnekler
Kaynak grubundaki tüm çalışma alanlarını listeleme
az ml workspace list --resource-group my-resource-group
Komutların sonuçlarında JMESPath sorgusu yürütmek için --query bağımsız değişkenini kullanarak tüm çalışma alanını listeleyin.
az ml workspace list --query "[].{Name:name}" --output table --resource-group my-resource-group
İsteğe Bağlı Parametreler
Yalnızca belirtilen çalışma alanı türlerini virgülle ayrılmış liste olarak listeleyin. Geçerli türleri şunlardır: varsayılan, hub ve proje.
Döndürülecek en fazla sonuç sayısı.
Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>
yapılandırabilirsiniz.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
az ml workspace list-keys
Azure Depolama, Azure Container Registry ve Azure Uygulaması lication Insights gibi bağımlı kaynaklar için çalışma alanı anahtarlarını listeleyin.
az ml workspace list-keys --name
--resource-group
Gerekli Parametreler
Azure ML çalışma alanının adı. varsayılan çalışma alanını kullanarak az configure --defaults workspace=<name>
yapılandırabilirsiniz.
Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>
yapılandırabilirsiniz.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
az ml workspace provision-network
Çalışma alanı yönetilen ağı sağlama.
Yönetilen ağı sağlamak için çalışma alanını tetikler. Spark özellikli bayrağının belirtilmesi, çalışma alanı yönetilen ağını Spark'ı desteklemek için hazırlar. Belirtilmezse varsayılan değer false olur, ancak daha sonra bu komut bu bayrakla yeniden çalıştırılarak etkinleştirilebilir. Etkinleştirildikten sonra devre dışı bırakılamaz.
az ml workspace provision-network --name
--resource-group
[--include-spark]
[--no-wait]
Örnekler
yönetilen ağ sağlama.
az ml workspace provision-network --include-spark --name my-workspace-name --no-wait -g my-resource-group
Gerekli Parametreler
Azure ML çalışma alanının adı. varsayılan çalışma alanını kullanarak az configure --defaults workspace=<name>
yapılandırabilirsiniz.
Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>
yapılandırabilirsiniz.
İsteğe Bağlı Parametreler
Spark işlerini hesaba eklemek için yönetilen ağ sağlanması gerekiyorsa boole değeri [true/false]. Bayrak ayarlanmadıysa varsayılan değer false'tur. Daha sonra bu komut bu bayrakla yeniden çalıştırılarak etkinleştirilebilir.
Uzun süre çalışan işlemin bitmesini beklemeyin. Varsayılan değer False'tur.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
az ml workspace show
Çalışma alanının ayrıntılarını gösterme.
az ml workspace show --name
--resource-group
Gerekli Parametreler
Azure ML çalışma alanının adı. varsayılan çalışma alanını kullanarak az configure --defaults workspace=<name>
yapılandırabilirsiniz.
Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>
yapılandırabilirsiniz.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
az ml workspace sync-keys
Azure Depolama, Azure Container Registry ve Azure Uygulaması lication Insights gibi bağımlı kaynaklar için çalışma alanı anahtarlarını eşitleyin.
Çalışma alanı içindeki herhangi bir kaynağın anahtarları değiştirilirse, bunların otomatik olarak güncelleştirilmiş olması yaklaşık bir saat sürebilir. Bu komut, anahtarları hemen eşitlemek için çalışma alanını tetikler. Olası bir senaryo, depolama anahtarlarını yeniden oluşturarak depolamaya hemen erişmeye ihtiyaç duyar.
az ml workspace sync-keys --name
--resource-group
[--no-wait]
Gerekli Parametreler
Azure ML çalışma alanının adı. varsayılan çalışma alanını kullanarak az configure --defaults workspace=<name>
yapılandırabilirsiniz.
Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>
yapılandırabilirsiniz.
İsteğe Bağlı Parametreler
Uzun süre çalışan işlemin bitmesini beklemeyin. Varsayılan değer False'tur.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
az ml workspace update
Çalışma alanını güncelleştirme.
'description', 'tags' ve 'friendly_name' özellikleri güncelleştirilebilir.
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]
[--network-acls]
[--no-wait]
[--primary-user-assigned-identity]
[--public-network-access]
[--remove]
[--set]
[--system-datastores-auth-mode]
[--update-dependent-resources]
Örnekler
yaml belirtim dosyasından bir çalışma alanını güncelleştirin.
az ml workspace update --resource-group my-resource-group --name my-workspace-name --file workspace.yml
Gerekli Parametreler
Azure ML çalışma alanının adı. varsayılan çalışma alanını kullanarak az configure --defaults workspace=<name>
yapılandırabilirsiniz.
Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>
yapılandırabilirsiniz.
İsteğe Bağlı Parametreler
Bir yol ve anahtar değer çiftleri belirterek nesne listesine nesne ekleyin. Örnek: --add property.listProperty <key=value, string or JSON string>
.
Bir çalışma alanının kaynak grubu düzeyinde rol atamaları olup olmadığını belirlemek için bir bayrak.
Bu çalışma alanıyla ilişkili uygulama içgörülerinin ARM kimliği.
Bu çalışma alanıyla ilişkili kapsayıcı kayıt defterinin ARM kimliği.
Azure ML çalışma alanının açıklaması.
Çalışma alanının görünen adı.
Azure ML çalışma alanı belirtimini içeren YAML dosyasının yerel yolu. Çalışma alanı için YAML başvuru belgelerine şu konumdan ulaşabilirsiniz: https://aka.ms/ml-cli-v2-workspace-yaml-reference.
'set' veya 'add' kullanırken, JSON'a dönüştürmeye çalışmak yerine dize değişmez değerlerini koruyun.
Kapsayıcı kayıt defteri bir sanal ağın arkasındayken ortam Docker görüntüleri oluşturmak için kullanılacak işlem hedefinin adı.
Çalışma alanı için Yönetilen Ağ Yalıtım Modu.
CIDR gösteriminde çalışma alanına erişmesine izin verilen IP adreslerinin veya IP aralıklarının virgülle ayrılmış listesi. Örnek: 'XX.XX.XX.XX,XX.XX.XX/32'. Genel ağ erişimini 'Etkin' olarak ayarlamak için networkAcls'i 'hiçbiri' (yani ağ acl'lerini sıfırlar) ve PNA bayrağını 'Etkin' olarak ayarlayın. Devre dışı bırakmak için PNA bayrağını 'Devre dışı' olarak ayarlayın. Genel ağ erişimini 'Seçili IP adreslerinden etkinleştirildi' olarak ayarlamak için PNA bayrağını 'Etkin' olarak ayarlayın ve 'network-acls'de CIDR gösteriminde IP'lerin virgülle ayrılmış listesini geçirin.
Uzun süre çalışan işlemin bitmesini beklemeyin. Varsayılan değer False'tur.
Bu çalışma alanıyla ilişkili birincil kullanıcı tarafından atanan kimliğin ARM kimliği.
Çalışma alanı özel bağlantı etkinleştirildiğinde genel uç nokta bağlantısına izin verin.
Bir özelliği veya öğeyi listeden kaldırın. Örnek: --remove property.list <indexToRemove>
OR --remove propertyToRemove
.
Ayarlanacağı özellik yolunu ve değerini belirterek nesneyi güncelleştirin. Örnek: --set property1.property2=<value>
.
Sistem veri depoları için kimlik doğrulama modunu belirtir. Geçerli modlar şunlardır: erişim anahtarı ve kimlik.
--update_dependent_resources belirterek çalışma alanına bağımlı kaynakları güncelleştirmek için onay verir. Çalışma alanına bağlı Azure Container Registry veya Application Insights kaynağının güncelleştirilmesi önceki işlerin kökenini, dağıtılan çıkarım uç noktalarını veya bu çalışma alanında önceki işleri yeniden çalıştırma yeteneğinizi bozabilir.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.