az ml batch-endpoint

Note

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

Azure ML toplu iş uç noktalarını yönetin.

Azure ML uç noktaları, model dağıtımları oluşturmak ve yönetmek için basit bir arabirim sağlar. Her uç noktanın bir veya daha fazla dağıtımı olabilir. Toplu iş uç noktaları çevrimdışı toplu puanlama için kullanılır.

Komutlar

Name	Description	Tür	Durum
az ml batch-endpoint create	Uç nokta oluşturma.	Extension	GA
az ml batch-endpoint delete	Uç noktayı silme.	Extension	GA
az ml batch-endpoint invoke	Uç nokta çağırma.	Extension	GA
az ml batch-endpoint list	Çalışma alanında uç noktaları listeleme.	Extension	GA
az ml batch-endpoint list-jobs	Toplu iş uç noktası için toplu puanlama işlerini listeleyin.	Extension	GA
az ml batch-endpoint show	Uç noktanın ayrıntılarını gösterme.	Extension	GA
az ml batch-endpoint update	Uç noktayı güncelleştirme.	Extension	GA

az ml batch-endpoint create

Uç nokta oluşturma.

Uç nokta oluşturmak için toplu uç nokta yapılandırmasına sahip bir YAML dosyası sağlayın. Uç nokta zaten varsa, yeni ayarlarla üzerine yazılır.

az ml batch-endpoint create --resource-group
                            --workspace-name
                            [--acquire-policy-token]
                            [--change-reference]
                            [--file]
                            [--name]
                            [--no-wait]
                            [--set]

Örnekler

YAML belirtim dosyasından uç nokta oluşturma

az ml batch-endpoint create --file endpoint.yml --resource-group my-resource-group --workspace-name my-workspace

Adla uç nokta oluşturma

az ml batch-endpoint create --name endpointname --resource-group my-resource-group --workspace-name my-workspace

Gerekli Parametreler

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

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--file -f

Azure ML toplu uç nokta belirtimini içeren YAML dosyasının yerel yolu. Batch-endpoint için YAML başvuru belgeleri şu konumda bulunabilir: https://aka.ms/ml-cli-v2-endpoint-batch-yaml-reference.

--name -n

Toplu iş uç noktasının adı.

--no-wait

Uzun süre çalışan işlemin bitmesini beklemeyin. Varsayılan değer False'tur.

Özellik	Değer
Default value:	False

--set

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

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.

Özellik	Değer
Default value:	False

--help -h

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

--only-show-errors

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

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

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

Özellik	Değer
Default value:	False

az ml batch-endpoint delete

Uç noktayı silme.

az ml batch-endpoint delete --name
                            --resource-group
                            --workspace-name
                            [--acquire-policy-token]
                            [--change-reference]
                            [--no-wait]
                            [--yes]

Örnekler

Tüm dağıtımları da dahil olmak üzere bir toplu iş uç noktasını silme

az ml batch-endpoint delete --name my-batch-endpoint --resource-group my-resource-group --workspace-name my-workspace

Gerekli Parametreler

--name -n

Toplu iş uç noktasının 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ı. varsayılan çalışma alanını kullanarak az configure --defaults workspace=<name>yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--no-wait

Uzun süre çalışan işlemin bitmesini beklemeyin. Varsayılan değer False'tur.

Özellik	Değer
Default value:	False

--yes -y

Onay istemde bulunmayın.

Özellik	Değer
Default value:	False

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.

Özellik	Değer
Default value:	False

--help -h

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

--only-show-errors

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

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

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

Özellik	Değer
Default value:	False

az ml batch-endpoint invoke

Uç nokta çağırma.

Uç noktayı bazı verilerle çağırarak toplu çıkarım çalıştırmasını başlatabilirsiniz. Toplu iş uç noktaları için, çağırma zaman uyumsuz bir toplu puanlama işini tetikler.

