阿里云ECS管理
前置准备
1. 安装阿里云CLI
# 检查是否已安装
aliyun --version
# 未安装时执行
yum install aliyun-cli -y
2. 配置认证
首次使用或命令报错时需要配置认证。
根据你的使用场景选择认证模式：
| 使用场景 |
推荐模式 |
配置命令 |
| 在ECS实例内执行 |
EcsRamRole（最推荐） |
aliyun configure --mode EcsRamRole --ram-role-name <RAM角色名> |
| 本地开发/测试 |
AK |
aliyun configure --mode AK --access-key-id <AK> --access-key-secret <SK> |
| 本地交互式操作 |
OAuth |
aliyun configure --mode OAuth |
| 跨账号/精细化权限 |
RamRoleArn |
aliyun configure --mode RamRoleArn --access-key-id <AK> --access-key-secret <SK> --ram-role-arn <角色ARN> |
快速配置示例：
# 交互式配置（推荐新手使用）
aliyun configure
# 或命令行直接配置（替换<>中的参数）
aliyun configure --mode <模式> --region <地域ID>
安全建议：优先使用临时凭证（EcsRamRole、RamRoleArn、OAuth），避免使用长期AccessKey。详细认证方式说明及优先级建议请参考 authentication.md
3. 获取实例元数据（ECS实例内）
在ECS实例内部，无需任何认证即可通过Metadata服务获取当前实例的元数据信息：
# 获取实例ID
INSTANCE_ID=$(curl -s http://100.100.100.200/latest/meta-data/instance-id)
# 获取地域ID
REGION_ID=$(curl -s http://100.100.100.200/latest/meta-data/region-id)
# 获取实例规格
INSTANCE_TYPE=$(curl -s http://100.100.100.200/latest/meta-data/instance-type)
更多Metadata字段及使用方法请参考 metadata-api.md
常用操作
实例管理
| 操作 |
命令示例 |
| 查询实例列表 |
aliyun ecs DescribeInstances |
| 查询实例详情 |
aliyun ecs DescribeInstanceAttribute --InstanceId <实例ID> |
| 查询实例状态 |
aliyun ecs DescribeInstanceStatus |
| 创建实例 |
aliyun ecs RunInstances --ImageId <镜像ID> --InstanceType <规格> --RegionId <地域> |
| 启动实例 |
aliyun ecs StartInstance --InstanceId <实例ID> |
| 停止实例 |
aliyun ecs StopInstance --InstanceId <实例ID> |
| 重启实例 |
aliyun ecs RebootInstance --InstanceId <实例ID> |
| 释放实例 |
aliyun ecs DeleteInstance --InstanceId <实例ID> |
磁盘管理
| 操作 |
命令示例 |
| 查询磁盘列表 |
aliyun ecs DescribeDisks |
| 创建磁盘 |
aliyun ecs CreateDisk --RegionId <地域> --ZoneId <可用区> --Size <大小GB> |
| 挂载磁盘 |
aliyun ecs AttachDisk --InstanceId <实例ID> --DiskId <磁盘ID> |
| 卸载磁盘 |
aliyun ecs DetachDisk --InstanceId <实例ID> --DiskId <磁盘ID> |
| 离线扩容磁盘 |
aliyun ecs ResizeDisk --DiskId <磁盘ID> --NewSize <新大小GB> |
| 在线扩容磁盘 |
aliyun ecs ResizeDisk --DiskId <磁盘ID> --NewSize <新大小GB> --Type online |
| 删除磁盘 |
aliyun ecs DeleteDisk --DiskId <磁盘ID> |
快照管理
| 操作 |
命令示例 |
| 查询快照列表 |
aliyun ecs DescribeSnapshots |
| 创建快照 |
aliyun ecs CreateSnapshot --DiskId <磁盘ID> |
| 删除快照 |
aliyun ecs DeleteSnapshot --SnapshotId <快照ID> |
| 回滚磁盘 |
aliyun ecs ResetDisk --DiskId <磁盘ID> --SnapshotId <快照ID> |
镜像管理
| 操作 |
命令示例 |
| 查询镜像列表 |
aliyun ecs DescribeImages |
| 创建自定义镜像 |
aliyun ecs CreateImage --InstanceId <实例ID> |
| 删除镜像 |
aliyun ecs DeleteImage --ImageId <镜像ID> |
| 复制镜像 |
aliyun ecs CopyImage --ImageId <镜像ID> --DestinationRegionId <目标地域> |
安全组管理
| 操作 |
命令示例 |
| 查询安全组列表 |
aliyun ecs DescribeSecurityGroups |
| 查询安全组规则 |
aliyun ecs DescribeSecurityGroupAttribute --SecurityGroupId <安全组ID> |
| 创建安全组 |
aliyun ecs CreateSecurityGroup --RegionId <地域> |
| 添加入方向规则 |
aliyun ecs AuthorizeSecurityGroup --SecurityGroupId <安全组ID> --IpProtocol tcp --PortRange 22/22 --SourceCidrIp 0.0.0.0/0 |
| 添加出方向规则 |
aliyun ecs AuthorizeSecurityGroupEgress --SecurityGroupId <安全组ID> --IpProtocol tcp --PortRange 80/80 --DestCidrIp 0.0.0.0/0 |
| 删除安全组 |
aliyun ecs DeleteSecurityGroup --SecurityGroupId <安全组ID> |
密钥对管理
| 操作 |
命令示例 |
| 查询密钥对列表 |
aliyun ecs DescribeKeyPairs |
| 创建密钥对 |
aliyun ecs CreateKeyPair --KeyPairName <密钥对名称> --RegionId <地域> |
| 导入密钥对 |
aliyun ecs ImportKeyPair --KeyPairName <密钥对名称> --PublicKeyBody <公钥内容> |
| 绑定密钥对 |
aliyun ecs AttachKeyPair --InstanceIds '["<实例ID>"]' --KeyPairName <密钥对名称> |
| 解绑密钥对 |
aliyun ecs DetachKeyPair --InstanceIds '["<实例ID>"]' --KeyPairName <密钥对名称> |
| 删除密钥对 |
aliyun ecs DeleteKeyPairs --KeyPairNames <密钥对名称> |
弹性网卡管理
| 操作 |
命令示例 |
| 查询弹性网卡列表 |
aliyun ecs DescribeNetworkInterfaces |
| 创建弹性网卡 |
aliyun ecs CreateNetworkInterface --RegionId <地域> --VSwitchId <交换机ID> |
| 挂载弹性网卡 |
aliyun ecs AttachNetworkInterface --NetworkInterfaceId <网卡ID> --InstanceId <实例ID> |
| 卸载弹性网卡 |
aliyun ecs DetachNetworkInterface --NetworkInterfaceId <网卡ID> --InstanceId <实例ID> |
| 删除弹性网卡 |
aliyun ecs DeleteNetworkInterface --NetworkInterfaceId <网卡ID> |
地域与可用区
| 操作 |
命令示例 |
| 查询地域列表 |
aliyun ecs DescribeRegions |
| 查询可用区列表 |
aliyun ecs DescribeZones --RegionId <地域ID> |
实例规格
| 操作 |
命令示例 |
| 查询实例规格族 |
aliyun ecs DescribeInstanceTypeFamilies |
| 查询实例规格详情 |
aliyun ecs DescribeInstanceTypes |
高级用法
使用过滤器
# 按状态过滤实例
aliyun ecs DescribeInstances --RegionId cn-hangzhou --Status Running
# 按标签过滤
aliyun ecs DescribeInstances --RegionId cn-hangzhou --Tag.1.Key Environment --Tag.1.Value Production
分页查询
# 分页查询，每页10条，查询第1页
aliyun ecs DescribeInstances --RegionId cn-hangzhou --PageSize 10 --PageNumber 1
输出格式
# JSON格式输出
aliyun ecs DescribeInstances --RegionId cn-hangzhou --output json
# 表格格式输出
aliyun ecs DescribeInstances --RegionId cn-hangzhou --output table
执行前检查
重要：示例命令仅展示基本用法。执行前请评估：
- 示例参数是否满足实际需求？
- 是否需要额外参数（如标签、安全组、资源组等）？
- 不确定时，必须先查看帮助：
aliyun ecs <API名称> --help
以下场景必须查看帮助：
- 创建资源（RunInstances、CreateDisk、CreateSecurityGroup 等）
- 修改配置（ResizeDisk、ModifyInstanceAttribute 等）
- 涉及安全/网络的规则设置（AuthorizeSecurityGroup 等）
获取帮助
查询API列表
aliyun ecs --help
查询具体API参数
aliyun ecs <API名称> --help
# 示例
aliyun ecs DescribeInstances --help
aliyun ecs RunInstances --help
常用API速查
实例生命周期
CreateInstance - 创建实例RunInstances - 批量创建实例StartInstance - 启动实例StopInstance - 停止实例RebootInstance - 重启实例DeleteInstance - 释放实例DescribeInstances - 查询实例详情DescribeInstanceStatus - 查询实例状态
磁盘与存储
CreateDisk - 创建磁盘AttachDisk - 挂载磁盘DetachDisk - 卸载磁盘DeleteDisk - 删除磁盘ResizeDisk - 扩容磁盘DescribeDisks - 查询磁盘列表
快照与镜像
CreateSnapshot - 创建快照DeleteSnapshot - 删除快照DescribeSnapshots - 查询快照列表CreateImage - 创建镜像DeleteImage - 删除镜像DescribeImages - 查询镜像列表
网络与安全
CreateSecurityGroup - 创建安全组AuthorizeSecurityGroup - 添加安全组入方向规则AuthorizeSecurityGroupEgress - 添加安全组出方向规则DescribeSecurityGroups - 查询安全组列表CreateNetworkInterface - 创建弹性网卡AttachNetworkInterface - 挂载弹性网卡
密钥与访问
CreateKeyPair - 创建密钥对ImportKeyPair - 导入密钥对AttachKeyPair - 绑定密钥对DetachKeyPair - 解绑密钥对DescribeKeyPairs - 查询密钥对列表
alibaba