Omówienie: terminologia interfejsu wiersza polecenia platformy Azure i poziomy pomocy technicznej
W tym artykule opisano terminologię interfejsu wiersza polecenia platformy Azure. Istnieją składniki składni, typy referencyjne i stany. jest to stan określający poziom pomocy technicznej.
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 | ||
| Azure Network | az network | application-gateway | create | 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 jakaz network application-gateway private-link ip-config add
| Grupa odwołań | Podgrupa 1 | Podgrupa 2 | Podgrupa 3 | Polecenie |
|---|---|---|---|---|
| network | application-gateway | łącze prywatne | 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:
| Okres | Core | Rozszerzenie |
|---|---|---|
| Odwołania | Są częścią podstawowej usługi interfejsu wiersza polecenia platformy Azure | Są opcjonalnymi poleceniami referencyjnymi, które muszą być zainstalowane |
| Instalacja | 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 to być ogólna dostępność (ogólnie dostępna), wersja zapoznawcza lub eksperymentalna | Może również być ogólnie dostępna, wersja zapoznawcza lub eksperymentalna |
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
Core
Odwołania interfejsu wiersza polecenia platformy Azure, które zostały opublikowane jako stała część interfejsu wiersza polecenia, są nazywane podstawowymi odwołaniami. 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.
Rozszerzenie
Rozszerzenia nie są dostarczane jako część interfejsu wiersza polecenia, ale są uruchamiane jako polecenia interfejsu wiersza polecenia. Niektóre rozszerzenia są stałą częścią interfejsu wiersza polecenia platformy Azure, ale często rozszerzenie zapewnia dostęp do poleceń w wersji zapoznawczej i eksperymentalnej. Pojedyncza grupa odwołań, taka jak az iot hub, może mieć zarówno polecenia podstawowe, jak i rozszerzenia. Poniżej przedstawiono 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. Rozszerzenie można również zainstalować, uruchamiając polecenie az extension add .
Więcej informacji o odwołaniach do rozszerzeń, w tym o instalowaniu i aktualizowaniu w temacie 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 dzielą się na trzy kategorie stanu: ogólna dostępność (ogólnie dostępna), publiczna wersja zapoznawcza lub eksperymentalna. Jest to stan polecenia odwołania (nie typ), który określa stabilność i poziom obsługi.
| Ogólna dostępność | Publiczna wersja zapoznawcza | Eksperymentalne | |
|---|---|---|---|
| Stabilność | Stale | Może ulec zmianie w odpowiedzi na opinie klientów. Podlega warunkom wersji zapoznawczej platformy Microsoft Azure. | Może ulec zmianie w odpowiedzi na opinie klientów. Często przeprowadza migrację do publicznej wersji zapoznawczej. Można go usunąć. |
| Poziom pomocy technicznej | Pełne | Częściowe | Brak |
Uwaga
Ostrzeżenia wskazujące publiczną wersję zapoznawczą lub eksperymentalną 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. Dokumentacja ogólnie dostępna, która jest tworzona w celu oferowania większej liczby poleceń, może zawierać polecenia ogólnie dostępne, zapoznawcze i eksperymentalne odwołania. W miarę dodawania nowych parametrów w celu zwiększenia funkcjonalności pojedyncze polecenie może również zawierać 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 | Eksperymentalne |
|---|---|---|---|---|---|
| az network dns zone list | Wszystko | Core | tak | ||
| az network dns zone create | --name, --resource-group, --if-none-match, --parent-name | Core | tak | ||
| --newFutureParameter1 | Core | tak | |||
| --newFutureParameter2 | Core | tak | |||
| az network vhub list | Wszystko | Rozszerzenie | tak | ||
| az network vhub create | --address-prefix, --name, --resource-group, -vwan, --location, --sku | Rozszerzenie | tak | ||
| --newFutureParameter1 | Rozszerzenie | tak | |||
| --newFutureParameter2 | Rozszerzenie | tak | |||
| az network firewall create | Wszystko | Rozszerzenie | tak |
Powyższa tabela jest tylko przykładem i nie jest reprezentatywna dla bieżącego stanu odwołania dla przykładów.