az ml batch-endpoint invoke --name
                            --resource-group
                            --workspace-name
                            [--acquire-policy-token]
                            [--change-reference]
                            [--deployment-name]
                            [--experiment-name]
                            [--file]
                            [--input]
                            [--input-type]
                            [--inputs]
                            [--instance-count]
                            [--job-name]
                            [--mini-batch-size]
                            [--output-path]
                            [--outputs]
                            [--set]

Örnekler

Kayıtlı Azure ML veri varlığından giriş verileri içeren bir toplu iş uç noktası çağırma ve mini_batch_size için varsayılan dağıtım ayarını geçersiz kılma

az ml batch-endpoint invoke --name my-batch-endpoint --input azureml:my-dataset:1 --mini-batch-size 64 --resource-group my-resource-group --workspace-name my-workspace

Genel URI'den giriş dosyasıyla bir toplu iş uç noktası çağırma

az ml batch-endpoint invoke --name my-batch-endpoint --input-type uri_file --input https://pipelinedata.blob.core.windows.net/sampledata/mnist/0.png --resource-group my-resource-group --workspace-name my-workspace

Kayıtlı bir veri deposundan giriş dosyasıyla toplu iş uç noktasını çağırma

az ml batch-endpoint invoke --name my-batch-endpoint --input-type uri_file --input azureml://datastores/workspaceblobstore/paths/{path_to_data}/mnist/0.png --resource-group my-resource-group --workspace-name my-workspace

Genel URI'den giriş klasörüyle toplu iş uç noktasını çağırma

az ml batch-endpoint invoke --name my-batch-endpoint --input-type uri_folder --input https://pipelinedata.blob.core.windows.net/sampledata/mnist --resource-group my-resource-group --workspace-name my-workspace

Kayıtlı bir veri deposundan giriş klasörüyle toplu iş uç noktasını çağırma

az ml batch-endpoint invoke --name my-batch-endpoint --input-type uri_folder --input azureml://datastores/workspaceblobstore/paths/{path_to_data}/mnist --resource-group my-resource-group --workspace-name my-workspace

Yerel klasördeki dosyaları içeren bir toplu iş uç noktasını çağırma

az ml batch-endpoint invoke --name my-batch-endpoint --input ./mnist_folder --resource-group my-resource-group --workspace-name my-workspace

Giriş ve çıkış yolu olarak yerel klasöre sahip bir toplu iş uç noktasını çağırın ve uç nokta çağrısı sırasında bazı toplu dağıtım ayarlarının üzerine yazın

az ml batch-endpoint invoke --name my-batch-endpoint --input ./mnist_folder --instance-count 2 --mini-batch-size 5 --output-path azureml://datastores/workspaceblobstore/paths/tests/output --resource-group my-resource-group --workspace-name my-workspace

Gerekli Parametreler

--name -n

Toplu iş uç noktasının 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ı. varsayılan çalışma alanını kullanarak az configure --defaults workspace=<name>yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--deployment-name -d

Hedeflene dağıtımın adı.

--experiment-name

İşlem hattı bileşeni dağıtımı denemesinin adı.

--file -f

Toplu çağrı için kullanılan dosyanın adı.

--input

Toplu çıkarım için kullanılacak giriş verilerine başvuru. Veri deposundaki bir yol, genel URI, kayıtlı bir veri varlığı veya yerel klasör yolu olabilir.

--input-type

Bir dosya mı yoksa klasör mü olduğunu belirten girişin türü. Veri deposunda veya genel URI'de yol kullanırken bunu kullanın. Desteklenen değerler: uri_folder, uri_file.

--inputs

Çağırma işlerinin girişlerinin sözlüğü.

--instance-count -c

Tahminin çalıştırılacağı örnek sayısı.

--job-name

Toplu çağrı için işin adı.

--mini-batch-size -m

Giriş verilerinin tahmin için bölüneceği her mini toplu işlemin boyutu.

--output-path

Çıkış dosyalarının yüklendiği veri deposundaki yol.

--outputs

Sonuçların depolandığı yeri belirten sözlük.

--set

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

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.

Özellik	Değer
Default value:	False

--help -h

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

--only-show-errors

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

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

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

Özellik	Değer
Default value:	False

az ml batch-endpoint list

