Aracılığıyla paylaş

az ml component

  • Başvuru

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 component komutunu ilk kez çalıştırdığınızda otomatik olarak yüklenir. Uzantılar hakkında daha fazla bilgi edinin.

Azure ML bileşenlerini yönetme.

Azure ML bileşeni, işlem hattı işleri için bileşenin yapılandırmasını tanımlar. Giriş/çıkış bağlantı noktalarını, yürütme ortamını ve bileşenin komutunu yapılandırabilirsiniz. Bileşen oluşturulduktan sonra, docker kapsayıcılarında yürütmek için işlem hattı işi bileşenlerine başvurabilirsiniz.

Komutlar

Name Description Tür Durum
az ml component archive

Bir bileşeni arşivleyin.

 Dahili GA
az ml component create

Bir bileşen oluşturun.

 Dahili GA
az ml component list

Çalışma alanında bileşenleri listeleme.

 Dahili GA
az ml component restore

Arşivlenmiş bir bileşeni geri yükleme.

 Dahili GA
az ml component show

Bir bileşenin ayrıntılarını gösterme.

 Dahili GA
az ml component update

Bir bileşeni güncelleştirme. Şu anda yalnızca birkaç alan (açıklama, display_name) desteği güncelleştirmesi.

 Dahili GA

az ml component archive

Bir bileşeni arşivleyin.

Bir bileşeni arşivleme, varsayılan olarak liste sorgularından gizler (az ml component list ). İşlem hatlarınızda arşivlenmiş bir bileşene başvurmaya ve kullanmaya devam edebilirsiniz. Bir bileşen kapsayıcısı veya belirli bir bileşen sürümünü arşivleyebilirsiniz. Bir bileşen kapsayıcısının arşivlenmesi, bileşenin tüm sürümlerini verilen ad altında arşivler. arşivlenmiş bir bileşeni kullanarak az ml component restoregeri yükleyebilirsiniz. Bileşen kapsayıcısının tamamı arşivlenmişse, bileşenin tek tek sürümlerini geri yükleyemezsiniz. Bileşen kapsayıcısını geri yüklemeniz gerekir.

az ml component archive --name
                        [--label]
                        [--registry-name]
                        [--resource-group]
                        [--version]
                        [--workspace-name]

Örnekler

Bileşen kapsayıcısı arşivle (bu bileşenin tüm sürümlerini arşivler)

az ml component archive --name my-component --resource-group my-resource-group --workspace-name my-workspace

Belirli bir bileşen sürümünü arşivle

az ml component archive --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

Gerekli Parametreler

--name -n

Bileşenin adı.

İsteğe Bağlı Parametreler

--label -l

Bileşenin etiketi.

--registry-name

Sağlanırsa, komut çalışma alanı yerine kayıt defterini hedefler. Bu nedenle kaynak grubu ve çalışma alanı gerekli olmayacaktır.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--version -v

Bileşenin sürümü.

--workspace-name -w

Azure ML çalışma alanının adı. varsayılan çalışma alanını kullanarak az configure --defaults workspace=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

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 component create

Bir bileşen oluşturun.

az ml component create --file
                       [--name]
                       [--registry-name]
                       [--resource-group]
                       [--set]
                       [--skip-validation]
                       [--version]
                       [--workspace-name]

Örnekler

YAML belirtim dosyasından bileşen oluşturma

az ml component create --file my_component.yml --resource-group my-resource-group --workspace-name my-workspace

Belirtilen sürüme sahip bir YAML belirtim dosyasından bileşen oluşturma

az ml component create --file my_component.yml --version 1 --resource-group my-resource-group --workspace-name my-workspace

YAML belirtim dosyasından kayıt defterinde bileşen oluşturma

az ml component create --file my_component.yml --registry-name my-registry-name --resource-group my-resource-group

Belirtilen sürüme sahip bir YAML belirtim dosyasından kayıt defterinde bileşen oluşturma

az ml component create --file my_component.yml --version 1 --registry-name my-registry-name --resource-group my-resource-group

Gerekli Parametreler

--file -f

Azure ML bileşen belirtimini içeren YAML dosyasının yerel yolu. Bileşenin YAML başvuru belgelerine şu konumdan ulaşabilirsiniz: https://aka.ms/ml-cli-v2-component-command-yaml-reference.

İsteğe Bağlı Parametreler

--name -n

Bileşenin adı.

--registry-name

Sağlanırsa, komut çalışma alanı yerine kayıt defterini hedefler. Bu nedenle kaynak grubu ve çalışma alanı gerekli olmayacaktır.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--set

Ayarlanacağı özellik yolunu ve değerini belirterek nesneyi güncelleştirin. Örnek: --set property1.property2=.

--skip-validation

Kaynağı oluştururken doğrulamayı atlayın. Bağımlı kaynakların oluşturmada doğrulamalarını atlamayacaklarını unutmayın.

varsayılan değer: False
--version -v

Bileşenin sürümü.

--workspace-name -w

Azure ML çalışma alanının adı. varsayılan çalışma alanını kullanarak az configure --defaults workspace=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

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 component list

Çalışma alanında bileşenleri listeleme.

az ml component list [--archived-only]
                     [--include-archived]
                     [--max-results]
                     [--name]
                     [--registry-name]
                     [--resource-group]
                     [--workspace-name]

Örnekler

Çalışma alanında tüm bileşenleri listeleme

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

Çalışma alanında belirtilen ad için tüm bileşen sürümlerini listeleme

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

Komutların sonuçları üzerinde JMESPath sorgusu yürütmek için --query bağımsız değişkenini kullanarak çalışma alanında bulunan tüm bileşenleri listeleyin.

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

