alibabacloud-cms-manage

CMS CLI — aliyun cms2

前提条件の確認

セッションごとに1回：この前提条件の確認は、会話内でこのスキルを初めて呼び出したときにのみ実行してください。同じセッション内ですでにすべての確認に合格している場合は、該当するモジュールに直接進んでください。

1. aliyun が存在するか確認する — which aliyun（macOS/Linux）または where aliyun（Windows）を実行します。

   • 見つからない場合 → まず aliyun CLI をインストールするようユーザーに依頼します：https://help.aliyun.com/document_detail/121541.html。停止して待ちます。

2. CLI のバージョンを確認する — aliyun version を実行します。必要な最小バージョン：3.3.15（frontmatter の compatibility を参照）。

   ⚠️ バージョンの各セグメントは、semver に従って整数として比較します：4 < 15 のため、3.3.4 < 3.3.15 です。 シェルでの確認：printf '%s\n' "3.3.15" "$(aliyun version)" | sort -V | head -1 出力が現在のバージョンと一致する場合、要件を満たしていません。

   • バージョンに問題がない場合 → 手順3に進みます。
   • バージョンが古い、または認識できない場合 →
     1. aliyun upgrade --help を実行し、upgrade サブコマンドが存在するか確認します。
        • 利用可能な場合 → aliyun upgrade -y を実行して最新バージョンに自動更新し、その後 aliyun version を再確認します。
     2. upgrade が利用できない場合 → 公式ガイドに従って手動でアップグレードするようユーザーに依頼します：https://help.aliyun.com/zh/cli/update-cli。アップグレードが完了したことをユーザーが確認するまで待ち、その後 aliyun version を再確認します。
     3. アップグレードに成功した場合 → 手順3に進みます。
     4. アップグレードに失敗した場合 → 手動でアップグレードするようユーザーに依頼します：https://help.aliyun.com/zh/cli/update-cli。停止して終了します。

3. cms2 プラグインを確認する — aliyun cms2 --help を実行します。

   • ヘルプの出力に問題がない場合 → 認証情報に進みます。
   • unknown command / 見つからない場合 → 直ちに停止し、以下のエラーレポートに CLI バージョン、OS、エラーメッセージを追加して出力します。その後、CLI の呼び出しを一切行いません。

---

認証情報

aliyun cms2 は aliyun CLI の認証情報システム（aliyun configure）を再利用します。 プロファイルを切り替えるには --profile <name> を使用します。

オブザーバビリティ

このスキルの読み込み時に、セッション ID（32文字の小文字の16進数文字列）をセッションごとに1回生成します...

すべての aliyun cms2 コマンドに、以下を追加します： --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-cms-manage/{session-id}"

ローカルユーティリティコマンド（例：version、configure、plugin、--help）はこのフラグに対応していないため、対象外です。

全般的な規約

厳守事項：aliyun cms、他の API バージョン、またはいかなる回避策へのフォールバックも固く禁止されています。

セッション内でサブコマンドを初めて使用する前に、aliyun cms2 <command> [subcommand] --help を実行し、すべてのフラグと例を確認してください。 同じサブコマンドのヘルプを現在のセッション内ですでに確認しており、コマンドの形式に変更がない場合は、ヘルプを再度呼び出さず、その知識を再利用してください。名前付きサブコマンドの --help / --show-schema / --show-example-body は、そのコマンドのフラグ、本文のエンベロープ、レスポンスフィールド、環境動作に関する正規の情報源です。これらのフィールドを複製した別のスキルファイルを検索しないでください。