Çalışma alanında uç noktaları listeleme.

az ml batch-endpoint list --resource-group
                          --workspace-name

Örnekler

Çalışma alanında tüm toplu iş uç noktalarını listeleme

az ml batch-endpoint list --resource-group my-resource-group --workspace-name my-workspace

Çalışma alanında tüm toplu iş uç noktalarını listeleme

az ml batch-endpoint list  --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 tüm toplu iş uç noktalarını listeleyin.

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

Gerekli Parametreler

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

Özellik	Değer
Default value:	False

--help -h

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

--only-show-errors

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

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

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

Özellik	Değer
Default value:	False

az ml batch-endpoint list-jobs

Toplu iş uç noktası için toplu puanlama işlerini listeleyin.

az ml batch-endpoint list-jobs --name
                               --resource-group
                               --workspace-name
                               [--acquire-policy-token]
                               [--change-reference]

Örnekler

Uç nokta için tüm toplu puanlama işlerini listeleme

az ml batch-endpoint list-jobs --name my-batch-endpoint --resource-group my-resource-group --workspace-name my-workspace

Gerekli Parametreler

--name -n

Toplu iş uç noktasının 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ı. varsayılan çalışma alanını kullanarak az configure --defaults workspace=<name>yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

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.

Özellik	Değer
Default value:	False

--help -h

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

--only-show-errors

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

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

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

Özellik	Değer
Default value:	False

az ml batch-endpoint show

Uç noktanın ayrıntılarını gösterme.

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

Örnekler

Toplu iş uç noktasının ayrıntılarını gösterme

az ml batch-endpoint show --name my-batch-endpoint  --resource-group my-resource-group --workspace-name my-workspace

Komutların sonuçlarında JMESPath sorgusu yürütmek için --query bağımsız değişkenini kullanarak uç noktanın sağlama durumunu gösterin.

az ml batch-endpoint show -n my-endpoint --query "{Name:name,State:provisioning_state}"  --output table --resource-group my-resource-group --workspace-name my-workspace

Gerekli Parametreler

--name -n

Toplu iş uç noktasının 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ı. 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.

Özellik	Değer
Default value:	False

--help -h

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

--only-show-errors

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

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

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

Özellik	Değer
Default value:	False

az ml batch-endpoint update

Uç noktayı güncelleştirme.

Bir uç noktanın 'description', 'tags' ve 'defaults' özellikleri güncelleştirilebilir. Ayrıca, bir uç noktaya yeni dağıtımlar eklenebilir ve mevcut dağıtımlar güncelleştirilebilir.

az ml batch-endpoint update --resource-group
                            --workspace-name
                            [--acquire-policy-token]
                            [--add]
                            [--change-reference]
                            [--defaults]
                            [--file]
                            [--force-string]
                            [--name]
                            [--no-wait]
                            [--remove]
                            [--set]

Örnekler

YAML belirtim dosyasından uç noktayı güncelleştirme

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

Mevcut uç noktaya yeni dağıtım ekleme

az ml batch-endpoint update --name my-batch-endpoint  --set defaults.deployment_name=depname  --resource-group my-resource-group --workspace-name my-workspace

Gerekli Parametreler

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

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--add

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

Özellik	Değer
Parametre grubu:	Generic Update Arguments
Default value:	[]

--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--defaults

Uç nokta çağrısı için varsayılan ayarların içindeki deployment_name güncelleştirin.

--file -f

--force-string

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

Özellik	Değer
Parametre grubu:	Generic Update Arguments
Default value:	False

--name -n

Toplu iş uç noktasının adı.

--no-wait

Uzun süre çalışan işlemin bitmesini beklemeyin. Varsayılan değer False'tur.

Özellik	Değer
Default value:	False

--remove

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

Özellik	Değer
Parametre grubu:	Generic Update Arguments
Default value:	[]

--set

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

Özellik	Değer
Parametre grubu:	Generic Update Arguments
Default value:	[]

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.

Özellik	Değer
Default value:	False

--help -h

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

--only-show-errors

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

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

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

Özellik	Değer
Default value:	False

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?