다음을 통해 공유


개요: Azure CLI 용어 및 지원 수준

이 문서에서는 Azure CLI 용어에 대해 설명합니다. 구문 구성 요소, 참조 형식 및 상태가 있습니다.

Azure CLI 구문 구성 요소

Azure CLI 구문은 그룹, 참조, 명령 및 매개 변수의 조합입니다. 일반적으로 전체 참조 명령을 명령이라고 합니다.

Azure 서비스 참조 그룹 참조 하위 그룹 명령 전체 참조 명령 매개 변수 예제
Azure CLI az config az config --local, --output -o
Azure 네트워크 az network application-gateway 만들기 az network application-gateway create --name, --resource-group, --capacity
Azure DevOps az pipelines 에이전트 list az pipelines agent list --pool-id, --agent-name, --demands

참조 하위 그룹에는 az network application-gateway private-link ip-config add와 같은 여러 수준이 있을 수 있습니다.

참조 그룹 하위 그룹 1 하위 그룹 2 하위 그룹 3 명령
network application-gateway private-link ip-config add

참조 명령의 전체 목록은 참조 목록 A에서 Z까지를 참조하세요.

참조 형식이란?

Azure CLI 명령은 핵심 Azure CLI 서비스의 일부이거나 확장입니다. 확장은 선택적 추가 항목입니다. 참조 형식은 여기에 설명된 대로 릴리스 일정, 상태 및 설치 방법을 결정합니다.

용어 핵심 내선 번호
참조 기본 Azure CLI 서비스의 일부 설치해야 하는 선택적 참조 명령
설치 MSI 설치 관리자와 함께 설치 az extension add를 사용하여 개별적으로
릴리스됨 일정에 따라 새로운 기능 또는 업데이트를 사용할 수 있게 됨에 따라
상태 GA(일반 공급), 미리 보기 또는 더 이상 사용할 수 없음 GA, 미리 보기 또는 더 이상 사용되지 않을 수도 있습니다.

명령 그룹 목록을 얻으려면 .를 실행 az합니다. 확장 목록의 경우 az extension list-available --output table 명령을 사용합니다.

# Get list of all command groups
az

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

핵심

CLI의 영구 부분으로 게시된 Azure CLI 참조를 핵심 참조라고 합니다. 모든 핵심 참조는 Azure CLI와 함께 설치되며 참조의 하위 집합을 선택할 수 없습니다. Azure Cloud Shell을 통해 CLI를 실행하는 경우 핵심 참조는 항상 최신 상태입니다.

내선 번호

확장은 CLI의 일부로 제공되지 않지만 CLI 명령으로 실행됩니다. 일부 확장은 Azure CLI의 영구적인 부분이지만 종종 확장을 통해 미리 보기 및 실험적 명령에 액세스할 수 있습니다. az iot hub와 같은 단일 참조 그룹에는 핵심과 확장 명령이 모두 포함될 수 있습니다. 다음은 두 가지 예입니다.

전체 참조 명령 핵심 Is Extension
az iot hub list
az iot hub job list

처음 사용할 때 확장을 설치하라는 메시지가 표시됩니다. az extension add 명령을 실행하여 확장을 설치할 수도 있습니다.

Azure CLI에서 확장 사용에서 설치 및 업데이트를 비롯한 확장 참조에 대해 자세히 알아볼 수 있습니다. 확장 참조 명령의 전체 목록은 Azure CLI에 대해 사용 가능한 확장을 참조하세요.

참조 상태란?

참조 형식에 관계없이 Azure CLI 참조는 GA(일반 공급), 공개 미리 보기 또는 사용되지 않는 세 가지 상태 범주로 나타낸다. 안정성을 결정하는 참조 명령 상태(형식이 아님)입니다.

GA 공개 프리뷰 Deprecated
안정성 영구 고객 피드백에 따라 변경할 수 있습니다. Microsoft Azure Preview의 사용 약관이 적용됩니다. 제거됩니다.

참고 항목

공개 미리 보기 또는 사용되지 않음나타내는 경고는 Azure CLI 명령 출력의 일부이며 예상되어야 합니다.

단일 참조에 대한 대부분의 명령과 매개 변수에는 단일 상태 있지만 항상 있는 것은 아닙니다. 더 많은 명령을 제공하기 위해 빌드되는 GA 참조에는 GA 및 미리 보기 참조 명령이 모두 있을 수 있습니다. 기능을 높이기 위해 새 매개 변수가 추가되면 단일 명령에는 다른 상태 범주에 속하는 매개 변수가 있을 수도 있습니다. 상태 다른 예제 참조는 다음과 같습니다.

전체 참조 명령 매개 변수 Type GA 공개 프리뷰 Deprecated
az network dns zone list 모두 핵심
az network dns zone create --name, --resource-group, --if-none-match, --parent-name 핵심
--existingParameter5 핵심
--newParameter6 핵심
az network vhub list 모두 내선 번호
az network vhub create --address-prefix, --name, --resource-group, -vwan, --location, --sku 내선 번호
--exsitingParameter7 내선 번호
--newParameter8 내선 번호
az network firewall create 모두 내선 번호

위의 표는 예제일 뿐이며 현재 참조 상태 az network대표하지 않습니다.

참고 항목