Private Service Connect のヘルス構成の表示、更新、削除

このページでは、Private Service Connect のヘルス リソースを作成した後に管理する方法について説明します。ヘルス集約ポリシー、ヘルスソース、複合ヘルスチェックの一覧表示、説明、更新、削除を行うことができます。

ヘルス集計ポリシーを管理する

このセクションでは、ヘルス集計ポリシーの管理方法について説明します。

ヘルス集計ポリシーを一覧表示する

リージョン内のすべてのヘルス集計ポリシーを一覧表示できます。

gcloud

gcloud beta compute health-aggregation-policies list コマンドを使用します。

gcloud beta compute health-aggregation-policies list \
    --regions=REGION

REGION は、ヘルス集約ポリシーのリージョンに置き換えます。

ヘルス集計ポリシーの説明を取得する

ヘルス集計ポリシーの説明を取得して、その詳細を表示できます。

gcloud

gcloud beta compute health-aggregation-policies describe コマンドを使用します。

gcloud beta compute health-aggregation-policies describe POLICY \
    --region=REGION

次のように置き換えます。

  • POLICY: ヘルス集約ポリシーの名前
  • REGION: ヘルス集約ポリシーのリージョン

ヘルス集計ポリシーを更新する

ヘルス集計ポリシーの説明、正常な割合のしきい値、正常な最小しきい値は更新できます。

gcloud

gcloud beta compute health-aggregation-policies update コマンドを使用します。

gcloud beta compute health-aggregation-policies update POLICY \
    --region=REGION \
    --description="DESCRIPTION" \
    --healthy-percent-threshold=PERCENT_HEALTHY \
    --min-healthy-threshold=MINIMUM_HEALTHY

次のように置き換えます。

  • POLICY: 更新するヘルス集約ポリシーの名前
  • REGION: ヘルス集約ポリシーのリージョン
  • DESCRIPTION: ポリシーの更新された説明
  • PERCENT_HEALTHY: ヘルスソースが正常と見なされるために正常である必要があるバックエンド サービス内のエンドポイントの最小割合の更新値（例: 75）
  • MINIMUM_HEALTHY: ヘルスソースが正常と見なされるために正常である必要があるバックエンド サービス内のエンドポイントの最小数（例: 2）

ヘルス集計ポリシーを削除する

ヘルス集約ポリシーは、既存のヘルスソースに関連付けられていない場合に削除できます。

gcloud

gcloud beta compute health-aggregation-policies delete コマンドを使用します。

gcloud beta compute health-aggregation-policies delete POLICY \
    --region=REGION

次のように置き換えます。

  • POLICY: 削除するヘルス集約ポリシーの名前
  • REGION: ヘルス集約ポリシーのリージョン

健康に関する情報源を管理する

以降のセクションでは、健康状態のソースを管理する方法について説明します。

ヘルスソースを一覧表示する

リージョン内の健康データソースを一覧表示できます。

gcloud

gcloud beta compute health-sources list コマンドを使用します。

gcloud beta compute health-sources list \
    --regions=REGION

REGION は、ヘルスソースのリージョンに置き換えます。

ヘルスソースを説明する

ヘルスソースの説明を取得して、その詳細を表示できます。

gcloud

gcloud beta compute health-sources describe コマンドを使用します。

gcloud beta compute health-sources describe HEALTH_SOURCE \
    --region=REGION

次のように置き換えます。

  • HEALTH_SOURCE: ヘルスソースの名前
  • REGION: ヘルスソースのリージョン

医療 / 健康に関する情報源を更新する

既存のヘルスソースの説明、バックエンド サービス、ヘルス集約ポリシーを更新できます。

gcloud

gcloud beta compute health-sources update コマンドを使用します。

gcloud beta compute health-sources update HEALTH_SOURCE \
    --region=REGION \
    --description="DESCRIPTION" \
    --sources=BACKEND_SERVICE \
    --health-aggregation-policy=POLICY

