aliyun-pts-manage

Category: service

Alibaba Cloud Performance Testing Service (PTS)

目的

Alibaba Cloud PTS OpenAPI を使用して、以下を実行します。

• テストシーンの一覧表示と確認
• 負荷テストの計画とライフサイクルの自動化
• 検証とトラブルシューティングのためのレポートとメトリクスの取得

前提条件

• 最小権限の Alibaba Cloud 認証情報を設定します。
• Python SDK をインストールします（仮想環境を推奨します）。

python3 -m venv .venv
. .venv/bin/activate
python -m pip install -U alibabacloud_pts20201020 alibabacloud_tea_openapi

• 環境変数の使用を推奨します。
  • ALIBABACLOUD_ACCESS_KEY_ID
  • ALIBABACLOUD_ACCESS_KEY_SECRET
  • 任意の ALIBABACLOUD_REGION_ID
• 変更を伴う操作の前に、読み取り専用の API ディスカバリーと現在の状態の確認を実行します。

AccessKey の優先順位

1. 環境変数：ALIBABACLOUD_ACCESS_KEY_ID / ALIBABACLOUD_ACCESS_KEY_SECRET / ALIBABACLOUD_REGION_ID
2. 共有認証情報ファイル：~/.alibabacloud/credentials

リージョンや環境が不明な場合は、変更を伴う操作の前にユーザーに確認してください。

ワークフロー

1. 対象リージョン、テストシーンの識別子、操作範囲を特定します。
2. API ディスカバリーを実行し、API 名と必須パラメーターを確認します。
3. まず読み取り専用の API（List* / Get* / Describe*）を実行します。
4. ロールバックと変更時間帯を確認してから、変更を伴う操作を実行します。
5. 出力と証跡を output/aliyun-pts-manage/ に保存します。

API ディスカバリー

• プロダクトコード：PTS
• デフォルトの API バージョン：2020-10-20
• メタデータの取得元：https://api.aliyun.com/meta/v1/products/PTS/versions/2020-10-20/api-docs.json

最小実行可能なクイックスタート

python skills/observability/pts/aliyun-pts-manage/scripts/list_openapi_meta_apis.py

任意の引数：

python skills/observability/pts/aliyun-pts-manage/scripts/list_openapi_meta_apis.py \
  --product-code PTS \
  --version 2020-10-20 \
  --output-dir output/aliyun-pts-manage

シーンを一覧表示する（読み取り専用）：

python skills/observability/pts/aliyun-pts-manage/scripts/list_pts_scenes.py \
  --region cn-hangzhou \
  --page-number 1 \
  --page-size 10 \
  --output output/aliyun-pts-manage/scenes.txt

シーンを 1 つ開始する（変更を伴う）：

python skills/observability/pts/aliyun-pts-manage/scripts/start_pts_scene.py \
  --region cn-hangzhou \
  --scene-id <scene-id> \
  --wait \
  --output output/aliyun-pts-manage/start-result.json

シーンを 1 つ停止する（変更を伴う）：

python skills/observability/pts/aliyun-pts-manage/scripts/stop_pts_scene.py \
  --region cn-hangzhou \
  --scene-id <scene-id> \
  --wait \
  --output output/aliyun-pts-manage/stop-result.json

一般的な操作一覧

• シーンの一覧表示：ListPtsScene、GetPtsScene、ListOpenJMeterScenes、GetOpenJMeterScene
• シーンのライフサイクル：CreatePtsScene、SavePtsScene、ModifyPtsScene、DeletePtsScene、DeletePtsScenes
• テスト実行の制御：StartPtsScene、StopPtsScene、StartTestingJMeterScene、StopTestingJMeterScene
• デバッグの制御：StartDebugPtsScene、StopDebugPtsScene、StartDebuggingJMeterScene、StopDebuggingJMeterScene
• レポート／メトリクス：ListPtsReports、GetPtsReportDetails、GetPtsSceneRunningData、GetPtsSceneRunningStatus

API の分類別一覧については、references/api_quick_map.md を参照してください。

スクリプト一覧

• scripts/list_openapi_meta_apis.py：メタデータを取得し、API 一覧ファイルを生成します。
• scripts/list_pts_scenes.py：ページネーションを使用して PTS シーンを一覧表示します。
• scripts/start_pts_scene.py：シーンを開始し、必要に応じて実行状態をポーリングします。
• scripts/stop_pts_scene.py：シーンを停止し、必要に応じて実行中でなくなるまでポーリングします。

出力ポリシー

生成されたファイルと実行証跡は、次の場所に書き込みます。 output/aliyun-pts-manage/

検証

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

合格条件：コマンドが 0 で終了し、output/aliyun-pts-manage/validate.txt が生成されること。

出力と証跡

• 成果物、コマンド出力、API レスポンスの要約を output/aliyun-pts-manage/ に保存します。
• 再現性を確保できるよう、証跡ファイルに主要なパラメーター（リージョン／リソース ID／期間）を含めます。

参考資料

• ソース一覧：references/sources.md
• API クイックマップ：references/api_quick_map.md
• リクエスト／レスポンスのテンプレート：references/templates.md