Bagikan melalui

az ml batch-endpoint

  • Referensi

Nota

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 batch-endpoint. Pelajari selengkapnya tentang ekstensi.

Mengelola titik akhir batch Azure ML.

Titik akhir Azure ML menyediakan antarmuka sederhana untuk membuat dan mengelola penyebaran model. Setiap titik akhir dapat memiliki satu atau beberapa penyebaran. Titik akhir batch digunakan untuk penilaian batch offline.

Perintah

Nama Deskripsi Jenis Status
az ml batch-endpoint create

Membuat titik akhir.

 Ekstensi GA
az ml batch-endpoint delete

Menghapus titik akhir.

 Ekstensi GA
az ml batch-endpoint invoke

Memanggil titik akhir.

 Ekstensi GA
az ml batch-endpoint list

Mencantumkan titik akhir di ruang kerja.

 Ekstensi GA
az ml batch-endpoint list-jobs

Cantumkan pekerjaan penilaian batch untuk titik akhir batch.

 Ekstensi GA
az ml batch-endpoint show

Perlihatkan detail untuk titik akhir.

 Ekstensi GA
az ml batch-endpoint update

Memperbarui titik akhir.

 Ekstensi GA

az ml batch-endpoint create

Membuat titik akhir.

Untuk membuat titik akhir, berikan file YAML dengan konfigurasi titik akhir batch. Jika titik akhir sudah ada, titik akhir akan ditulis berlebihan dengan pengaturan baru.

az ml batch-endpoint create --resource-group
                            --workspace-name
                            [--file]
                            [--name]
                            [--no-wait]
                            [--set]

Contoh

Membuat titik akhir dari file spesifikasi YAML

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

Membuat titik akhir dengan nama

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

Parameter yang Diperlukan

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--workspace-name -w

Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>.

Parameter Opsional

--file -f

Jalur lokal ke file YAML yang berisi spesifikasi titik akhir batch Azure ML. Dokumen referensi YAML untuk titik akhir batch dapat ditemukan di: https://aka.ms/ml-cli-v2-endpoint-batch-yaml-reference.

--name -n

Nama titik akhir batch.

--no-wait

Jangan tunggu hingga operasi jangka panjang selesai. Defaultnya adalah False.

Nilai default: False
--set

Perbarui objek dengan menentukan jalur properti dan nilai yang akan diatur. Contoh: --set property1.property2=value.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

--output -o

Format output.

Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
Nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az ml batch-endpoint delete

Menghapus titik akhir.

az ml batch-endpoint delete --name
                            --resource-group
                            --workspace-name
                            [--no-wait]
                            [--yes]

Contoh

Menghapus titik akhir batch, termasuk semua penyebarannya

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

Parameter yang Diperlukan

--name -n

Nama titik akhir batch.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--workspace-name -w

Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>.

Parameter Opsional

--no-wait

Jangan tunggu hingga operasi jangka panjang selesai. Defaultnya adalah False.

Nilai default: False
--yes -y

Jangan meminta konfirmasi.

Nilai default: False
Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

--output -o

Format output.

Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
Nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az ml batch-endpoint invoke

Memanggil titik akhir.

Anda dapat memulai inferensi batch yang dijalankan dengan memanggil titik akhir dengan beberapa data. Untuk titik akhir batch, pemanggilan akan memicu pekerjaan penilaian batch asinkron.

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

Contoh

Panggil titik akhir batch dengan data input dari aset data Azure ML terdaftar dan ambil alih pengaturan penyebaran default untuk mini_batch_size

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

Memanggil titik akhir batch dengan file input dari URI publik

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

Memanggil titik akhir batch dengan file input dari datastore terdaftar

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

Memanggil titik akhir batch dengan folder input dari URI publik

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

Memanggil titik akhir batch dengan folder input dari datastore terdaftar

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

Memanggil titik akhir batch dengan file di folder lokal

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

Panggil titik akhir batch dengan folder lokal sebagai jalur input dan output dan timpa beberapa pengaturan penyebaran batch selama pemanggilan titik akhir

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

Parameter yang Diperlukan

--name -n

Nama titik akhir batch.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--workspace-name -w

Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>.

Parameter Opsional

