az ml workspace
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 workspace . Dowiedz się więcej o rozszerzeniach.
Zarządzanie obszarami roboczymi usługi Azure ML.
Obszar roboczy usługi Azure ML to zasób najwyższego poziomu dla usługi Azure Machine Learning. Zapewnia scentralizowane miejsce do śledzenia zasobów i zasobów używanych w przepływach pracy uczenia maszynowego wraz z dziennikami i artefaktami utworzonymi na podstawie zadań szkoleniowych.
W przypadku uaktualniania z interfejsu wiersza polecenia w wersji 1 do wersji 2 wymagane są następujące dwie zmiany w zakresie zarządzania obszarem roboczym:
- Uaktualnij
az ml workspace private-endpoint
polecenia do równoważnychaz network private-endpoint
poleceń. - Ponadto uaktualnij
az ml workspace share
polecenia do równoważnychaz role assignment create
poleceń.
Polecenia
Nazwa | Opis | Typ | Stan |
---|---|---|---|
az ml workspace create |
Utwórz obszar roboczy. |
Numer wewnętrzny | Ogólna dostępność |
az ml workspace delete |
Usuwanie obszaru roboczego. |
Numer wewnętrzny | Ogólna dostępność |
az ml workspace diagnose |
Diagnozowanie problemów z konfiguracją obszaru roboczego. |
Numer wewnętrzny | Ogólna dostępność |
az ml workspace list |
Wyświetl listę wszystkich obszarów roboczych w subskrypcji. |
Numer wewnętrzny | Ogólna dostępność |
az ml workspace list-keys |
Wyświetl listę kluczy obszaru roboczego dla zasobów zależnych, takich jak Azure Storage, Azure Container Registry i aplikacja systemu Azure Insights. |
Numer wewnętrzny | Ogólna dostępność |
az ml workspace outbound-rule |
Zarządzanie regułami ruchu wychodzącego dla zarządzanej sieci obszaru roboczego usługi Azure ML. |
Numer wewnętrzny | Ogólna dostępność |
az ml workspace outbound-rule list |
Wyświetl listę wszystkich reguł ruchu wychodzącego sieci zarządzanej dla obszaru roboczego. |
Numer wewnętrzny | Ogólna dostępność |
az ml workspace outbound-rule remove |
Usuń regułę ruchu wychodzącego z sieci zarządzanej dla obszaru roboczego. |
Numer wewnętrzny | Ogólna dostępność |
az ml workspace outbound-rule set |
Dodaj lub zaktualizuj regułę ruchu wychodzącego w sieci zarządzanej dla obszaru roboczego. |
Numer wewnętrzny | Ogólna dostępność |
az ml workspace outbound-rule show |
Pokaż szczegóły reguły ruchu wychodzącego zarządzanej sieci dla obszaru roboczego. |
Numer wewnętrzny | Ogólna dostępność |
az ml workspace provision-network |
Aprowizuj sieć zarządzaną obszaru roboczego. |
Numer wewnętrzny | Ogólna dostępność |
az ml workspace show |
Pokaż szczegóły obszaru roboczego. |
Numer wewnętrzny | Ogólna dostępność |
az ml workspace sync-keys |
Synchronizuj klucze obszaru roboczego dla zasobów zależnych, takich jak Azure Storage, Azure Container Registry i aplikacja systemu Azure Insights. |
Numer wewnętrzny | Ogólna dostępność |
az ml workspace update |
Aktualizowanie obszaru roboczego. |
Numer wewnętrzny | Ogólna dostępność |
az ml workspace create
Utwórz obszar roboczy.
Po utworzeniu obszaru roboczego kilka zasobów platformy Azure, które będą używane przez usługę Azure ML, również zostanie utworzonych domyślnie: Azure Storage, Azure Container Registry, Azure Key Vault i aplikacja systemu Azure Insights. Zamiast tego możesz użyć istniejących wystąpień zasobów platformy Azure podczas tworzenia obszaru roboczego, określając identyfikatory zasobów w pliku YAML konfiguracji obszaru roboczego.
az ml workspace create --resource-group
[--allow-roleassignment-on-rg]
[--application-insights]
[--container-registry]
[--default-resource-group]
[--description]
[--display-name]
[--enable-data-isolation]
[--file]
[--hub-id]
[--image-build-compute]
[--key-vault]
[--kind]
[--location]
[--managed-network]
[--name]
[--no-wait]
[--primary-user-assigned-identity]
[--public-network-access]
[--set]
[--storage-account]
[--system-datastores-auth-mode]
[--tags]
[--update-dependent-resources]
Przykłady
Utwórz obszar roboczy na podstawie pliku specyfikacji YAML.
az ml workspace create --file workspace.yml --resource-group my-resource-group
Parametry wymagane
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Parametry opcjonalne
Flaga określająca, czy obszar roboczy może mieć przypisania ról na poziomie grupy zasobów.
Identyfikator usługi ARM usługi Application Insights skojarzony z tym obszarem roboczym.
Identyfikator usługi ARM rejestru kontenerów skojarzony z tym obszarem roboczym.
Tylko rodzaj koncentratora. W przypadku ustawienia podrzędne projekty tego centrum będą domyślnie ustawiane przez grupę zasobów.
Opis obszaru roboczego usługi Azure ML.
Nazwa wyświetlana obszaru roboczego.
Flaga określająca, czy obszar roboczy ma włączoną izolację danych. Flagę można ustawić tylko na etapie tworzenia. Nie można jej zaktualizować.
Ścieżka lokalna do pliku YAML zawierającego specyfikację obszaru roboczego usługi Azure ML. Dokumentację referencyjną YAML dla obszaru roboczego można znaleźć na stronie: https://aka.ms/ml-cli-v2-workspace-yaml-reference.
Tylko rodzaj projektu: identyfikator arm definiujący centrum nadrzędnego tego projektu.
Nazwa docelowego obiektu obliczeniowego do użycia na potrzeby tworzenia obrazów platformy Docker, gdy rejestr kontenerów znajduje się za siecią wirtualną.
Identyfikator usługi ARM magazynu kluczy skojarzony z tym obszarem roboczym.
Określa obszary robocze jako określony rodzaj, przesłaniając wartość przypisaną w yaML, jeśli jest obecna. Domyślnie wartość domyślna. Prawidłowe rodzaje to: domyślne, centrum i projekt.
Lokalizacja, która ma być używana dla nowego obszaru roboczego.
Zarządzany tryb izolacji sieci dla obszaru roboczego.
Nazwa obszaru roboczego usługi Azure ML.
Nie czekaj na zakończenie tworzenia obszaru roboczego.
Identyfikator usługi ARM tożsamości zarządzanej przypisanej przez użytkownika podstawowego, w przypadku określenia wielu z nich. Ponadto domyślna tożsamość zarządzana dla zasobów obliczeniowych bez klastra.
Zezwalaj na łączność z publicznym punktem końcowym, gdy obszar roboczy jest włączony łączem prywatnym.
Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=.
Identyfikator arm konta magazynu skojarzonego z tym obszarem roboczym.
Określa tryb uwierzytelniania dla systemowych magazynów danych. Prawidłowe tryby to: klucz dostępu i tożsamość.
Pary klucz-wartość rozdzielone spacjami dla tagów obiektu.
Określenie parametru --update_dependent_resources umożliwia zaktualizowanie zasobów zależnych obszaru roboczego. Zaktualizowanie dołączonego obszaru roboczego usługi Azure Container Registry lub zasobu usługi Application Insights może spowodować przerwanie pochodzenia poprzednich zadań, wdrożonych punktów końcowych wnioskowania lub możliwość ponownego uruchamiania wcześniejszych zadań w tym obszarze roboczym.
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 workspace delete
Usuwanie obszaru roboczego.
Domyślnie zasoby zależne skojarzone z obszarem roboczym (Azure Storage, Azure Container Registry, Azure Key Vault, aplikacja systemu Azure Insights) nie są usuwane. Aby je również usunąć, uwzględnij wartość --all-resources. Aby trwale usunąć obszar roboczy, dołącz element --permanent-delete.
az ml workspace delete --name
--resource-group
[--all-resources]
[--no-wait]
[--permanently-delete]
[--yes]
Parametry wymagane
Nazwa obszaru roboczego usługi Azure ML. Domyślny obszar roboczy można skonfigurować przy użyciu polecenia az configure --defaults workspace=<name>
.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Parametry opcjonalne
Usuń wszystkie zasoby zależne skojarzone z obszarem roboczym (konto usługi Azure Storage, usługa Azure Container Registry, aplikacja systemu Azure Insights, azure Key Vault).
Nie czekaj na zakończenie długotrwałej operacji. Wartość domyślna to False.
Obszary robocze są domyślnie w stanie nietrwałego usuwania, aby umożliwić odzyskiwanie danych obszaru roboczego. Ustaw tę flagę, aby zastąpić zachowanie usuwania nietrwałego i trwale usunąć obszar roboczy.
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 workspace diagnose
Diagnozowanie problemów z konfiguracją obszaru roboczego.
Jeśli obszar roboczy nie działa zgodnie z oczekiwaniami, możesz uruchomić tę diagnostykę, aby sprawdzić, czy obszar roboczy został uszkodzony. W przypadku obszaru roboczego prywatnego punktu końcowego pomoże również sprawdzić, czy konfiguracja sieci w tym obszarze roboczym i jego zasobie zależnym ma problem, czy nie.
az ml workspace diagnose --name
--resource-group
[--no-wait]
Przykłady
diagnozowanie obszaru roboczego.
az ml workspace diagnose --name my-workspace-name --no-wait -g my-resource-group
Parametry wymagane
Nazwa obszaru roboczego usługi Azure ML. Domyślny obszar roboczy można skonfigurować przy użyciu polecenia az configure --defaults workspace=<name>
.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Parametry opcjonalne
Nie czekaj na zakończenie długotrwałej operacji. Wartość domyślna to False.
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 workspace list
Wyświetl listę wszystkich obszarów roboczych w subskrypcji.
Listę obszarów roboczych można filtrować według grupy zasobów.
az ml workspace list [--filtered-kinds]
[--max-results]
[--resource-group]
Przykłady
Wyświetlanie listy wszystkich obszarów roboczych w grupie zasobów
az ml workspace list --resource-group my-resource-group
Wyświetl listę wszystkich obszarów roboczych przy użyciu argumentu --query, aby wykonać zapytanie JMESPath na wynikach poleceń.
az ml workspace list --query "[].{Name:name}" --output table --resource-group my-resource-group
Parametry opcjonalne
Wyświetl tylko określone rodzaje obszarów roboczych jako listę rozdzielaną przecinkami. Prawidłowe rodzaje to: domyślne, centrum i projekt.
Maksymalna liczba wyników do zwrócenia.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<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 workspace list-keys
Wyświetl listę kluczy obszaru roboczego dla zasobów zależnych, takich jak Azure Storage, Azure Container Registry i aplikacja systemu Azure Insights.
az ml workspace list-keys --name
--resource-group
Parametry wymagane
Nazwa obszaru roboczego usługi Azure ML. Domyślny obszar roboczy można skonfigurować przy użyciu polecenia az configure --defaults workspace=<name>
.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<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 workspace provision-network
Aprowizuj sieć zarządzaną obszaru roboczego.
Wyzwala obszar roboczy w celu aprowizacji sieci zarządzanej. Określanie flagi z obsługą platformy Spark powoduje przygotowanie sieci zarządzanej obszaru roboczego do obsługi platformy Spark. Wartość domyślna to false, jeśli nie zostanie określona, ale można ją włączyć później, uruchamiając to polecenie ponownie z tą flagą. Po włączeniu tej opcji nie można jej wyłączyć.
az ml workspace provision-network --name
--resource-group
[--include-spark]
[--no-wait]
Przykłady
aprowizuj sieć zarządzaną.
az ml workspace provision-network --include-spark --name my-workspace-name --no-wait -g my-resource-group
Parametry wymagane
Nazwa obszaru roboczego usługi Azure ML. Domyślny obszar roboczy można skonfigurować przy użyciu polecenia az configure --defaults workspace=<name>
.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Parametry opcjonalne
Wartość logiczna [true/false] w przypadku, gdy sieć zarządzana powinna być aprowizowana w celu uwzględnienia zadań platformy Spark. Wartość domyślna to false, jeśli flaga nie jest ustawiona. Można ją włączyć później, uruchamiając to polecenie ponownie z tą flagą.
Nie czekaj na zakończenie długotrwałej operacji. Wartość domyślna to False.
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 workspace show
Pokaż szczegóły obszaru roboczego.
az ml workspace show --name
--resource-group
Parametry wymagane
Nazwa obszaru roboczego usługi Azure ML. Domyślny obszar roboczy można skonfigurować przy użyciu polecenia az configure --defaults workspace=<name>
.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<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 workspace sync-keys
Synchronizuj klucze obszaru roboczego dla zasobów zależnych, takich jak Azure Storage, Azure Container Registry i aplikacja systemu Azure Insights.
Jeśli klucze dla dowolnego zasobu w obszarze roboczym zostaną zmienione, automatyczne zaktualizowanie kluczy w obszarze roboczym może potrwać około godziny. To polecenie wyzwala obszar roboczy, aby natychmiast synchronizować klucze. Możliwy scenariusz wymaga natychmiastowego dostępu do magazynu po ponownej wygenerowaniu kluczy magazynu.
az ml workspace sync-keys --name
--resource-group
[--no-wait]
Parametry wymagane
Nazwa obszaru roboczego usługi Azure ML. Domyślny obszar roboczy można skonfigurować przy użyciu polecenia az configure --defaults workspace=<name>
.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Parametry opcjonalne
Nie czekaj na zakończenie długotrwałej operacji. Wartość domyślna to False.
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 workspace update
Aktualizowanie obszaru roboczego.
Właściwości "description", "tags" i "friendly_name" można zaktualizować.
az ml workspace update --name
--resource-group
[--add]
[--allow-roleassignment-on-rg]
[--application-insights]
[--container-registry]
[--description]
[--display-name]
[--file]
[--force-string]
[--image-build-compute]
[--managed-network]
[--no-wait]
[--primary-user-assigned-identity]
[--public-network-access]
[--remove]
[--set]
[--system-datastores-auth-mode]
[--update-dependent-resources]
Przykłady
aktualizowanie obszaru roboczego z pliku specyfikacji YAML.
az ml workspace update --resource-group my-resource-group --name my-workspace-name --file workspace.yml
Parametry wymagane
Nazwa obszaru roboczego usługi Azure ML. Domyślny obszar roboczy można skonfigurować przy użyciu polecenia az configure --defaults workspace=<name>
.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<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>
.
Flaga określająca, czy obszar roboczy może mieć przypisania ról na poziomie grupy zasobów.
Identyfikator usługi ARM usługi Application Insights skojarzony z tym obszarem roboczym.
Identyfikator usługi ARM rejestru kontenerów skojarzony z tym obszarem roboczym.
Opis obszaru roboczego usługi Azure ML.
Nazwa wyświetlana obszaru roboczego.
Ścieżka lokalna do pliku YAML zawierającego specyfikację obszaru roboczego usługi Azure ML. Dokumentację referencyjną YAML dla obszaru roboczego można znaleźć na stronie: https://aka.ms/ml-cli-v2-workspace-yaml-reference.
W przypadku używania polecenia "set" lub "add" zachowaj literały ciągu zamiast próbować konwertować na format JSON.
Nazwa docelowego obiektu obliczeniowego do użycia na potrzeby tworzenia obrazów platformy Docker, gdy rejestr kontenerów znajduje się za siecią wirtualną.
Zarządzany tryb izolacji sieci dla obszaru roboczego.
Nie czekaj na zakończenie długotrwałej operacji. Wartość domyślna to False.
Identyfikator usługi ARM tożsamości przypisanej przez użytkownika podstawowego skojarzony z tym obszarem roboczym.
Zezwalaj na łączność z publicznym punktem końcowym, gdy obszar roboczy jest włączony łączem prywatnym.
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>
.
Określa tryb uwierzytelniania dla systemowych magazynów danych. Prawidłowe tryby to: klucz dostępu i tożsamość.
Określenie parametru --update_dependent_resources umożliwia zaktualizowanie zasobów zależnych obszaru roboczego. Zaktualizowanie dołączonego obszaru roboczego usługi Azure Container Registry lub zasobu usługi Application Insights może spowodować przerwanie pochodzenia poprzednich zadań, wdrożonych punktów końcowych wnioskowania lub możliwość ponownego uruchamiania wcześniejszych zadań w tym obszarze roboczym.
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.