alibabacloud-hologres-instance-manage

Name: alibabacloud-hologres-instance-manage
Author: aliyun

github.com/aliyunクラウド・DevOps281222 回インストール1 日前に更新

リポジトリ

alibabacloud-hologres-instance-manage について

Aliyun CLIを使って Alibaba Cloud Hologres のインスタンスを参照する読み取り専用スキルです。インスタンス一覧や詳細が必要な利用者向けに、認証情報とパラメーターの確認、RAM権限への対応を重視します。

主な機能

01Hologres インスタンスの一覧表示
02指定インスタンスの詳細取得
03リソースグループやタグによる絞り込み
04ステータス、仕様、エンドポイントの確認
05実行前の認証情報とパラメーター確認

活用シーン

01リージョン内の Hologres インスタンスの棚卸し
02ステータス、CPU、メモリ、ストレージの確認
03ネットワークエンドポイントと SSL 状態の確認
04リソースグループやタグで検索範囲を限定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/aliyun/alibabacloud-aiops-skills --skill alibabacloud-hologres-instance-manage

インストール後、Claude Code で/alibabacloud-hologres-instance-manageを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/

acceptance-criteria.md

cli-installation-guide.md

ram-policies.md

related-commands.md

verification-method.md

詳細

Hologres インスタンス管理

Alibaba Cloud Hologres インスタンスを管理するスキルです。すべてのインスタンスを一覧表示し、インスタンスの詳細を取得します。

アーキテクチャ

User → Aliyun CLI → Hologres API (hologram) → Instance List / Instance Details

インストール

事前確認：Aliyun CLI 3.3.3 以上が必要です

aliyun version を実行して、3.3.3 以上であることを確認してください。未インストールの場合、またはバージョンが古い場合は、 curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash を実行して更新するか、インストール手順については references/cli-installation-guide.md を参照してください。

事前確認：Aliyun CLI プラグインの更新が必要です

[必須] aliyun configure set --auto-plugin-install true を実行して、プラグインの自動インストールを有効にしてください。 [必須] aliyun plugin update を実行して、既存のプラグインを常に最新の状態にしてください。

curl -fsSL --connect-timeout 4 --max-time 120 https://aliyuncli.alicdn.com/setup.sh | bash
aliyun version

[必須] CLI User-Agent — aliyun CLI のすべてのコマンド実行には、次を含める必要があります： --user-agent AlibabaCloud-Agent-Skills/alibabacloud-hologres-instance-manage

認証

このスキルは Alibaba Cloud のデフォルト認証情報チェーンを使用します。AK/SK の値を読み取ったり、表示したり、明示的に扱ったりすることはありません。

セキュリティルール：

AK/SK の値を読み取ったり、エコーしたり、表示したりすることは絶対にしないでください

ユーザーに AK/SK を直接入力するよう求めることは絶対にしないでください

リテラルの認証情報を指定して aliyun configure set を使用することは絶対にしないでください

認証情報の状態を確認するには、aliyun configure list のみを使用してください

aliyun configure list

有効なプロファイル（AK、STS、EcsRamRole、または RamRoleArn）があることを出力で確認してください。

有効なプロファイルがない場合は、ここで停止してください。 ユーザーはこのセッションの外で認証情報を設定し、aliyun configure list に有効なプロファイルが表示されてから戻る必要があります。

RAM ポリシー

このスキルには、次の RAM 権限が必要です。

製品	RAM アクション	リソース範囲	説明
Hologram	hologram:ListInstances	`acs:hologram:{#regionId}:{#accountId}:instance/*`	すべての Hologres インスタンスを一覧表示
Hologram	hologram:GetInstance	`acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}`	インスタンスの詳細を取得

完全な RAM ポリシーについては、references/ram-policies.md を参照してください。

[必須] 権限エラーへの対応： 実行中のいずれかの時点で、コマンドまたは API 呼び出しが権限エラーにより失敗した場合は、次の手順に従ってください。

references/ram-policies.md を読み、この SKILL に必要な権限の全リストを確認します

ram-permission-diagnose スキルを使用して、必要な権限の申請をユーザーに案内します

必要な権限が付与されたことをユーザーが確認するまで待機します

パラメーターの確認

重要：パラメーターの確認 — コマンドまたは API 呼び出しを実行する前に、ユーザーがカスタマイズ可能なすべてのパラメーター（例：RegionId、インスタンス名、リソースグループ ID、タグなど）をユーザーに確認する必要があります。明示的な承認なしに、値を推測したりデフォルト値を使用したりしないでください。

パラメーター名	必須／任意	説明	デフォルト値
RegionId	任意	インスタンスが配置されているリージョン	ユーザーのデフォルトリージョン
InstanceId	必須（GetInstance の場合）	Hologres インスタンスの ID	なし
resourceGroupId	任意	リソースグループ ID で絞り込み	なし
tag	任意	タグ（キーと値のペア）で絞り込み	なし
cmsInstanceType	任意	Cloud Monitor インスタンスタイプ（standard/follower/mc-acceleration/warehouse/high-memory/serverless）	なし