--deployment-name -d

Nama penyebaran ke target.

--experiment-name

Nama eksperimen untuk penyebaran komponen alur.

--file -f

Nama file yang digunakan untuk pemanggilan batch.

--input

Referensi ke data input yang akan digunakan untuk inferensi batch. Ini bisa menjadi jalur di datastore, URI publik, aset data terdaftar, atau jalur folder lokal.

--input-type

Jenis input, menentukan apakah itu file atau folder. Gunakan ini saat Anda menggunakan jalur di datastore atau URI publik. Nilai yang didukung: uri_folder, uri_file.

--inputs

Kamus Input pekerjaan pemanggilan.

--instance-count -c

Jumlah instans yang akan dijalankan prediksi.

--job-name

Nama pekerjaan untuk pemanggilan batch.

--mini-batch-size -m

Ukuran setiap batch mini yang akan dibagi menjadi data input untuk prediksi.

--output-path

Jalur di datastore tempat file output akan diunggah.

--outputs

Kamus untuk menentukan tempat menyimpan hasil.

--set

Perbarui objek dengan menentukan jalur properti dan nilai yang akan diatur. Contoh: --set property1.property2=value.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

--output -o

Format output.

Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
Nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az ml batch-endpoint list

Mencantumkan titik akhir di ruang kerja.

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

Contoh

Mencantumkan semua titik akhir batch di ruang kerja

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

Mencantumkan semua titik akhir batch di ruang kerja

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

Cantumkan semua titik akhir batch di ruang kerja menggunakan argumen --query untuk menjalankan kueri JMESPath pada hasil perintah.

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

Parameter yang Diperlukan

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--workspace-name -w

Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

--output -o

Format output.

Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
Nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az ml batch-endpoint list-jobs

Cantumkan pekerjaan penilaian batch untuk titik akhir batch.

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

Contoh

Mencantumkan semua pekerjaan penilaian batch untuk titik akhir

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

Parameter yang Diperlukan

--name -n

Nama titik akhir batch.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--workspace-name -w

Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

--output -o

Format output.

Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
Nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az ml batch-endpoint show

Perlihatkan detail untuk titik akhir.

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

Contoh

Memperlihatkan detail untuk titik akhir batch

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

Perlihatkan status provisi titik akhir menggunakan argumen --query untuk menjalankan kueri JMESPath pada hasil perintah.

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

Parameter yang Diperlukan

--name -n

Nama titik akhir batch.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--workspace-name -w

Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

--output -o

Format output.

Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
Nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az ml batch-endpoint update

Memperbarui titik akhir.

Properti 'description', 'tags', dan 'defaults' dari titik akhir dapat diperbarui. Selain itu, penyebaran baru dapat ditambahkan ke titik akhir, dan penyebaran yang ada dapat diperbarui.

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

Contoh

Memperbarui titik akhir dari file spesifikasi YAML

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

Menambahkan penyebaran baru ke titik akhir yang sudah ada

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

Parameter yang Diperlukan

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--workspace-name -w

Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>.

Parameter Opsional

--add

Tambahkan objek ke daftar objek dengan menentukan jalur dan pasangan nilai kunci. Contoh: --add property.listProperty <key=value, string or JSON string>.

Nilai default: []
--defaults

Perbarui deployment_name di dalam pengaturan default untuk pemanggilan titik akhir.

--file -f

Jalur lokal ke file YAML yang berisi spesifikasi titik akhir batch Azure ML. Dokumen referensi YAML untuk titik akhir batch dapat ditemukan di: https://aka.ms/ml-cli-v2-endpoint-batch-yaml-reference.

--force-string

Saat menggunakan 'set' atau 'add', pertahankan literal string alih-alih mencoba mengonversi ke JSON.

Nilai default: False
--name -n

Nama titik akhir batch.

--no-wait

Jangan tunggu hingga operasi jangka panjang selesai. Defaultnya adalah False.

Nilai default: False
--remove

Menghapus properti atau elemen dari daftar. Contoh: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Nilai default: []
--set

Perbarui objek dengan menentukan jalur properti dan nilai yang akan diatur. Contoh: --set property1.property2=<value>.

Nilai default: []
Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

--output -o

Format output.

Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
Nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.