개요: 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대표하지 않습니다.
참고 항목
Azure CLI