개요: Azure CLI 참조 형식 및 상태

Azure CLI에는 종종 참조 상태와 바꿔서 설명되는 여러 참조 형식이 있습니다. 이 문서에서는 Azure CLI 형식과 상태의 차이점을 설명하고 둘 다 사용하기 위한 정보를 제공합니다.

Azure CLI 구문 구성 요소

Azure CLI 구문은 참조, 명령 및 매개 변수의 조합입니다. 종종 전체 참조 명령 을 간단히 명령 이라고 합니다.

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

참조 형식이란?

참조 형식은 참조 명령이 기본 Azure CLI 서비스의 일부인지 또는 선택적 추가 항목인지를 알려줍니다. Azure CLI 참조 명령에는 핵심확장 의 두 가지 유형이 있습니다.

핵심 확장
참조 기본 Azure CLI 서비스의 일부 설치해야 하는 선택적 참조 명령
설치 MSI 설치 관리자와 함께 설치 az extension add와 개별 설치
릴리스됨 일정에 따라 새 기능 또는 업데이트를 사용할 수 있게 될 때
상태 GA(일반적으로 사용 가능), 미리 보기 또는 실험적 중 하나가 될 수 있습니다. GA, 미리 보기 또는 실험적 중 하나가 될 수도 있음

모든 Azure CLI 참조는 Windows, macOS, Linux, Docker 및 Azure Cloud Shell에서 실행할 수 있습니다.

핵심

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

확장

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

전체 참조 명령 핵심 확장
az iot hub list
az iot hub query
az iot hub certificate create
az iot hub device identify create

중요

az extension add 명령을 실행하여 사용하기 전에 확장을 설치해야 합니다.

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

참조 상태란?

형식에 관계 없이 Azure CLI 참조는 다음과 같은 세 가지 상태 범주 즉, GA(일반적으로 사용 가능), 공개 미리 보기 또는 실험적 에 속합니다. 이는 안정성 및 지원 수준을 결정하는 형식이 아닌 참조 명령 상태입니다.

GA 퍼블릭 미리 보기 실험적
안정성 영구 고객 피드백에 따라 변경할 수 있습니다. Microsoft Azure 미리 보기의 사용 약관이 적용됩니다. 고객 피드백에 따라 변경할 수 있습니다. 종종 공개 미리 보기로 마이그레이션됩니다. 제거될 수 있습니다.
지원 수준 전체 Partial None

단일 참조의 명령 및 매개 변수 대부분은 단일 상태를 갖지만 항상 그렇지는 않습니다. 더 많은 명령을 제공하기 위해 빌드 중인 GA 참조에는 GA, 미리 보기 및 실험적 참조 명령이 있을 수 있습니다. 새로운 매개 변수가 추가되어 기능이 증가함에 따라, 단일 명령에 다른 상태 범주에 속하는 매개 변수가 포함될 수도 있습니다. 상태가 다른 예제 참조는 다음과 같습니다.

전체 참조 명령 매개 변수 유형 GA 퍼블릭 미리 보기 실험적
az network dns zone list 모두 핵심
az network dns zone create --name, --resource-group, --if-none-match, --parent-name 핵심
--newFutureParameter1 핵심
--newFutureParameter2 핵심
az network vhub list 모두 내선 번호
az network vhub create --address-prefix, --name, --resource-group, -vwan, --location, --sku 내선 번호
--newFutureParameter1 내선 번호
--newFutureParameter2 내선 번호
az network firewall create 모두 내선 번호

참고

공개 미리 보기 또는 실험적 을 표시하는 경고는 Azure CLI 명령 출력의 일부이며 예상되어야 합니다.

참고 항목