glpi-admin

使用場面

• インベントリダッシュボードのサマリー取得(資産タイプ別の合計)
• 有効期限切れ間近の証明書、ドメイン、ライセンス、保証、契約の確認
• 予約アイテムの追跡
• 管理上の設定クエリ
• エンティティまたは状態別のグループ化されたレポート
• アラート駆動ワークフロー(有効期限監視)

重要なパターン

glpi_summary はダッシュボード概要を提供

glpi_summary ツールはアイテム数をitemtypeでグループ化して返します。これを管理タスクの出発点として使用してください。各タイプを個別にクエリしなくても、インベントリに何があるかが明らかになります。

有効期限追跡は単一のツール呼び出し

glpi_expiration_tracker(days_ahead=N) を使用して、Certificate、Domain、Contract、SoftwareLicense、ハードウェア保証全体で有効期限切れ間近のすべてのアイテムを一度に確認できます。複数のクエリを手動で構成する必要はありません。

エンティティ別のサマリーはフィルタリングが必要

エンティティごとのサマリーを取得するには、各itemtypeに対するエンティティ基準で glpi_search を使用するか、関連データで glpi_get を Entity に使用します。

ツールリファレンス

コマンド

# インベントリダッシュボードを取得
glpi_summary()

# 証明書のフィールドを検出
glpi_list_fields(itemtype="Certificate")

# 有効期限切れ間近の証明書を検索
glpi_search(itemtype="Certificate", criteria=[{"field_name":"Certificate.date_expiration","searchtype":"less","value":"2026-06-30"}])

# ドメインのフィールドを検出
glpi_list_fields(itemtype="Domain")

# 有効期限切れ間近のドメインを検索
glpi_search(itemtype="Domain", criteria=[{"field_name":"Domain.date_expiration","searchtype":"less","value":"2026-12-31"}])

# 予約アイテムを検索
glpi_search(itemtype="ReservationItem", criteria=[{"field_name":"ReservationItem.is_active","searchtype":"equals","value":"1"}])

# エンティティの詳細を取得
glpi_get(itemtype="Entity", id=1)

# 証明書エントリを作成
glpi_create(itemtype="Certificate", data={"name":"*.example.com","serial":"ABC123","date_expiration":"2027-01-15"})

# 管理タイプ全体でグローバル検索
glpi_global_search(query="expiring", itemtypes=["Certificate","Domain","SoftwareLicense","Contract"])

# 今後90日以内の有効期限切れ間近のすべてのアイテムをチェック
glpi_expiration_tracker(days_ahead=90)

# 特定のエンティティの有効期限切れ間近のアイテムをチェック
glpi_expiration_tracker(days_ahead=30, entity_id=5)