次のように置き換えます。

  • HEALTH_SOURCE: 更新するヘルスソースの名前
  • REGION: ヘルスソースのリージョン
  • DESCRIPTION: ヘルスソースの更新された説明

  • BACKEND_SERVICE: ヘルスソースとして使用する更新されたバックエンド サービス

    バックエンド サービスは次の要件を満たす必要があります。

    • ロード バランシング スキームは INTERNAL または INTERNAL_MANAGED である必要があります。
    • 作成するヘルスソースと同じリージョンに存在する必要があります。
    • バックエンドは、タイプ GCE_VM_IP または GCE_VM_IP_PORT のインスタンス グループまたはネットワーク エンドポイント グループである必要があります。

  • POLICY: このヘルスソースに適用する更新されたヘルス集計ポリシー。

ヘルスソースを削除する

既存の複合ヘルスチェックに関連付けられていない場合は、ヘルスソースを削除できます。

gcloud

gcloud beta compute health-sources delete コマンドを使用します。

gcloud beta compute health-sources delete HEALTH_SOURCE \
    --region=REGION

次のように置き換えます。

  • HEALTH_SOURCE: 削除するヘルスソースの名前
  • REGION: ヘルスソースのリージョン

複合ヘルスチェックを管理する

以降のセクションでは、複合ヘルスチェックを管理する方法について説明します。

複合ヘルスチェックを一覧表示する

リージョン内の複合ヘルスチェックを一覧表示できます。

gcloud

リージョンの複合ヘルスチェックを一覧表示するには、gcloud beta compute composite-health-checks list コマンドを使用します。

gcloud beta compute composite-health-checks list \
    --regions=REGION

REGION は、複合ヘルスチェックのリージョンに置き換えます。

複合ヘルスチェックを記述する

複合ヘルスチェックの説明を取得して、その詳細を表示できます。

gcloud

gcloud beta compute composite-health-checks describe コマンドを使用します。

gcloud beta compute composite-health-checks describe COMPOSITE_HEALTH_CHECK \
    --region=REGION

次のように置き換えます。

  • COMPOSITE_HEALTH_CHECK: 複合ヘルスチェックの名前
  • REGION: 複合ヘルスチェックのリージョン

複合ヘルスチェックを更新する

複合ヘルスチェックの説明、ヘルスソース、ヘルス宛先を更新できます。

gcloud

gcloud beta compute composite-health-checks update コマンドを使用します。

gcloud beta compute composite-health-checks update COMPOSITE_HEALTH_CHECK \
    --region=REGION \
    --description="DESCRIPTION" \
    --health-sources=HEALTH_SOURCES \
    --health-destination=HEALTH_DESTINATION

次のように置き換えます。

  • COMPOSITE_HEALTH_CHECK: 更新する複合ヘルスチェックの名前
  • REGION: 複合ヘルスチェックのリージョン
  • DESCRIPTION: 更新された説明

  • HEALTH_SOURCES: 複合ヘルスチェックに関連付ける 1 つ以上のヘルスソースの名前

    複数のヘルスソースをカンマ区切りリストで指定できます。

  • HEALTH_DESTINATION: この複合ヘルスチェックから複合ヘルス状態を受け取る転送ルールの URI（例: projects/PROJECT_ID/regions/REGION/forwardingRules/FORWARDING_RULE）。

    転送ルールは、Private Service Connect ヘルスをサポートし、次の要件を満たすプロデューサー ロードバランサに関連付ける必要があります。

    • ロード バランシング スキームは INTERNAL または INTERNAL_MANAGED である必要があります。
    • 複合ヘルスチェックと同じリージョンに存在する必要があります。

複合ヘルスチェックを削除する

複合ヘルスチェックは削除できます。

gcloud

gcloud beta compute composite-health-checks delete コマンドを使用します。

gcloud beta compute composite-health-checks delete COMPOSITE_HEALTH_CHECK \
    --region=REGION

次のように置き換えます。

  • COMPOSITE_HEALTH_CHECK: 削除する複合ヘルスチェックの名前
  • REGION: 複合ヘルスチェックのリージョン