コアワークフロー

タスク 1：すべての Hologres インスタンスを一覧表示する

指定されたリージョンにあるすべての Hologres インスタンスを照会します。

# List all instances
aliyun hologram POST /api/v1/instances \
  --header "Content-Type=application/json" --body "{}" \
  --read-timeout 4 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-hologres-instance-manage

# List instances with resource group filter
aliyun hologram POST /api/v1/instances \
  --header "Content-Type=application/json" \
  --body '{"resourceGroupId":"rg-acfmvscak73zmby"}' \
  --read-timeout 4 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-hologres-instance-manage

# List instances with tag filter
aliyun hologram POST /api/v1/instances \
  --header "Content-Type=application/json" \
  --body '{"tag":[{"key":"env","value":"production"}]}' \
  --read-timeout 4 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-hologres-instance-manage

# List instances by CMS instance type
aliyun hologram POST /api/v1/instances \
  --header "Content-Type=application/json" \
  --body '{"cmsInstanceType":"standard"}' \
  --read-timeout 4 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-hologres-instance-manage

レスポンスフィールド：

InstanceId：インスタンス ID
InstanceName：インスタンス名
InstanceStatus：ステータス（Creating/Running/Suspended/Allocating）
InstanceType：タイプ（Warehouse/Follower/Standard/Serverless/Shared）
InstanceChargeType：支払いタイプ（PostPaid/PrePaid）
RegionId：リージョン ID
Endpoints：ネットワークエンドポイントの一覧

タスク 2：インスタンスの詳細情報を取得する

特定の Hologres インスタンスに関する詳細情報を取得します。

# Get instance details by ID
aliyun hologram GET /api/v1/instances/{instanceId} \
  --read-timeout 4 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-hologres-instance-manage

# Example with actual instance ID
aliyun hologram GET /api/v1/instances/hgprecn-cn-i7m2v08uu00a \
  --read-timeout 4 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-hologres-instance-manage

レスポンスフィールド：

InstanceId：インスタンス ID
InstanceName：インスタンス名（2～64 文字）
InstanceStatus：ステータス（Creating/Running/Suspended/Allocating）
InstanceType：タイプ（Warehouse/Follower/Standard/Serverless/Shared）
InstanceChargeType：支払いタイプ（PostPaid/PrePaid）
Cpu：CPU コア数
Memory：メモリ（GB）
Disk：標準ストレージ容量（GB）
ColdStorage：コールドストレージ容量（GB）
Version：インスタンスのバージョン
Endpoints：VPC/インターネット/イントラネットの詳細を含むネットワークエンドポイント
AutoRenewal：自動更新が有効かどうか
EnableHiveAccess：データレイクアクセラレーションが有効かどうか
EnableServerless：サーバーレスコンピューティングが有効かどうか
EnableSSL：SSL が有効かどうか
StorageType：ストレージタイプ（冗長/ローカル）

成功の確認方法

詳しい確認手順については、references/verification-method.md を参照してください。

簡易確認

# Verify ListInstances
aliyun hologram POST /api/v1/instances \
  --header "Content-Type=application/json" --body "{}" \
  --read-timeout 4 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-hologres-instance-manage | jq '.InstanceList'

# Verify GetInstance
aliyun hologram GET /api/v1/instances/{your-instance-id} \
  --read-timeout 4 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-hologres-instance-manage | jq '.Instance.InstanceStatus'

成功を示す条件：

HTTP ステータスコードが 200
Success フィールドが true
InstanceList または Instance フィールドに有効なデータが含まれている

クリーンアップ

このスキルは読み取り専用の操作を行います。クリーンアップは不要です。

コマンド一覧

CLI コマンドの一覧については、references/related-commands.md を参照してください。

操作	CLI コマンド	説明
インスタンス一覧の取得	`aliyun hologram POST /api/v1/instances --read-timeout 4 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-hologres-instance-manage`	すべての Hologres インスタンスの一覧を取得します
インスタンスの取得	`aliyun hologram GET /api/v1/instances/{instanceId} --read-timeout 4 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-hologres-instance-manage`	特定のインスタンスの詳細情報を取得します

ベストプラクティス

コマンドを実行する前に、aliyun configure list を使用して必ず認証情報を確認してください
多数のインスタンスを一覧表示する場合は、フィルター（resourceGroupId、tags）を使用して結果を絞り込んでください
操作を行う前にインスタンスのステータスを確認してください。インスタンスが Running 状態であることを確認します
適切なネットワークエンドポイントを使用してください。内部アクセスには VPCSingleTunnel、外部アクセスには Internet を選択します
インスタンスの有効期限を監視してください。サービスの中断を避けるため、PrePaid インスタンスの ExpirationTime を確認します
安全な接続を確保するため、本番環境ではSSL を有効にしてください

