阿里云多产品资源采集经验

# 阿里云多产品资源采集经验

## 背景

需要把一个阿里云账号在指定地域的 ECS、RDS、SLB、Redis、ACK、OSS 资源整理进知识库。

## 采集顺序

1. ECS
2. RDS
3. SLB
4. Redis / Tair
5. ACK
6. OSS

## ECS

```shell
aliyun --region cn-beijing ecs DescribeInstances \
  --RegionId cn-beijing \
  --PageSize 100 \
  --PageNumber 1 \
  --mode AK \
  --access-key-id "$ALIYUN_ACCESS_KEY_ID" \
  --access-key-secret "$ALIYUN_ACCESS_KEY_SECRET" > ecs-page-1.json
```

分页经验：

- `TotalCount` 大于 `PageSize` 时继续拉 `PageNumber 2/3/...`。
- 食品北京账号 ECS 有 261 台，需要分页。
- 圣迪乐北京账号 ECS 有 121 台，需要分页。

## RDS

```shell
aliyun --region cn-beijing rds DescribeDBInstances \
  --RegionId cn-beijing \
  --PageSize 100 \
  --mode AK \
  --access-key-id "$ALIYUN_ACCESS_KEY_ID" \
  --access-key-secret "$ALIYUN_ACCESS_KEY_SECRET" > rds.json
```

重点字段：

| 字段 | 说明 |
| --- | --- |
| DBInstanceId | 实例 ID |
| DBInstanceDescription | 实例名称 |
| Engine / EngineVersion | 数据库类型和版本 |
| DBInstanceClass | 规格 |
| DBInstanceStatus | 状态 |
| ZoneId | 可用区 |
| VpcId / VSwitchId | 网络 |
| ExpireTime | 到期时间 |

## SLB

```shell
aliyun --region cn-beijing slb DescribeLoadBalancers \
  --RegionId cn-beijing \
  --PageSize 100 \
  --mode AK \
  --access-key-id "$ALIYUN_ACCESS_KEY_ID" \
  --access-key-secret "$ALIYUN_ACCESS_KEY_SECRET" > slb.json
```

重点字段：

- LoadBalancerName
- LoadBalancerId
- LoadBalancerStatus
- Address
- AddressType：`internet` / `intranet`
- VpcId / VSwitchId

## Redis / Tair

```shell
aliyun --region cn-beijing r-kvstore DescribeInstances \
  --RegionId cn-beijing \
  --PageSize 100 \
  --mode AK \
  --access-key-id "$ALIYUN_ACCESS_KEY_ID" \
  --access-key-secret "$ALIYUN_ACCESS_KEY_SECRET" > redis.json
```

重点字段：

- InstanceName
- InstanceId
- EngineVersion
- ArchitectureType
- InstanceClass
- ConnectionDomain
- PrivateIp
- EndTime

## ACK

```shell
aliyun --region cn-beijing cs DescribeClustersV1 \
  --mode AK \
  --access-key-id "$ALIYUN_ACCESS_KEY_ID" \
  --access-key-secret "$ALIYUN_ACCESS_KEY_SECRET" > ack.json
```

常见情况：

| 情况 | 说明 |
| --- | --- |
| 返回 clusters | 正常采集集群 |
| clusters 为空 | 查询成功，当前账号/地域无集群 |
| EntityNotExist.Role | 默认服务角色不存在，记录错误即可 |

## OSS

```shell
aliyun oss ls \
  --region cn-beijing \
  --mode AK \
  --access-key-id "$ALIYUN_ACCESS_KEY_ID" \
  --access-key-secret "$ALIYUN_ACCESS_KEY_SECRET" > oss.txt
```

经验：

- OSS 查询会列出账号下 Bucket，可能包含多个地域。
- 写知识库时要统计总数，也要统计目标地域数量。

## jq摘要

```shell
jq '{total:.TotalCount}' ecs-page-1.json
jq '{total:.TotalRecordCount}' rds.json
jq '{total:.TotalCount}' slb.json
jq '{total:.TotalCount}' redis.json
```

## 经验结论

- 先把原始结果保存到 `/tmp`，再加工成 Markdown。
- 知识库清单建议写：名称、ID、状态、规格、可用区、网络、内网地址、到期时间。
- API 报错也要记录到对应资源页，避免误以为没有资源。

## 适用位置

- [[03-平台管理/平台管理总览]]
- [[03-平台管理/食品北京阿里云/食品北京阿里云总览]]
- [[03-平台管理/食品乌兰察布阿里云/食品乌兰察布阿里云总览]]
- [[03-平台管理/实业北京阿里云/实业北京阿里云总览]]
- [[03-平台管理/圣迪乐北京阿里云/圣迪乐北京阿里云总览]]