• トークン消費を抑えるため、-o text（デフォルト）を優先してください（list/get の場合）。-o json は、出力を読み取るのではなく、フィールドごとに解析する場合に限り使用してください。
• アドオンリリースの values：アドオンの values のデフォルトに従って、各フィールドの fieldPath をネストされた JSON に展開してください。ドット区切りの fieldPath を1つのリテラルキーとして記述しないでください。--env-type の選び方、create と update での子フィールドの配置場所、部分的な値が有効なリクエストボディとなる条件については、このセクションを参照してください。
• 変更コマンドおよび詳細コマンドにはリージョンパラメーターが必須です：モジュール固有のルールで別途指定されていない限り、すべての create、update、delete、および単一リソースを対象とする get／詳細コマンドには、リクエストを正しいバックエンドの OpenAPI エンドポイントにルーティングするため、--region パラメーターを必ず含めてください。これらのコマンドで --region を省略すると、ルーティングに失敗したり、意図しないリージョンを操作したりする可能性があります。また、エラーにまったく別の内容が表示されることもあります。たとえば、ワークスペースが存在し、リクエストボディが有効でも、integration policy create は status 400: The workspace can not be created を返します。このルールは、複数のリージョンを意図的にまたいで実行する list／クエリコマンド（例：全リージョンを対象とした entity query --source CloudResource）には適用されません。フラグが必須だからといって、その値を選んでよいわけではありません。リージョン確認ゲートに従って値を確定してください。
• 選択肢は1つの質問にまとめる：列挙された選択肢（リージョン、ワークスペース、ポリシー、アドオン、スコープモード、タグの一致モード、その他の相互排他的なパラメーター）はすべての選択肢を含む1つの質問として提示してください。質問を分割したり、「（続き）…」のような続きの質問にしたり、収まりきらない選択肢を省略したりしないでください。分割すると、1つの選択が互いに矛盾したり、未完了になったりする2つの回答に分かれ、選択肢を切り詰めると有効な選択肢が完全に隠れてしまいます。構造化された入力フォームですべての選択肢を表示できない場合は、プレーンテキストで質問し、質問文にすべての選択肢と説明を明記してください。相互排他的な選択肢は単一選択のままにし、本当に複数の値を指定できるもの（複数のリージョンなど）のみ複数選択にしてください。1つのプロンプトに複数の異なる選択を含めてもかまいませんが、それぞれ別の質問にしてください。推奨値は選択肢のラベル内に直接記載してください（例：(Recommended)）。推奨はあくまで参考であり、デフォルト値の使用が別のルールで認められているか、ユーザーが確認しない限り、クラウド側への書き込みは許可されません。
• 書き込みおよび影響の大きい作成には人間の確認が必要です：クラウド側の状態を作成または変更するコマンド（create、update、delete、patch、start、stop など）を実行する前に、簡潔な確認用の概要と正確なコマンドを提示し、実行を確認するかユーザーに尋ねて、明確な肯定の回答を待ってください。概要には、操作内容、対象リソースの識別子、想定される影響、および該当する場合は顕著なリスクや取り消せない影響を含めてください。定型句や長い確認文を求める必要はありません。「yes」「confirm」「proceed」「确认」など、明確な肯定の回答で承認されたものとします。ドライラン、プレビューのみ、またはクラウド側への影響がない読み取り相当の作成の場合に限り、確認を省略できます。不確かな場合は確認を必須としてください。
• 不確かなパラメーターの値は、ユーザーに明示的に回答してもらう必要があります：値が明示されていない、または確実に特定できないパラメーター（例：region／regionId、ワークスペース、ポリシー、resourceGroup、タグ、リソーススコープ、addon／addonName、リソースタイプ、クラウド製品／サービス名、オンボーディング設定オプションなど）がある場合は、処理を進める前にユーザーに明確な回答を求めてください。値を捏造したり、推測したり、デフォルト値や履歴から推定したり、任意に選択したりしてはいけません。モジュール固有のリファレンスで限定的な例外が定められている場合があります。integration モジュールの例外はreferences/integration-common.mdに記載されています。既存のアドオンリリースの設定変更は、事前に手順を確認できない書き込み操作です。アドオンリリース設定の更新に従ってください。
• 検索結果は回答ではありません：読み取りコマンド（workspace list、entity query、policy list、sts get-caller-identity など）は、提示する候補の一覧を作成するだけです。その出力は、候補が1つだけの場合、命名規則から値を導き出せる場合、またはセッションの前のターンでその値を使用した場合であっても、ユーザーの回答にはなりません。「確実に特定できる」とは、検索結果がたまたま曖昧でなかったという意味ではなく、ユーザー自身の発言またはユーザーが指定したリソースによって値が特定されていることを意味します。
• 名前から ID への照合は完全一致が必要です：リージョン ID、ワークスペース ID、integration ポリシー ID、リソースグループ ID、リソースタイプの値、またはクラウド製品／サービス名・コードを名前から検索する際、検索結果に完全一致するものがなければ、代わりに任意の値を暗黙に選択しないでください。不一致をユーザーに報告し、正しい値の確認または提示を求めてください。

