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 öğrenin.

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.

 Uzantı GA
az ml component create

Bir bileşen oluşturun.

 Uzantı GA
az ml component list

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

 Uzantı GA
az ml component prepare-for-sign

İmzalama için bir bileşen hazırlayın.

 Uzantı GA
az ml component restore

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

 Uzantı GA
az ml component show

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

 Uzantı 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.

 Uzantı 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 az ml component restorekullanarak geri 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ı. az configure --defaults group=<name>kullanarak varsayılan grubu yapılandırabilirsiniz.

--version -v

Bileşenin sürümü.

--workspace-name -w

Azure ML çalışma alanının adı. az configure --defaults workspace=<name>kullanarak varsayılan çalışma alanını 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
Default value: json
--query

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

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayı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ı. az configure --defaults group=<name>kullanarak varsayılan grubu yapılandırabilirsiniz.

--set

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

--skip-validation

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

Default value: False
--version -v

Bileşenin sürümü.

--workspace-name -w

Azure ML çalışma alanının adı. az configure --defaults workspace=<name>kullanarak varsayılan çalışma alanını 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
Default value: json
--query

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

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayı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.

Default value: False
--include-archived

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

Default value: 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ı. az configure --defaults group=<name>kullanarak varsayılan grubu yapılandırabilirsiniz.

--workspace-name -w

Azure ML çalışma alanının adı. az configure --defaults workspace=<name>kullanarak varsayılan çalışma alanını 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
Default value: json
--query

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

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayı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 prepare-for-sign

İmzalama için bir bileşen hazırlayın.

Bir bileşenin imza için hazırlanması 2 dosya oluşturur: catalog.json ve catalog.json.sig, bu dosyalar hedef klasörde bulunan her dosya için oluşturulan SHA256'yı içerir. Dosyalar zaten varsa silinir ve güncelleştirilmiş imzayla yeni dosyalar oluşturulur.

az ml component prepare-for-sign --file
                                 [--registry-name]
                                 [--resource-group]
                                 [--workspace-name]

Örnekler

YAML belirtim dosyasından imza için bileşen hazırlama

az ml component prepare-for-sign --file my_component.yml --resource-group my-resource-group --workspace-name my-workspace

YAML belirtim dosyasından kayıt defterindeki bir bileşeni imzalama için hazırlama

az ml component prepare-for-sign --file my_component.yml --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

--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ı. az configure --defaults group=<name>kullanarak varsayılan grubu yapılandırabilirsiniz.

--workspace-name -w

Azure ML çalışma alanının adı. az configure --defaults workspace=<name>kullanarak varsayılan çalışma alanını 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
Default value: json
--query

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

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayı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 (az ml component list) gizlenmeyecektir. 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ı. az configure --defaults group=<name>kullanarak varsayılan grubu yapılandırabilirsiniz.

--version -v

Bileşenin sürümü.

--workspace-name -w

Azure ML çalışma alanının adı. az configure --defaults workspace=<name>kullanarak varsayılan çalışma alanını 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
Default value: json
--query

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

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayı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ı. az configure --defaults group=<name>kullanarak varsayılan grubu yapılandırabilirsiniz.

--version -v

Bileşenin sürümü.

--workspace-name -w

Azure ML çalışma alanının adı. az configure --defaults workspace=<name>kullanarak varsayılan çalışma alanını 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
Default value: json
--query

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

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayı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ı. az configure --defaults group=<name>kullanarak varsayılan grubu yapılandırabilirsiniz.

--workspace-name -w

Azure ML çalışma alanının adı. az configure --defaults workspace=<name>kullanarak varsayılan çalışma alanını 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>.

Default value: []
--force-string

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

Default value: 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> VEYA --remove propertyToRemove.

Default value: []
--set

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

Default value: []
--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
Default value: json
--query

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

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayı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.