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_search	証明書、ドメイン、予約、またはあらゆるitemtypeを検索
glpi_get	証明書、ドメイン、エンティティの詳細情報を取得
glpi_list_fields	Certificate、Domain、ReservationItemのフィールドを検出
glpi_global_search	管理タイプ全体を一度に検索
glpi_create	証明書、ドメイン、予約エントリを作成
glpi_update	管理アイテムを更新
glpi_update_by_name	完全一致する名前でアイテムを更新
glpi_expiration_tracker	複数のitemtype全体で有効期限切れ間近のアイテムを確認
glpi_cost_summary	資産、契約、予算全体でコスト集計を取得

コマンド

# インベントリダッシュボードを取得
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)