リージョン確認ゲート（必須要件）

すべてのモジュール、および --region または region／regionId のボディフィールドを受け取るすべてのコマンドに適用されます。ワークスペースの確認はリージョンごとに行われるため、ワークスペースより先にリージョンを確定してください。

モジュールのルールで全リージョン対象とされている場合に限り、一覧／クエリコマンドでは --region を省略できます。フラグを省略しても、全リージョン対象にはなりません。CLI がプロファイルのデフォルト値を指定します。変更系コマンドと詳細コマンドには、リージョンパラメーターは必須に従って必ず指定してください。

値の正当な取得元は、次の3つに限られます。

1. ユーザーが現在のリクエストで指定した値。現在のセッション内であっても、以前の無関係なターンで指定された値は含みません。
2. 提示した候補リストからユーザーが選び、次のコマンドを実行する前にその回答を待った値。
3. ホストがランタイムコンテキストとして注入した値（コンソールセッションの現在のリージョン）。使用する前に、操作対象のリージョンを伝えてください。

これ以外はすべて違反です。以下を含みます：CLI プロファイル／aliyun configure／ALIYUN_REGION のデフォルト値、必須の --region の省略、ドキュメントや例にある cn-hangzhou、説明文でのみ指定されたリージョン、default-cms-{userId}-{regionId}（または任意のワークスペース名）の分解、controlRegionId の指定。

モジュールによっては、ユーザーがすでに確認したリソース（名前を指定したクラスター、このゲートを通過済みのワークスペース、インスタンス）の regionId を --region に設定できます。これは引き続き情報源1または2に該当します。モジュールの参照情報によって、このルールが緩和されることはありません。

情報源1と2がない場合は、選択肢は1つ、質問も1つに従ってリージョンを選択肢として提示し、そこで止めてください。候補は aliyun cms2 meta regions で取得し、すべての regionId を提示してください（showName や controlRegionId は使用しません）。取得した結果をそのまま消費するだけでは不十分です。情報源3がある場合は、推奨候補としてのみ扱います。呼び出し先を決めるものであり、対象範囲を決定するものではありません。オンボーディングにおけるリージョンの対象範囲はリソーススコープ選択ゲートで収集します。ここでリージョンについて再度質問しないでください。

controlRegionId はコントロールプレーンのリージョンであり、専用／独占ロケーションでは異なる場合があります。--region に指定しないでください。

ワークスペース確認ゲート（必須要件）

すべてのモジュール、および --workspace または workspace のボディフィールドを受け取るすべてのコマンドに適用されます。値の正当な取得元は、次の3つに限られます。

1. ユーザーが現在の会話で指定した値。対象リージョン内で workspaceName が完全一致することを確認してください。完全一致が見つからない場合は、その旨を伝えて質問し、近似した候補に置き換えてはいけません。
2. 提示した候補リストからユーザーが選び、次のコマンドを実行する前にその回答を待った値。
3. 環境がランタイムコンテキストとして提供した値（例：スキルが実行されているコンソールセッションのワークスペース）。そのリージョンが対象リージョンと一致している必要があります。使用する前に、操作対象のワークスペースを伝えてください。

これ以外はすべて違反です。たとえば、aliyun cms2 workspace list が返した唯一の行を採用すること、アカウントのデフォルトらしく見えるという理由で default-cms-{userId}-{regionId} のエントリを選ぶこと、aliyun sts get-caller-identity とリージョンからその名前を組み立てること、同じセッション内の以前の無関係なリクエストで使ったワークスペースを再利用することは違反です。

