Udostępnij przez

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 pełne polecenie odwołania jest określane jako polecenie.

Usługa platformy Azure Grupa odniesienia Podgrupa referencyjna Command Pełna referencja — polecenie Przykłady parametrów
Azure CLI az config az config --local, --output-o
Sieć platformy Azure az network application-gateway utworzyć az network application-gateway create --name, --resource-group--capacity
Azure DevOps az pipelines agent list az pipelines agent list --pool-id, --agent-name--demands

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

Grupa referencyjna Podgrupa 1 Podgrupa 2 Podgrupa 3 Command
sieć application-gateway private-link ip-config add

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 interfejsu wiersza polecenia platformy Azure lub są rozszerzeniem. Rozszerzenia są opcjonalnymi dodatkami. Typ referencyjny określa harmonogram wydania, status i metodę instalacji, jak opisano poniżej:

Term Core Extension
References Jest częścią podstawowej usługi Azure CLI To opcjonalne polecenia referencyjne, które muszą być zainstalowane
Install Wspólnie z instalatorem MSI Indywidualnie z az extension add
Released Zgodnie z harmonogramem W miarę udostępniania nowych funkcji lub aktualizacji
Status 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.

# Get list of all command groups
az

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

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

Core

Odwołania interfejsu wiersza polecenia platformy Azure, które są publikowane jako stała część interfejsu wiersza polecenia platformy Azure, są nazywane podstawowymi odwołaniami. Wszystkie podstawowe odwołania są instalowane za pomocą interfejsu wiersza polecenia platformy Azure i nie można wybrać podzbioru odwołań. Jeśli uruchamiasz Azure CLI przez usługę Azure Cloud Shell, podstawowe odniesienia są zawsze aktualne.

Extension

Rozszerzenia nie są dostarczane jako część interfejsu wiersza polecenia platformy Azure, ale są uruchamiane jako polecenia interfejsu wiersza polecenia platformy Azure. 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 referencyjna, taka jak , może mieć zarówno polecenia podstawowe, jak az iot hubi rozszerzenia. Oto dwa przykłady:

Pełna referencja — polecenie Stanowi rdzeń Jest to rozszerzenie
az iot hub list yes
az iot hub job list (wykaz prac w hubie IoT) yes

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

ogólna dostępność Publiczna wersja zapoznawcza Deprecated
Stability Permanent Może zmienić się w odpowiedzi na opinie klientów. Podlega warunkom wersji zapoznawczej platformy Microsoft Azure. Zostanie usunięty.

Note

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 pojedynczego odwołania ma jeden stan, ale nie zawsze tak jest. Dokumentacja GA, która jest tworzona w celu zaoferowania większej liczby poleceń, może zawierać polecenia referencyjne zarówno GA, jak i w 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 Parameters Typ ogólna dostępność Publiczna wersja zapoznawcza Deprecated
az network dns zone list All Core yes
az network dns zone create --name, , --resource-group, , --if-none-match--parent-name Core yes
--existingParameter5 Core yes
--newParameter6 Core yes
az network vhub list All Extension yes
az network vhub create --address-prefix, , --name, --resource-group, -vwan, , --location--sku Extension yes
--existingParameter7 Extension yes
--newParameter8 Extension yes
az network firewall create All Extension yes

Poprzednia tabela jest tylko przykładem i nie reprezentuje bieżących stanów odwołań dla elementu az network.

Zobacz także

  • Last updated on