Azure Cli Toolkit Free

Azure云平台命令行管理工具,支持虚拟机、存储、网络等核心资源的基本操作

Azure 命令行工具免费版

概述

Azure 命令行工具免费版为个人开发者提供 Azure 云平台的核心管理能力。通过 az 命令行工具,用户可以管理订阅、资源组、虚拟机、存储账户、网络资源等核心云资源。

免费版聚焦个人开发场景,提供交互式操作与常用命令,帮助开发者快速上手 Azure 资源管理。

核心能力

1. 认证与账户管理

bash

# 交互式登录
az login

# 查看当前账户
az account show

# 列出所有订阅
az account list

# 切换默认订阅
az account set --subscription "我的订阅"

输入: 用户提供认证与账户管理所需的指令和必要参数。 处理: 按照skill规范执行认证与账户管理操作,遵循单一意图原则。 输出: 返回认证与账户管理的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

2. 资源组管理

bash

# 创建资源组
az group create -g myResourceGroup -l eastus

# 列出所有资源组
az group list

# 查看资源组详情
az group show -g myResourceGroup

# 删除资源组
az group delete -g myResourceGroup

输入: 用户提供资源组管理所需的指令和必要参数。 处理: 按照skill规范执行资源组管理操作,遵循单一意图原则。 输出: 返回资源组管理的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

3. 虚拟机操作

bash

# 创建虚拟机
az vm create -g myResourceGroup -n myVM --image UbuntuLTS

# 列出虚拟机
az vm list -g myResourceGroup

# 启动/停止/重启
az vm start -g myResourceGroup -n myVM
az vm stop -g myResourceGroup -n myVM
az vm restart -g myResourceGroup -n myVM

# 查看虚拟机详情
az vm show -g myResourceGroup -n myVM

输入: 用户提供虚拟机操作所需的指令和必要参数。 处理: 按照skill规范执行虚拟机操作操作,遵循单一意图原则。 输出: 返回虚拟机操作的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

4. 存储账户操作

bash

# 创建存储账户
az storage account create -g myResourceGroup -n mystorage --sku Standard_LRS

# 列出存储账户
az storage account list

# 上传文件到 Blob
az storage blob upload \
  --account-name mystorage \
  -c mycontainer \
  -n myfile.txt \
  -f ./local-file.txt

# 下载 Blob 文件
az storage blob download \
  --account-name mystorage \
  -c mycontainer \
  -n myfile.txt \
  -f ./downloaded.txt

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

5. 输出格式化与查询

bash

# JSON 格式输出
az vm list -o json

# 表格格式输出
az vm list -o table

# JMESPath 查询:提取名称
az vm list --query "[].name" -o tsv

# 条件过滤:运行中的虚拟机
az vm list --query "[?powerState=='VM running'].name"

输入: 用户提供存储账户操作所需的指令和必要参数。 处理: 按照skill规范执行存储账户操作操作,遵循单一意图原则。 输出: 返回存储账户操作的执行结果,包含操作状态和输出数据。 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：Azure、云平台命令行管理、支持虚拟机、网络等核心资源的、基本操作、面向个人开发者的、提供核心资源管理、核心能力、订阅与资源组管理、网络资源基本操作、交互式登录与基础等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一: 搭建开发测试环境

开发者需要快速创建一台测试虚拟机并配置存储。

bash

# 1. 创建资源组
az group create -g dev-test-rg -l eastus

# 2. 创建虚拟机
az vm create -g dev-test-rg -n dev-vm \
  --image UbuntuLTS \
  --admin-username devuser \
  --generate-ssh-keys

# 3. 创建存储账户
az storage account create -g dev-test-rg -n devstorage01 --sku Standard_LRS

# 4. 创建容器
az storage container create --account-name devstorage01 -n uploads

# 5. 验证资源
az resource list -g dev-test-rg -o table

场景二: 查询资源状态

定期查看个人云资源的状态与费用。

bash

# 查看所有运行中的虚拟机
az vm list -d --query "[?powerState=='VM running'].{name:name, location:location}" -o table

# 查看存储账户使用情况
az storage account list --query "[].{name:name, sku:sku.name}" -o table

