Udostępnij za pośrednictwem

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

  • Artykuł

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 odwołań Podgrupy referencyjne Polecenie Pełne odwołanie — polecenie Przykłady parametrów
Interfejs wiersza polecenia platformy Azure az config az config --local, --output -o
Sieć platformy Azure az network application-gateway create az network application-gateway create --name, --resource-group, --capacity
Azure DevOps az pipelines agent lista az pipelines agent list --pool-id, --agent-name, --demands

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 Polecenie
network 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 odwołania określa harmonogram wydania, stan i metodę instalacji zgodnie z opisem w tym miejscu:

Termin Podstawowe funkcje Numer wewnętrzny
Dokumentacja Jest częścią podstawowej usługi interfejsu wiersza polecenia platformy Azure To opcjonalne polecenia referencyjne, które muszą być zainstalowane
Instalowanie Wspólnie z instalatorem MSI Indywidualnie za pomocą polecenia az extension add
Wydano Zgodnie z harmonogramem W miarę udostępniania nowych funkcji lub aktualizacji
Stan Może być ogólnie dostępna, wersja zapoznawcza lub przestarzała Może również być ogólnie dostępna, wersja zapoznawcza lub przestarzała

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

Podstawowe funkcje

Odwołania interfejsu wiersza polecenia platformy Azure, które zostały opublikowane jako stała część interfejsu wiersza polecenia, są nazywane 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 polecenia za pośrednictwem usługi Azure Cloud Shell, podstawowe odwołania są zawsze aktualne.

Numer wewnętrzny

Rozszerzenia nie są dostarczane jako część interfejsu wiersza polecenia, ale są uruchamiane jako polecenia interfejsu wiersza polecenia. 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łne odwołanie — polecenie Jest rdzeniem Jest rozszerzeniem
az iot hub list tak
az iot hub job list tak

Podczas pierwszego użycia zostanie wyświetlony monit o zainstalowanie rozszerzenia. Możesz również zainstalować rozszerzenie, uruchamiając polecenie 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 stan odwołania?

Niezależnie od typu odwołania odwołania odwołania do interfejsu wiersza polecenia platformy Azure należą do trzech kategorii stanu: ogólna dostępność (ogólnie dostępna), 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 Przestarzałe
Stabilność Stale Może zmienić się w odpowiedzi na opinie klientów. Podlega warunkom wersji zapoznawczej platformy Microsoft Azure. Zostanie usunięty.

Uwaga

Ostrzeżenia wskazujące publiczną wersję zapoznawczą lub przestarzałą są częścią danych wyjściowych polecenia interfejsu wiersza polecenia platformy Azure i powinny być oczekiwane.

Większość poleceń i parametrów pojedynczego odwołania ma jeden stan, ale nie zawsze. Odwołanie ogólnodostępne, które jest tworzone w celu zaoferowania większej liczby poleceń, może mieć zarówno ogólnie dostępne, jak i w wersji zapoznawczej polecenia referencyjne. 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 odwołania, które mają różne stany:

Pełne odwołanie — polecenie Parametry Typ Ogólna dostępność Publiczna wersja zapoznawcza Przestarzałe
az network dns zone list wszystkie Podstawowe funkcje tak
az network dns zone create --name, --resource-group, --if-none-match, --parent-name Podstawowe funkcje tak
--existingParameter5 Podstawowe funkcje tak
--newParameter6 Podstawowe funkcje tak
az network vhub list wszystkie Extension tak
az network vhub create --address-prefix, --name, --resource-group, -vwan, --location, --sku Extension tak
--exsitingParameter7 Extension tak
--newParameter8 Extension tak
az network firewall create wszystkie Extension tak

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

Zobacz też