az ml batch-endpoint
Uwaga
Ta dokumentacja jest częścią rozszerzenia ml dla interfejsu wiersza polecenia platformy Azure (wersja 2.15.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az ml batch-endpoint . Dowiedz się więcej o rozszerzeniach.
Zarządzanie punktami końcowymi wsadowymi usługi Azure ML.
Punkty końcowe usługi Azure ML zapewniają prosty interfejs do tworzenia wdrożeń modelu i zarządzania nimi. Każdy punkt końcowy może mieć co najmniej jedno wdrożenie. Punkty końcowe usługi Batch są używane do oceniania wsadowego w trybie offline.
Polecenia
Nazwa | Opis | Typ | Stan |
---|---|---|---|
az ml batch-endpoint create |
Utwórz punkt końcowy. |
Numer wewnętrzny | Ogólna dostępność |
az ml batch-endpoint delete |
Usuwanie punktu końcowego. |
Numer wewnętrzny | Ogólna dostępność |
az ml batch-endpoint invoke |
Wywoływanie punktu końcowego. |
Numer wewnętrzny | Ogólna dostępność |
az ml batch-endpoint list |
Wyświetlanie listy punktów końcowych w obszarze roboczym. |
Numer wewnętrzny | Ogólna dostępność |
az ml batch-endpoint list-jobs |
Wyświetl listę zadań oceniania wsadowego dla punktu końcowego wsadowego. |
Numer wewnętrzny | Ogólna dostępność |
az ml batch-endpoint show |
Pokaż szczegóły punktu końcowego. |
Numer wewnętrzny | Ogólna dostępność |
az ml batch-endpoint update |
Aktualizowanie punktu końcowego. |
Numer wewnętrzny | Ogólna dostępność |
az ml batch-endpoint create
Utwórz punkt końcowy.
Aby utworzyć punkt końcowy, podaj plik YAML z konfiguracją punktu końcowego wsadowego. Jeśli punkt końcowy już istnieje, zostanie on zastąpiony nowymi ustawieniami.
az ml batch-endpoint create --resource-group
--workspace-name
[--file]
[--name]
[--no-wait]
[--set]
Przykłady
Tworzenie punktu końcowego na podstawie pliku specyfikacji YAML
az ml batch-endpoint create --file endpoint.yml --resource-group my-resource-group --workspace-name my-workspace
Tworzenie punktu końcowego o nazwie
az ml batch-endpoint create --name endpointname --resource-group my-resource-group --workspace-name my-workspace
Parametry wymagane
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Nazwa obszaru roboczego usługi Azure ML. Domyślny obszar roboczy można skonfigurować przy użyciu polecenia az configure --defaults workspace=<name>
.
Parametry opcjonalne
Ścieżka lokalna do pliku YAML zawierającego specyfikację punktu końcowego wsadowego usługi Azure ML. Dokumentację referencyjną YAML dla punktu końcowego wsadowego można znaleźć na stronie: https://aka.ms/ml-cli-v2-endpoint-batch-yaml-reference.
Nazwa punktu końcowego partii.
Nie czekaj na zakończenie długotrwałej operacji. Wartość domyślna to False.
Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az ml batch-endpoint delete
Usuwanie punktu końcowego.
az ml batch-endpoint delete --name
--resource-group
--workspace-name
[--no-wait]
[--yes]
Przykłady
Usuwanie punktu końcowego wsadowego, w tym wszystkich wdrożeń
az ml batch-endpoint delete --name my-batch-endpoint --resource-group my-resource-group --workspace-name my-workspace
Parametry wymagane
Nazwa punktu końcowego partii.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Nazwa obszaru roboczego usługi Azure ML. Domyślny obszar roboczy można skonfigurować przy użyciu polecenia az configure --defaults workspace=<name>
.
Parametry opcjonalne
Nie czekaj na zakończenie długotrwałej operacji. Wartość domyślna to False.
Nie monituj o potwierdzenie.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az ml batch-endpoint invoke
Wywoływanie punktu końcowego.
Możesz uruchomić wnioskowanie wsadowe, wywołując punkt końcowy z pewnymi danymi. W przypadku punktów końcowych wsadowych wywołanie spowoduje wyzwolenie asynchronicznego zadania oceniania wsadowego.
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]
Przykłady
Wywoływanie punktu końcowego wsadowego z danymi wejściowymi z zarejestrowanego zasobu danych usługi Azure ML i zastąpienie domyślnego ustawienia wdrożenia dla 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
Wywoływanie punktu końcowego wsadowego z plikiem wejściowym z publicznego identyfikatora URI
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
Wywoływanie punktu końcowego wsadowego z plikiem wejściowym z zarejestrowanego magazynu danych
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
Wywoływanie punktu końcowego wsadowego z folderem wejściowym z publicznego identyfikatora URI
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
Wywoływanie punktu końcowego wsadowego z folderem wejściowym z zarejestrowanego magazynu danych
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
Wywoływanie punktu końcowego wsadowego z plikami w folderze lokalnym
az ml batch-endpoint invoke --name my-batch-endpoint --input ./mnist_folder --resource-group my-resource-group --workspace-name my-workspace
Wywoływanie punktu końcowego wsadowego z folderem lokalnym jako ścieżką wejściową i wyjściową oraz zastępowanie niektórych ustawień wdrożenia wsadowego podczas wywoływania punktu końcowego
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
Parametry wymagane
Nazwa punktu końcowego partii.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Nazwa obszaru roboczego usługi Azure ML. Domyślny obszar roboczy można skonfigurować przy użyciu polecenia az configure --defaults workspace=<name>
.
Parametry opcjonalne
Nazwa wdrożenia docelowego.
Nazwa eksperymentu dotyczącego wdrażania składnika potoku.
Nazwa pliku używanego do wywołania wsadowego.
Odwołanie do danych wejściowych do użycia na potrzeby wnioskowania wsadowego. Może to być ścieżka do magazynu danych, publicznego identyfikatora URI, zarejestrowanego zasobu danych lub ścieżki folderu lokalnego.
Typ danych wejściowych, określając, czy jest to plik, czy folder. Użyj tej opcji, gdy używasz ścieżki w magazynie danych lub publicznym identyfikatorze URI. Obsługiwane wartości: uri_folder, uri_file.
Słownik danych wejściowych zadań wywołania.
Liczba wystąpień, na których zostanie uruchomione przewidywanie.
Nazwa zadania dla wywołania wsadowego.
Rozmiar każdej minisadowej partii, na którą zostaną podzielone dane wejściowe na potrzeby przewidywania.
Ścieżka do magazynu danych, do którego zostaną przekazane pliki wyjściowe.
Słownik określający miejsce przechowywania wyników.
Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az ml batch-endpoint list
Wyświetlanie listy punktów końcowych w obszarze roboczym.
az ml batch-endpoint list --resource-group
--workspace-name
Przykłady
Wyświetlanie listy wszystkich punktów końcowych wsadowych w obszarze roboczym
az ml batch-endpoint list --resource-group my-resource-group --workspace-name my-workspace
Wyświetlanie listy wszystkich punktów końcowych wsadowych w obszarze roboczym
az ml batch-endpoint list --resource-group my-resource-group --workspace-name my-workspace
Wyświetl listę wszystkich punktów końcowych wsadowych w obszarze roboczym przy użyciu argumentu --query w celu wykonania zapytania JMESPath na wynikach poleceń.
az ml batch-endpoint list --query "[].{Name:name}" --output table --resource-group my-resource-group --workspace-name my-workspace
Parametry wymagane
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Nazwa obszaru roboczego usługi Azure ML. Domyślny obszar roboczy można skonfigurować przy użyciu polecenia az configure --defaults workspace=<name>
.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az ml batch-endpoint list-jobs
Wyświetl listę zadań oceniania wsadowego dla punktu końcowego wsadowego.
az ml batch-endpoint list-jobs --name
--resource-group
--workspace-name
Przykłady
Wyświetlanie listy wszystkich zadań oceniania wsadowego dla punktu końcowego
az ml batch-endpoint list-jobs --name my-batch-endpoint --resource-group my-resource-group --workspace-name my-workspace
Parametry wymagane
Nazwa punktu końcowego partii.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Nazwa obszaru roboczego usługi Azure ML. Domyślny obszar roboczy można skonfigurować przy użyciu polecenia az configure --defaults workspace=<name>
.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az ml batch-endpoint show
Pokaż szczegóły punktu końcowego.
az ml batch-endpoint show --name
--resource-group
--workspace-name
Przykłady
Pokaż szczegóły punktu końcowego wsadowego
az ml batch-endpoint show --name my-batch-endpoint --resource-group my-resource-group --workspace-name my-workspace
Pokaż stan aprowizacji punktu końcowego przy użyciu argumentu --query w celu wykonania zapytania JMESPath na wynikach poleceń.
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
Parametry wymagane
Nazwa punktu końcowego partii.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Nazwa obszaru roboczego usługi Azure ML. Domyślny obszar roboczy można skonfigurować przy użyciu polecenia az configure --defaults workspace=<name>
.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az ml batch-endpoint update
Aktualizowanie punktu końcowego.
Właściwości "description", "tags" i "defaults" punktu końcowego można zaktualizować. Ponadto nowe wdrożenia można dodać do punktu końcowego, a istniejące wdrożenia można zaktualizować.
az ml batch-endpoint update --resource-group
--workspace-name
[--add]
[--defaults]
[--file]
[--force-string]
[--name]
[--no-wait]
[--remove]
[--set]
Przykłady
Aktualizowanie punktu końcowego z pliku specyfikacji YAML
az ml batch-endpoint update --name my-batch-endpoint --file updated_endpoint.yml --resource-group my-resource-group --workspace-name my-workspace
Dodawanie nowego wdrożenia do istniejącego punktu końcowego
az ml batch-endpoint update --name my-batch-endpoint --set defaults.deployment_name=depname --resource-group my-resource-group --workspace-name my-workspace
Parametry wymagane
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Nazwa obszaru roboczego usługi Azure ML. Domyślny obszar roboczy można skonfigurować przy użyciu polecenia az configure --defaults workspace=<name>
.
Parametry opcjonalne
Dodaj obiekt do listy obiektów, określając pary ścieżki i wartości klucza. Przykład: --add property.listProperty <key=value, string or JSON string>
.
Zaktualizuj deployment_name wewnątrz ustawień domyślnych dla wywołania punktu końcowego.
Ścieżka lokalna do pliku YAML zawierającego specyfikację punktu końcowego wsadowego usługi Azure ML. Dokumentację referencyjną YAML dla punktu końcowego wsadowego można znaleźć na stronie: https://aka.ms/ml-cli-v2-endpoint-batch-yaml-reference.
W przypadku używania polecenia "set" lub "add" zachowaj literały ciągu zamiast próbować konwertować na format JSON.
Nazwa punktu końcowego partii.
Nie czekaj na zakończenie długotrwałej operacji. Wartość domyślna to False.
Usuń właściwość lub element z listy. Przykład: --remove property.list <indexToRemove>
OR --remove propertyToRemove
.
Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=<value>
.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.