# 按标签筛选资源
az resource list --tag env=dev -o table

场景三: 配置默认参数

设置常用默认值,简化日常命令输入。

bash

# 设置默认资源组、订阅、区域
az configure --defaults group=dev-test-rg location=eastus

# 之后创建资源无需重复指定
az vm create -n new-vm --image UbuntuLTS

快速开始

依赖详情

macOS:

bash

brew install azure-cli

Linux (Ubuntu/Debian):

bash

curl -sL https://aka.ms/InstallAzureCliLinux | bash

Windows:

powershell

choco install azure-cli

第二步: 验证安装

bash

az --version
az --help

第三步: 登录 Azure

bash

az login

浏览器会打开登录页面,完成认证后终端会显示订阅列表。

第四步: 创建第一个资源

bash

az group create -g my-first-rg -l eastus
az vm create -g my-first-rg -n my-vm --image UbuntuLTS

结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。

示例

常用全局参数

参数	简写	说明
--subscription		指定订阅
--resource-group	-g	指定资源组
--output	-o	输出格式: json/table/tsv/yaml
--query		JMESPath 查询表达式
--verbose	-v	详细输出
--help	-h	帮助信息

默认配置

bash

# 查看当前配置
az configure --list-defaults

# 设置默认值
az configure --defaults group=myRG location=eastus

# 清除默认值
az configure --defaults group='' location=''

最佳实践

1. 善用查询语法

bash

# 提取关键字段
az vm list --query "[].{name:name, state:powerState}" -o table

# 排序输出
az vm list --query "sort_by([], &name)"

# 统计数量
az vm list --query "length([])"

2. 使用 --no-wait 加速操作

bash

# 不等待创建完成,立即返回
az vm create -g myRG -n myVM --image UbuntuLTS --no-wait

# 稍后用 show 查看状态
az vm show -g myRG -n myVM --query provisioningState

3. 启用 Tab 补全

bash

# macOS (zsh)
eval "$(az completion init zsh)"

# Linux (bash)
eval "$(az completion init bash)"

4. 命令搜索

bash

# 按功能描述搜索命令
az find "create virtual machine"
az find "list storage"

常见问题

Q1: 免费版支持多少个命令模块?

免费版支持 Azure CLI 全部 66 个命令模块的基本操作,但部分高级批量操作与自动化脚本需要 PRO 版。

Q2: 登录后看不到我的订阅?

确认账户有权限访问目标订阅。可运行 az account list --all 查看所有可访问的订阅。

Q3: 如何切换到不同的租户?

bash

# 列出可访问的租户
az account tenant list

# 切换租户(登录时指定)
az login --tenant <tenant_id>

Q4: 命令执行报权限不足?

检查当前账户是否有所需角色权限。可用 az role assignment list 查看当前角色分配。

已知限制

免费版本身不限制命令调用次数,但 Azure 平台本身的 API 限流策略仍然适用。

• 当前为免费版本,如需完整功能请升级到付费版获取全部能力

依赖说明

运行环境

• Agent 平台: 支持读取 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等)
• 操作系统: Windows / macOS / Linux
• Azure CLI: v2.50 或更高版本

第三方依赖

依赖项	类型	是否必需	获取方式
Azure CLI	CLI 工具	必需	brew / apt / choco 安装
Azure 订阅	云服务	必需	azure.com 注册
LLM API	API	必需	由 Agent 内置 LLM 提供
jq(可选)	CLI 工具	否	系统包管理器

API Key 配置

• 交互式登录无需 API Key,通过浏览器完成认证
• 服务主体认证需配置以下环境变量:

bash

export AZURE_CLIENT_ID="your-client-id"
export AZURE_CLIENT_SECRET="your-client-secret"
export AZURE_TENANT_ID="your-tenant-id"

可用性分类

• 分类: MD+EXEC(Markdown 指令 + 命令行执行)
• 说明: 通过自然语言指令驱动 Agent 执行 az 命令管理 Azure 资源
• 离线可用: 否,所有操作需要连接 Azure 云平台

错误处理

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达	执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案