候補の取得方法としては、引き続き aliyun cms2 workspace list が適切です。取得した結果を提示せず、そのまま消費することだけが誤りです。選択肢は1つ、質問も1つに従い、最適な候補に (Recommended) を付けて選択肢として提示し、その後は回答を待ってください。

モジュールの参照情報によって、このルールが緩和されることはありません。ワークスペースの「デフォルト形式」として default-cms-{userId}-{regionId} を示している場合や、アカウント ID とリージョンから組み立てている場合は、アカウントのデフォルトワークスペースの名前を説明しているにすぎません。質問を省略する許可ではなく、推奨候補として提示してください。

ページネーションとクエリ失敗の処理

• 最後までページネーションする：--next-token に対応するすべての list コマンドでは、nextToken がなくなるか、累積件数が totalCount 以上になるまでクエリを続けてください。ページネーションのメタデータが続きのデータがあることを示している場合、最初のページだけで完全だと判断しないでください。
• ページネーション対応の list でのページサイズ：コマンドが --max-results を受け付ける場合は 100 を指定し、その後、最後までページネーションしてください。このドキュメントの指示は --help より優先されます：フラグを省略した場合のデフォルト値に頼らないでください。policy list --help では 30（最大 100）と表示されていますが、省略すると maxResults: 100 が返されることがあります。prometheus instance list の省略時のデフォルトは 30 です。20 ページ × 30 件では、大量のリストが途中で切り捨てられる可能性があります。
• 累積件数が totalCount 以上：nextToken が空でなくても、または truncated=true でも、処理を終了してください。totalCount のほうがより確実な指標です。
• totalCount を満たした後の空ページ：nextToken がある場合でも、処理を終了してください。
• トークンのループ防止：確認済みのトークンを記録してください。重複した場合は処理を終了し、結果が部分的であることを報告してください。
• ページ数の上限：デフォルトは 20 ページです。上限に達した場合は、結果が部分的であることを報告してください。
• 結果の切り捨て：部分的な結果から、対象が存在しないと結論付けないでください。フィルター（--search、--query、--policy-name など）を使うか、ページネーションを最後まで行ってください。
• 一時的なクエリ失敗：一時的なサーバー側エラー（DEADLINE_EXCEEDED、タイムアウト）が発生した場合は、一度だけ再試行してください。それでも失敗する場合は Unknown／QueryFailed とし、正常とも異常とも判断しないでください。

エラー処理

エラーコードと対処方法は aliyun cms2 --help に記載されています。追加のヒント：

• InvalidJSON は通常、--body の形式が正しくないことを意味します。CLI に渡す前に jq . <<<'<value>' で検証してください。
• --body and stdin are mutually exclusive; specify only one は、--body（または --file）と stdin の両方にデータが指定されたことを意味します。対処方法：入力元を 1 つだけ残してください。stdin がパイプになっている可能性のあるエージェント／CI 環境では、コマンドに < /dev/null を追加して stdin を空にしてください。

出力言語と用語

• ユーザー向けの説明、分析、推奨事項、要約、結論は、ユーザーの言語で記述してください。その言語が不明確または混在している場合は、デフォルトで簡体字中国語を使用してください。会話の途中で言語が切り替わった場合は、その時点以降は切り替え後の言語に従い、出力言語に関する明示的な指示がある場合は、どちらよりもその指示を優先してください。
• 質問のプロンプト、選択肢のラベル、表の見出し、レポートもユーザー向けのテキストです。参照ファイルに別の言語で記載されていても、回答の言語で表現してください。
• CLI コマンド名、フラグ、API パス、JSON フィールド名、列挙値、リソース ID、メトリクス名、ログ／エラーメッセージは、回答の言語にかかわらず、英語／コードのまま変更しないでください。
• 英語で回答する場合は、同義語を独自に作らず、用語集の英語欄を標準用語として使用してください。
• 中国語で回答する場合は、すべての説明文で用語集の中国語の用語を使用し、対応する用語を英語のまま残さないでください。区別が必要な場合に限り、初出時に 中文（English） と表記し、以降は中国語の用語だけを使用してください。送信前に対応する英語の用語が残っていないか確認し、コード、コマンド、JSON フィールド、ID、引用された CLI 出力内にあるものを除いて置き換えてください。