Kayıt defterindeki tüm bileşenleri listeleme

az ml component list --registry-name my-registry-name --resource-group my-resource-group

Bir kayıt defterinde belirtilen ad için tüm bileşen sürümlerini listeleme

az ml component list --name my-component --registry-name my-registry-name --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 kayıt defterindeki tüm bileşenleri listeleyin.

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

İsteğe Bağlı Parametreler

--archived-only

Yalnızca arşivlenmiş bileşenleri listeleyin.

varsayılan değer: False
--include-archived

Arşivlenen bileşenleri ve etkin bileşenleri listeleyin.

varsayılan değer: False
--max-results -r

Döndürülecek en fazla sonuç sayısı.

--name -n

Bileşenin adı.

--registry-name

Sağlanırsa, komut çalışma alanı yerine kayıt defterini hedefler. Bu nedenle kaynak grubu ve çalışma alanı gerekli olmayacaktır.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--workspace-name -w

Azure ML çalışma alanının adı. varsayılan çalışma alanını kullanarak az configure --defaults workspace=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

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 component restore

Arşivlenmiş bir bileşeni geri yükleme.

Arşivlenmiş bir bileşen geri yüklendiğinde, artık liste sorgularından () gizlenmeyecektiraz ml component list. Bileşen kapsayıcının tamamı arşivlenmişse, arşivlenmiş kapsayıcıyı geri yükleyebilirsiniz. Bu işlem, bileşenin bu adın altındaki tüm sürümlerini geri yükler. Bileşen kapsayıcısının tamamı arşivlenmişse yalnızca belirli bir bileşen sürümünü geri yükleyemezsiniz. Kapsayıcının tamamını geri yüklemeniz gerekir. Yalnızca tek bir bileşen sürümü arşivlendiyse, bu belirli sürümü geri yükleyebilirsiniz.

az ml component restore --name
                        [--label]
                        [--registry-name]
                        [--resource-group]
                        [--version]
                        [--workspace-name]

Örnekler

Arşivlenmiş bileşen kapsayıcısı geri yükleme (bu bileşenin tüm sürümlerini geri yükler)

az ml component restore --name my-component --resource-group my-resource-group --workspace-name my-workspace

Belirli bir arşivlenmiş bileşen sürümünü geri yükleme

az ml component restore --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

Gerekli Parametreler

--name -n

Bileşenin adı.

İsteğe Bağlı Parametreler

--label -l

Bileşenin etiketi.

--registry-name

Sağlanırsa, komut çalışma alanı yerine kayıt defterini hedefler. Bu nedenle kaynak grubu ve çalışma alanı gerekli olmayacaktır.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--version -v

Bileşenin sürümü.

--workspace-name -w

Azure ML çalışma alanının adı. varsayılan çalışma alanını kullanarak az configure --defaults workspace=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

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 component show

Bir bileşenin ayrıntılarını gösterme.

az ml component show --name
                     [--label]
                     [--registry-name]
                     [--resource-group]
                     [--version]
                     [--workspace-name]

Örnekler

Belirtilen ada ve sürüme sahip bir bileşenin ayrıntılarını gösterme

az ml component show --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

Belirtilen ad ve sürüme sahip kayıt defterindeki bir bileşenin ayrıntılarını gösterme

az ml component show --name my-component --version 1 --registry-name my-registry-name --resource-group my-resource-group

Gerekli Parametreler

--name -n

Bileşenin adı.

İsteğe Bağlı Parametreler

--label -l

Bileşenin etiketi.

--registry-name

Sağlanırsa, komut çalışma alanı yerine kayıt defterini hedefler. Bu nedenle kaynak grubu ve çalışma alanı gerekli olmayacaktır.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--version -v

Bileşenin sürümü.

--workspace-name -w

Azure ML çalışma alanının adı. varsayılan çalışma alanını kullanarak az configure --defaults workspace=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

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 component update

Bir bileşeni güncelleştirme. Şu anda yalnızca birkaç alan (açıklama, display_name) desteği güncelleştirmesi.

az ml component update --name
                       --resource-group
                       --workspace-name
                       [--add]
                       [--force-string]
                       [--label]
                       [--registry-name]
                       [--remove]
                       [--set]
                       [--version]

Örnekler

Bileşenin açıklamasını güncelleştirme

az ml component update -n my_component -v 1 --set description="new description" -g my-resource-group -w my-workspace

Gerekli Parametreler

--name -n

Bileşenin adı.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--workspace-name -w

Azure ML çalışma alanının adı. varsayılan çalışma alanını kullanarak az configure --defaults workspace=<name>yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

--add

Bir yol ve anahtar değer çiftleri belirterek nesne listesine nesne ekleyin. Örnek: --add property.listProperty <key=value, string or JSON string>.

varsayılan değer: []
--force-string

'set' veya 'add' kullanırken, JSON'a dönüştürmeye çalışmak yerine dize değişmez değerlerini koruyun.

varsayılan değer: False
--label -l

Bileşenin etiketi.

--registry-name

Sağlanırsa, komut çalışma alanı yerine kayıt defterini hedefler. Bu nedenle kaynak grubu ve çalışma alanı gerekli olmayacaktır.

--remove

Bir özelliği veya öğeyi listeden kaldırın. Örnek: --remove property.list <indexToRemove> OR --remove propertyToRemove.

varsayılan değer: []
--set

Ayarlanacağı özellik yolunu ve değerini belirterek nesneyi güncelleştirin. Örnek: --set property1.property2=<value>.

varsayılan değer: []
--version -v

Bileşenin sürümü.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.