参考リンク

参考資料	説明
references/cli-installation-guide.md	Aliyun CLI のインストールガイド
references/ram-policies.md	必要な RAM 権限
references/related-commands.md	CLI コマンドの一覧
references/verification-method.md	成功の確認手順
Hologres API Documentation	公式 API ドキュメント

エラー処理

HTTP ステータス	エラーコード	エラーメッセージ	解決方法
403	NoPermission	RAM ユーザーの権限が不足しています	`AliyunHologresReadOnlyAccess` 権限を付与してください
400	InvalidParameter	パラメーター値が無効です	パラメーターの形式と制約を確認してください
404	InstanceNotFound	インスタンスが存在しません	インスタンス ID が正しいことを確認してください

その他のエラーコードについては、Hologres Error Center を参照してください。

Markdown 対応

ログインしてコメント

基本情報

作者: aliyun
リポジトリ: aliyun/alibabacloud-aiops-skills
カテゴリ: クラウド・DevOps
インストール数: 222
GitHub スター: 281

問題を報告

おすすめの Skills

すべての Skills

lark-apps

open.feishu.cn

732.0k

Miaoda（Spark/Miaoda）アプリの開発とホスティング：アプリの作成、ローカルでのフルスタック開発、クラウドでの生成と反復、クリエイティブデザイン（UI モックアップ／インタラクティブなプロトタイプ／ワイヤーフレーム／ランディングページ／ダッシュボード／スライドデッキ／ビジュアル探索）、AI 関連機能や Feishu プラットフォーム機能、その他の外部機能との統合、ログ／Trace／監視指標／PV／UV の確認、環境変数の管理、アプリのコラボレーターと共同作業権限の設定、アプリのロールとメンバーの管理、自動化トリガー（スケジュール／レコード変更／Webhook／Feishu 承認）。システム・ツール・プラットフォーム・アプリの開発や新規作成、ローカル／クラウドでの開発、変更、デプロイ、公開、リリース、共有可能なリンクの取得、HTML によるページやウェブサイトの作成と Miaoda へのデプロイ、デザイン／モックアップ／プロトタイプ／ワイヤーフレーム／PPT／デッキ／ビジュアル探索を希望する場合に使用。また、Miaoda/Spark/Miaoda アプリ（`/app/app_xxx` または `/page/<token>` 形式のリンク、*.aiforce.cloud 形式の実行時ドメイン）、アプリデータベース、アプリファイルストレージ、公開 API Key、公開範囲、アプリのコラボレーター／開発権限、アプリのロール／ロールメンバー、本番ログ、API リクエスト数、エラー数、レイテンシ、アクセス数、環境変数、Miaoda アプリの自動化タスク／スケジュールトリガー／承認後の自動トリガーに関する場合にも使用。通常のクラウドドライブへのファイルアップロード（lark-drive）、Feishu ドキュメントの編集（lark-doc）、ネイティブのスライド作成（lark-slides）は対象外。

azure-prepare

github.com/microsoft

571.7k

azd ベースの Azure プロジェクトをデプロイ用に準備します。Azure Developer CLI (azd) ワークフロー向けに azure.yaml、インフラストラクチャ (Bicep/Terraform)、Dockerfile を生成します。ユーザーが明示的に azd をデプロイメントツールとして使いたい場合、または既に azure.yaml ファイルが存在する場合にのみ使用してください。非 azd デプロイメント、Python App Service コードのみのデプロイ (python-appservice-deploy を使用)、クラウド間の移行 (azure-cloud-migrate を使用) には使用しないでください。用途：azd 用にアプリを準備、azure.yaml を作成、azd インフラストラクチャを設定、Azure 上でアプリを最新化、azd でデプロイ、関数アプリ、タイマートリガー、Service Bus トリガー、イベント駆動関数、マネージド ID、Bicep を生成、Terraform を生成、Azure に作成してデプロイ。

wizard

github.com/mattpocock

571.5k

人間にしか実行できない手順を案内する、対話型の bash ウィザードを生成します。インフラのプロビジョニング、認証情報や CI シークレットの設定、不慣れなサードパーティ製ダッシュボードの操作、一度限りの移行や切り替えに使用します。エージェント自身が実行できる手順には使用しません。

azure-ai

github.com/microsoft

571.2k

Azure AI（検索、音声、OpenAI、Document Intelligence）で使用します。検索、ベクトル/ハイブリッド検索、音声テキスト変換、テキスト音声変換、トランスクリプション、OCR に対応。用途：AI 検索、クエリ検索、ベクトル検索、ハイブリッド検索、セマンティック検索、音声テキスト変換、テキスト音声変換、トランスクリプション、OCR、テキストを音声に変換。