例（中国語で回答する場合）：

• 良い例：接入配置（AddonRelease，CLI 命令为 addon-release）
• 良い例：查询接入配置状态：aliyun cms2 integration addon-release list ...
• 悪い例：all releases are Ready
• より良い例：所有接入配置均 Ready

用語集

英語	中国語
Cloud Monitor / CMS	クラウドモニタリング
Workspace	ワークスペース
Application Monitoring / APM	アプリケーションモニタリング
RUM	ユーザーエクスペリエンスモニタリング
Synthetic Monitoring / Synthetic	クラウドプローブ
CloudResource	クラウドリソース
EntityStore	エンティティリポジトリ
Entity	エンティティ
Integration Policy / policy	インテグレーションポリシー
Addon / addon	コンポーネント
Addon Catalog	コンポーネントカタログ
AddonRelease / addon release / release	インテグレーション設定
Collector	コレクター
Prometheus View	Prometheus 集約ビュー
AggTaskGroup	集約タスク
Delivery Task	データ配信タスク
Alert Rule	アラートルール
Alert Template	アラートテンプレート
Alert History	アラート履歴
Notification Channel	通知チャネル
Contact	連絡先
Event Hub	イベントセンター
Metric Meta	メトリクスメタデータ
ClusterCollector	クラスターコレクター
NodeCollector	ノードコレクター
Cluster probe	クラスタープローブ
Metric drop	メトリクスの廃止
CMS resource tag	CMS リソースタグ
Grafana workspace	Grafanaワークスペース

メタデータクエリのマッピング

必要な情報	取得方法
メトリクスのビジネスメタデータ（meta namespaces による名前空間と製品コード、meta metrics によるメトリクス名、タイプ、単位、ディメンション）	meta namespaces / meta metrics
Prometheus のラベル、値、系列の確認	metric promql labels / label-values / series

インテグレーションモジュールの検索（リソースメタデータ、オンボーディング状況、ポリシーにスコープされた Kubernetes リソース、ポリシーごとの Prometheus インスタンス）については、references/integration-common.md を参照してください。

モジュールのルーティング

