mcpField
A
aliyun-cdn-manage

aliyun-cdn-manage

github.com/cinience云与 DevOps39663 次安装11 周前更新
代码仓库

关于 aliyun-cdn-manage

用于通过 Alibaba Cloud CDN OpenAPI 管理 CDN，涵盖域名、缓存、证书、日志和监控操作。工作流强调先查询再变更，并保存执行证据以便复核。

主要功能

  1. 01管理加速域名
  2. 02刷新和预热缓存
  3. 03配置 HTTPS 证书
  4. 04查询日志与监控
  5. 05发现 API 并验证变更

适用场景

  1. 01添加或更新 CDN 域名
  2. 02刷新或预热缓存内容
  3. 03调整 HTTPS 证书设置
  4. 04查看 CDN 流量与日志

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/cinience/alicloud-skills --skill aliyun-cdn-manage

安装后在 Claude Code 中输入/aliyun-cdn-manage确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
sources.md
scripts/
list_openapi_meta_apis.py

详细介绍

Category: 服务

阿里云 CDN

用途

使用阿里云 CDN OpenAPI（RPC）执行常见操作和集成，包括：

  • 加速域名生命周期管理（创建/配置/启动-停止/删除）
  • 缓存刷新和预热（目录/文件/域名）
  • HTTPS 证书配置和更新
  • 日志和监控查询（实时/离线）

前提条件

  • 已准备好遵循最小权限原则的 RAM 凭证（建议使用 STS 临时凭证）。
  • 已确认域名所有权和加速范围策略（中国内地/全球）。
  • 执行变更操作前，使用只读 API 验证当前状态。

工作流

  1. 定义目标资源：加速域名、业务类型、变更窗口和回滚标准。
  2. 执行 API 发现，确认目标 API 名称、必需参数和版本。
  3. 先使用只读 API（Describe*）查询当前配置/状态。
  4. 执行变更 API（Add*/Set*/BatchSet*/Delete*），并记录请求上下文。
  5. 使用监控/日志 API 验证变更，并将证据保存到 output/aliyun-cdn-manage/。

AccessKey 优先级

  1. 环境变量：ALIBABACLOUD_ACCESS_KEY_ID / ALIBABACLOUD_ACCESS_KEY_SECRET / ALIBABACLOUD_REGION_ID
  2. 共享凭证文件：~/.alibabacloud/credentials

如果不清楚地域/环境，请在执行变更操作前向用户确认。

API 发现

  • 产品代码：cdn
  • 默认 API 版本：2018-05-10
  • 元数据来源：https://api.aliyun.com/meta/v1/products/cdn/versions/2018-05-10/api-docs.json

最简可执行快速入门

python skills/network/cdn/aliyun-cdn-manage/scripts/list_openapi_meta_apis.py

可选参数：

python skills/network/cdn/aliyun-cdn-manage/scripts/list_openapi_meta_apis.py \
  --product-code cdn \
  --version 2018-05-10 \
  --output-dir output/aliyun-cdn-manage

常见操作映射

  • 域名管理：AddCdnDomain、DescribeUserDomains、DescribeCdnDomainDetail、DeleteCdnDomain
  • 缓存刷新/预热：RefreshObjectCaches（刷新）、PushObjectCache（预热）
  • HTTPS 证书：SetDomainServerCertificate、DescribeDomainCertificateInfo
  • 日志和监控：DescribeCdnDomainLogs、DescribeDomainRealTimeRequestStatData、DescribeDomainRealTimeBpsData

输出策略

将生成的文件和执行证据写入： output/aliyun-cdn-manage/

验证

mkdir -p output/aliyun-cdn-manage
for f in skills/network/cdn/aliyun-cdn-manage/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/aliyun-cdn-manage/validate.txt

通过标准：命令以状态码 0 退出，且已生成 output/aliyun-cdn-manage/validate.txt。

输出和证据

  • 将生成文件、命令输出和 API 响应摘要保存到 output/aliyun-cdn-manage/。
  • 在证据文件中包含关键参数（地域/资源 ID/时间范围），以便复现。

前提条件

  • 执行前配置遵循最小权限原则的阿里云凭证。
  • 优先使用环境变量：ALIBABACLOUD_ACCESS_KEY_ID、ALIBABACLOUD_ACCESS_KEY_SECRET、可选的 ALIBABACLOUD_REGION_ID。
  • 如果不清楚地域，请在运行变更操作前询问用户。

参考资料

  • 来源列表：references/sources.md

评论

支持 Markdown