Udostępnij za pośrednictwem

Omówienie: terminologia interfejsu wiersza polecenia platformy Azure i poziomy pomocy technicznej

W tym artykule opisano terminologie interfejsu wiersza polecenia platformy Azure. Istnieją składniki składni, typy referencyjne i stany.

Składniki składni interfejsu wiersza polecenia platformy Azure

Składnia interfejsu wiersza polecenia platformy Azure to kombinacja grup, odwołań, poleceń i parametrów. Często polecenie pełnego odwołania jest określane jako polecenie.

Usługa platformy Azure Grupa odniesienia Podgrupy referencyjne Komenda Pełna referencja — polecenie Przykłady parametrów
Azure CLI az config az config --local, --output -o
Sieć platformy Azure az network brama aplikacji utwórz Komenda az network application-gateway create służy do tworzenia nowej bramy aplikacji w sieci. --name, --resource-group, --capacity (parametry poleceń: nazwa, grupa zasobów, pojemność)
Azure DevOps az pipelines pełnomocnik lista lista agentów az pipelines --pool-id, --agent-name, --wymagania

Podgrupa referencyjna może mieć wiele poziomów, takich jakaz network application-gateway private-link ip-config add

Grupa referencyjna Podgrupa 1 Podgrupa 2 Podgrupa 3 Komenda
sieć brama aplikacji link prywatny konfiguracja IP dodawać

Aby uzyskać pełną listę poleceń referencyjnych, zobacz Lista odwołań od A do Z .

Co to jest typ odwołania?

Polecenia interfejsu wiersza polecenia platformy Azure są częścią podstawowej usługi Azure CLI lub są rozszerzeniem. Rozszerzenia są opcjonalnymi dodatkami. Typ odniesienia określa harmonogram wydania, status i metodę instalacji, jak opisano poniżej.

Termin Rdzeń Rozszerzenie
Dokumentacja Jest częścią podstawowej usługi Azure CLI To opcjonalne polecenia referencyjne, które muszą być zainstalowane
Instalowanie Wspólnie z instalatorem MSI Indywidualnie z az extension add
Wydano Zgodnie z harmonogramem W miarę udostępniania nowych funkcji lub aktualizacji
Stan Może być ogólna dostępność (GA), wersja zapoznawcza lub przestarzała. Może również być wersją ogólnie dostępną, wersją wstępną lub przestarzałą.

Aby uzyskać listę grup poleceń, uruchom polecenie az. Aby uzyskać listę rozszerzeń, użyj polecenia az extension list-available --output table.

# Get list of all command groups
az

# Get list of extensions
az extension list-available --output table

Rdzeń

Odwołania do interfejsu wiersza polecenia platformy Azure, które są publikowane jako trwała część CLI, nazywane są odwołaniami podstawowymi. Wszystkie podstawowe odwołania są instalowane za pomocą interfejsu wiersza polecenia platformy Azure i nie można wybrać podzestawu odwołań. Jeśli uruchamiasz interfejs wiersza poleceń za pośrednictwem usługi Azure Cloud Shell, rdzeniowe odniesienia są zawsze aktualne.

Rozszerzenie

Rozszerzenia nie są dostarczane razem z CLI, lecz uruchamiane jako polecenia CLI. Niektóre rozszerzenia są stałym elementem interfejsu wiersza polecenia platformy Azure, ale często rozszerzenie zapewnia dostęp do poleceń w wersji zapoznawczej i eksperymentalnych. Pojedyncza grupa odwołań, taka jak az iot hub, może mieć zarówno polecenia podstawowe, jak i rozszerzenia. Oto dwa przykłady:

Pełna referencja — polecenie Jest rdzeniem Jest rozszerzeniem
az iot hub list tak
az iot hub job list (wykaz prac w hubie IoT) tak

Podczas pierwszego użycia zostanie wyświetlony monit o zainstalowanie rozszerzenia. Możesz również zainstalować rozszerzenie za pomocą polecenia az extension add.

Więcej informacji na temat odwołań do rozszerzeń, w tym instalacji i aktualizacji można znaleźć w temacie Use extensions with the Azure CLI (Używanie rozszerzeń za pomocą interfejsu wiersza polecenia platformy Azure). Aby uzyskać pełną listę poleceń referencyjnych rozszerzeń, zobacz Dostępne rozszerzenia dla interfejsu wiersza polecenia platformy Azure.

Co to jest status referencji?

Niezależnie od typu odwołania, odwołania do interfejsu wiersza polecenia Azure należą do trzech kategorii stanu: ogólnie dostępna (GA), publiczna wersja zapoznawcza lub przestarzała. Jest to stan polecenia referencyjnego (nie typ), który określa stabilność.

Zgromadzenie Ogólne Publiczna wersja zapoznawcza Przestarzałe
Stabilność Trwały Może zmienić się w odpowiedzi na opinie klientów. Podlega warunkom wersji zapoznawczej platformy Microsoft Azure. Zostanie usunięty.

Uwaga / Notatka

Ostrzeżenia wskazujące wersję zapoznawczą lub przestarzałość są częścią danych wyjściowych polecenia Azure CLI i należy się ich spodziewać.

Większość poleceń i parametrów jednego odniesienia ma jeden stan, ale nie zawsze. Odwołanie do GA, które jest rozbudowywane, aby oferować więcej poleceń, może zawierać zarówno polecenia GA, jak i polecenia wersji zapoznawczej. W miarę dodawania nowych parametrów w celu zwiększenia funkcjonalności pojedyncze polecenie może również mieć parametry, które należą do różnych kategorii stanu. Oto przykładowe referencje, które mają różne stany.

Pełna referencja — polecenie Parametry Typ Zgromadzenie Ogólne Publiczna wersja zapoznawcza Przestarzałe
az network dns zone lista Wszystko Rdzeń tak
az network dns zone create (tworzenie strefy DNS) --name, --resource-group, --if-none-match, --parent-name Rdzeń tak
--istniejąceParametr5 Rdzeń tak
--newParameter6 Rdzeń tak
az network vhub list Wszystko Rozszerzenie tak
az network vhub create --address-prefix (prefiks adresu), --name (nazwa), --resource-group (grupa zasobów), -vwan, --location (lokalizacja), --sku Rozszerzenie tak
--existingParameter7 Rozszerzenie tak
--newParameter8 Rozszerzenie tak
az firewall sieciowy utwórz Wszystko Rozszerzenie tak

Powyższa tabela jest tylko przykładem i nie jest reprezentatywna dla bieżących statusów odniesienia dla az network.

Zobacz także