alicloud-network-cdn について
Alibaba Cloud CDN の OpenAPI を操作するスキルです。ドメイン管理、キャッシュ更新・プリロード、HTTPS 証明書、ログや監視の照会に対応し、変更前の読み取り専用チェックを重視します。
主な機能
- 01加速ドメインのライフサイクル管理
- 02キャッシュ更新とプリロード
- 03HTTPS 証明書の設定
- 04ログと監視データの照会
- 05OpenAPI メタデータの検出
活用シーン
- 01加速ドメインの作成や更新
- 02CDN キャッシュの更新やプリロード
- 03HTTPS 証明書の更新
- 04リクエスト数や帯域幅データの照会
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ cinience/ alicloud-skills --skill alicloud-network-cdnインストール後、Claude Code で/alicloud-network-cdnを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/sources.mdscripts/list_openapi_meta_apis.py詳細
カテゴリ:サービス
Alibaba Cloud CDN
目的
Alibaba Cloud CDN OpenAPI(RPC)を使用して、以下を含む一般的な操作や統合を行います。
- 高速化ドメインのライフサイクル管理(作成/設定/開始・停止/削除)
- キャッシュの更新とプリロード(ディレクトリ/ファイル/ドメイン)
- HTTPS 証明書の設定と更新
- ログとモニタリングの照会(リアルタイム/オフライン)
前提条件
- 最小権限の RAM 認証情報を用意します(STS 一時認証情報を推奨します)。
- ドメインの所有権と高速化の適用範囲ポリシー(中国本土/グローバル)を確認します。
- 変更を伴う操作の前に、読み取り専用 API を使用して現在の状態を検証します。
ワークフロー
- 対象リソース(高速化ドメイン、ビジネスタイプ、変更時間枠、ロールバック基準)を定義します。
- API を調査し、対象 API 名、必須パラメーター、バージョンを確認します。
- まず読み取り専用 API(
Describe*)で現在の設定/状態を照会します。 - 変更を伴う API(
Add*/Set*/BatchSet*/Delete*)を実行し、リクエストのコンテキストを記録します。 - モニタリング/ログ API で変更を検証し、証跡を
output/alicloud-network-cdn/に保存します。
AccessKey の優先順位
- 環境変数:
ALICLOUD_ACCESS_KEY_ID/ALICLOUD_ACCESS_KEY_SECRET/ALICLOUD_REGION_ID - 共有認証情報ファイル:
~/.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/alicloud-network-cdn/scripts/list_openapi_meta_apis.py
オプション引数:
python skills/network/cdn/alicloud-network-cdn/scripts/list_openapi_meta_apis.py \
--product-code cdn \
--version 2018-05-10 \
--output-dir output/alicloud-network-cdn
一般的な操作マップ
- ドメイン管理:
AddCdnDomain、DescribeUserDomains、DescribeCdnDomainDetail、DeleteCdnDomain - キャッシュの更新/プリロード:
RefreshObjectCaches(更新)、PushObjectCache(プリロード) - HTTPS 証明書:
SetDomainServerCertificate、DescribeDomainCertificateInfo - ログとモニタリング:
DescribeCdnDomainLogs、DescribeDomainRealTimeRequestStatData、DescribeDomainRealTimeBpsData
出力ポリシー
生成ファイルと実行証跡を以下に書き込みます:
output/alicloud-network-cdn/
検証
mkdir -p output/alicloud-network-cdn
for f in skills/network/cdn/alicloud-network-cdn/scripts/*.py; do
python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/alicloud-network-cdn/validate.txt
合格基準:コマンドが 0 で終了し、output/alicloud-network-cdn/validate.txt が生成されること。
出力と証跡
- 成果物、コマンド出力、API レスポンスの概要を
output/alicloud-network-cdn/に保存します。 - 再現性を確保するため、証跡ファイルに主要なパラメーター(リージョン/リソース ID/時間範囲)を含めます。
前提条件
- 実行前に、最小権限の Alibaba Cloud 認証情報を設定します。
- 環境変数
ALICLOUD_ACCESS_KEY_ID、ALICLOUD_ACCESS_KEY_SECRETと、任意のALICLOUD_REGION_IDを使用することを推奨します。 - リージョンが不明な場合は、変更を伴う操作を実行する前にユーザーに確認します。
参考資料
- ソース一覧:
references/sources.md
コメント
Markdown 対応