ユーザーの意図を示すキーワード	コマンド	モジュール
オンボーディング、モニタリングアドオン、ポリシー、インテグレーション、アドオンのリリース、インテグレーションリソース、Kubernetes リソース一覧、ポリシー配下の Namespace リソース、ポリシーで管理されるリソース、ティアダウン、オフボーディング — すべてのオンボーディング操作で読み込む共通ルール	integration integration resource	references/integration-common.md
コンテナーのオンボーディング、ACK/ACS/ASI クラスターのオンボーディング、クラスター群の監査、オンボーディングされていないクラスターの確認	integration entity query	references/cs-onboarding.md (+ integration-common.md)
ECS ホストのオンボーディング、ECS 群の監査、NodeCollector	integration entity query	references/ecs-onboarding.md (+ integration-common.md)
クラウドサービスのオンボーディング、RDS/SLB/ALB/Redis/MongoDB/PolarDB のオンボーディング、クラウドリソース群の監査	integration entity query	references/cloud-onboarding.md (+ integration-common.md)
クラウドサービスメトリクスの一括オンボーディング、一括オンボーディング、cloud-batch-metrics	integration meta entity query	references/batch-onboarding-workflow.md (+ integration-common.md)
インテグレーションポリシーの診断、ヘルスチェック、ポリシーのトラブルシューティング、スクレイプ設定、ServiceMonitor/PodMonitor/カスタム収集の診断、custom-discover-<id>（リリース名 — カスタムジョブとして扱う前に discoverType を確認してください）、ジョブターゲット	integration check-scrape-config integration job-target integration check-collector-target integration resource integration dashboard	references/integration-diagnosis.md
メトリクスのドロップ、メトリクスをドロップ、dropMetrics、指標废弃、丢弃指标、废弃指标、クラスターのプローブ metric-agent	integration collector integration addon-release	references/integration-management.md (+ integration-common.md)
CMS リソースタグの追加／変更／削除、打标签、修改标签、删除标签、CMS リソースタグ、アプリケーションサービス（APM/RUM）のタグ	tag	references/integration-management.md (+ integration-common.md)
Prometheus ビュー、Prometheus 集約ビュー、Prometheus 集約ビューの作成、Prometheus ビューの作成、Prometheus 集約ビューの診断、Prometheus 集約ビューのヘルスチェック、サブインスタンスのステータス	prometheus view	references/prometheus-management.md
ワークスペース、ワークスペースの作成、ワークスペースの取得、ワークスペースの一覧表示、ワークスペースの更新、ワークスペースの削除	workspace	aliyun cms2 workspace --help
エンティティ、エンティティのクエリ、CloudResource、EntityStore、クラウドリソースのクエリ、エンティティストアのクエリ、リソースメタデータ、インスタンスの詳細	entity query	aliyun cms2 entity --help
Prometheus インスタンス、recordingRule、レコーディングルール、AggTaskGroup	prometheus instance prometheus recording-rule	aliyun cms2 prometheus --help
メタ、メトリクスメタデータ、プロダクトコード、meta-format	meta metrics meta namespaces	aliyun cms2 meta --help
メトリクス、メトリクスのクエリ、基本メトリクス、PromQL、promql クエリ、ラベル値、系列	metric basic metric promql	aliyun cms2 metric --help
アラート、ルール、アラートルール、アラートテンプレート、アラート履歴、パッチ、ルールの作成、ルールの管理	alert rule alert template alert history	references/alerting.md
APM measureCode、group/filter/groupBy、baseUnit/displayUnit	alert rule（APM タイプ）	references/apm-metrics.md
UModel metricSet、K8s ポッドメトリクス、エンティティベースのアラート	alert rule（UModel タイプ）	references/umodel-metrics.md
通知、連絡先、ロボット、webhook、通知先、dingTalk、ボット、lark、weChat work	notification-channel contact notification-channel robot notification-channel webhook	references/alerting.md
イベント、event-hub、アラートイベント、SLS イベント、インシデント	event-hub	references/event-hub.md
Grafana、Grafana ワークスペース、マネージド Grafana インスタンス、Grafana ワークスペースの作成／クエリ／更新／削除	grafana workspace	aliyun cms2 grafana workspace --help
Grafana ダッシュボードの作成、ダッシュボード JSON、パネル、PromQL パネル、ダッシュボード変数、データソースのプレースホルダー	meta metrics metric promql integration storage	references/grafana-dashboard-rules.md
APM、アプリケーションモニタリング、エージェントのインストール、Java エージェント、Golang エージェント、Python エージェント、Node.js エージェント、PHP エージェント、.NET エージェント、ack-onepilot、OpenTelemetry のオンボーディング、K8s/ACK/ACS コンテナーのオンボーディング、ECS ホストアプリケーションのオンボーディング、LicenseKey、独自エージェント、instgo、aliyun-bootstrap、プローブのセットアップ、APM のオンボーディング	apm service apm configuration	references/apm.md
AI オブザーバビリティ、Dify、LangChain、LangGraph、DashScope、AgentScope、OpenAI、Coze、OpenClaw、CoPaw、Hermes、LLM モニタリング、AI トレーシング、AI エージェントのモニタリング、カスタム計装	apm service apm configuration integration addon	references/ai.md
RUM、Real User Monitoring、User Experience Monitoring、フロントエンドモニタリング、ウェブモニタリング、H5、モバイルアプリモニタリング、Android クラッシュ、iOS クラッシュ、JS エラー、ページパフォーマンス、ミニアプリモニタリング、RUM アプリの作成、RUM SDK、pid、serviceId、endpoint	rum service rum configuration	references/rum.md
リソースグループのクエリ	resource-group	aliyun cms2 resource-group --help
上記に記載されていないコマンドについては、aliyun cms2 --help を参照してください。