查看、更新及刪除複合健康資源

本頁說明如何管理您建立的複合健康狀態資源。您可以列出、說明、更新及刪除健康狀態匯總政策、健康來源和複合型健康狀態檢查。

管理健康狀態匯總政策

本節說明如何管理健康資料匯總政策。

列出健康狀態匯總政策

您可以列出已設定的健康狀態匯總政策。

控制台

  1. 前往 Google Cloud 控制台的「Composite Health」(綜合健康狀態) 頁面:

    前往「複合健康狀態」

  2. 按一下「健康狀態匯總政策」

gcloud

如要列出區域中的所有健康狀態匯總政策,請使用 gcloud compute health-aggregation-policies list 指令

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

REGION 替換為健康狀態匯總政策的區域。

API

如要列出區域中的所有健康狀態匯總政策,請向 regionHealthAggregationPolicies.list 方法發出要求。

HTTP 方法和網址:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthAggregationPolicies

更改下列內容:

  • PROJECT_ID:健康狀態匯總政策的專案 ID。
  • REGION:健康狀態匯總政策的區域。

描述健康狀態匯總政策

您可以描述健康狀態匯總政策,查看其詳細資料。

控制台

  1. 前往 Google Cloud 控制台的「Composite Health」(綜合健康狀態) 頁面:

    前往「複合健康狀態」

  2. 按一下「健康狀態匯總政策」

  3. 按一下要說明的健康狀態匯總政策名稱。

gcloud

使用 gcloud compute health-aggregation-policies describe 指令。

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

更改下列內容:

  • POLICY:健康狀態匯總政策名稱
  • REGION:健康狀態匯總政策的區域

API

regionHealthAggregationPolicies.get 方法傳送要求

HTTP 方法和網址:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthAggregationPolicies/POLICY

更改下列內容:

  • PROJECT_ID:健康狀態匯總政策的專案 ID。
  • REGION:健康狀態匯總政策的區域。
  • POLICY:健康狀態匯總政策的名稱。

更新健康狀態匯總政策

您可以更新健康狀態匯總政策的說明、健康狀態百分比門檻或健康狀態下限門檻。

控制台

  1. 前往 Google Cloud 控制台的「Composite Health」(綜合健康狀態) 頁面:

    前往「複合健康狀態」

  2. 按一下「健康狀態匯總政策」

  3. 按一下要更新的健康狀態匯總政策名稱。

  4. 按一下「Edit」(編輯)

  5. 更新要變更的欄位。

  6. 按一下 [儲存]

gcloud

使用 gcloud compute health-aggregation-policies update 指令。如不想更新屬性,請省略相關標記。

gcloud 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

API

  1. 說明健康狀態匯總政策,並記下 fingerprint 鍵的值,您會在下一個步驟中使用該值。

  2. regionHealthAggregationPolicies.patch 方法傳送要求。如不想更新房源的屬性,請省略相關欄位。

    HTTP 方法和網址:

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthAggregationPolicies/POLICY
    

    JSON 要求主體:

    {
      "description": "DESCRIPTION",
      "healthyPercentThreshold": PERCENT_HEALTHY,
      "minHealthyThreshold": MINIMUM_HEALTHY,
      "fingerprint": "FINGERPRINT"
    }
    

    更改下列內容:

    • PROJECT_ID:健康狀態匯總政策的專案 ID。
    • REGION:健康狀態匯總政策的區域。
    • POLICY:要更新的健康狀態匯總政策名稱。
    • DESCRIPTION:政策的更新說明。
    • PERCENT_HEALTHY:更新後,後端服務中健康狀態良好的端點必須達到這個百分比下限,健康狀態來源才能視為健康狀態良好,例如 75
    • MINIMUM_HEALTHY:後端服務中健康狀態良好的端點數量下限 (更新後),必須達到這個數量下限,健康狀態來源才能視為健康狀態良好,例如 2
    • FINGERPRINT:您在上一個步驟中找到的 fingerprint 鍵最新值。

刪除健康狀態匯總政策

如果健康狀態匯總政策未與現有健康狀態來源建立關聯,即可刪除。

控制台

  1. 前往 Google Cloud 控制台的「Composite Health」(綜合健康狀態) 頁面:

    前往「複合健康狀態」

  2. 按一下「健康狀態匯總政策」

  3. 在要刪除的健康資料匯總政策旁,選取核取方塊。

  4. 按一下「刪除」圖示

  5. 按一下「Delete」(刪除) 確認操作。

gcloud

使用 gcloud compute health-aggregation-policies delete 指令。

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

更改下列內容:

  • POLICY:要刪除的健康狀態匯總政策名稱
  • REGION:健康狀態匯總政策的區域

API

regionHealthAggregationPolicies.delete 方法傳送要求

HTTP 方法和網址:

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthAggregationPolicies/POLICY

更改下列內容:

  • PROJECT_ID:健康狀態匯總政策的專案 ID。
  • REGION:健康狀態匯總政策的區域。
  • POLICY:要刪除的健康狀態匯總政策名稱。

管理健康資料來源

下列各節說明如何管理健康資料來源。

列出健康狀態來源

您可以列出已設定的健康來源。

控制台

  1. 前往 Google Cloud 控制台的「Composite Health」(綜合健康狀態) 頁面:

    前往「複合健康狀態」

  2. 按一下「健康資料來源」

gcloud

如要列出某個區域的所有健康狀態來源,請使用 gcloud compute health-sources list 指令

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

REGION 替換為健康狀態來源的區域。

API

如要列出區域中的所有健康狀態來源,請向 regionHealthSources.list 方法發出要求。

HTTP 方法和網址:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthSources

更改下列內容:

  • PROJECT_ID:健康來源的專案 ID。
  • REGION:健康狀態來源的區域。

描述健康狀態來源

你可以描述健康資料來源,查看詳細資料。

控制台

  1. 前往 Google Cloud 控制台的「Composite Health」(綜合健康狀態) 頁面:

    前往「複合健康狀態」

  2. 按一下「健康資料來源」

  3. 按一下要描述的健康來源名稱。

gcloud

使用 gcloud compute health-sources describe 指令。

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

更改下列內容:

  • HEALTH_SOURCE:健康狀態來源的名稱
  • REGION:健康狀態來源的區域

API

regionHealthSources.get 方法傳送要求

HTTP 方法和網址:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE

更改下列內容:

  • PROJECT_ID:健康來源的專案 ID。
  • REGION:健康來源的區域。
  • HEALTH_SOURCE:健康來源的名稱。

更新健康狀態來源

您可以更新現有健康狀態來源的說明、後端服務或健康狀態匯總政策。

控制台

  1. 前往 Google Cloud 控制台的「Composite Health」(綜合健康狀態) 頁面:

    前往「複合健康狀態」

  2. 按一下「健康資料來源」

  3. 按一下要更新的健康資料來源名稱。

  4. 按一下「Edit」(編輯)

  5. 更新要變更的欄位。

  6. 按一下 [儲存]

gcloud

使用 gcloud compute health-sources update 指令。 如不想更新屬性,請省略相關標記。

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

更改下列內容:

  • HEALTH_SOURCE:要更新的健康狀態來源名稱
  • REGION:健康狀態來源的區域
  • DESCRIPTION:健康來源的更新說明
  • BACKEND_SERVICE:要用做健康狀態來源的後端服務名稱

    後端服務必須符合下列規定:

    • 負載平衡架構必須為 INTERNALINTERNAL_MANAGED
    • 必須與您建立的健康狀態來源位於相同區域。
    • 後端必須是 GCE_VM_IPGCE_VM_IP_PORT 類型的執行個體群組或網路端點群組。
  • POLICY:要套用至這個健康來源的健康資料匯總政策名稱。

API

  1. 描述健康資料來源,並記下 fingerprint 鍵的值,以供下一個步驟使用。
  2. regionHealthSources.patch 方法傳送要求。如不想更新房源的屬性,請省略相關欄位。

    HTTP 方法和網址:

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE
    

    JSON 要求主體:

    {
      "description": "DESCRIPTION",
      "sources": [
        "projects/PROJECT_ID/regions/REGION/backendServices/BACKEND_SERVICE"
      ],
      "healthAggregationPolicy": "projects/PROJECT_ID/regions/REGION/healthAggregationPolicies/POLICY",
      "fingerprint": "FINGERPRINT"
    }
    

    更改下列內容:

    • PROJECT_ID:健康來源的專案 ID。
    • REGION:健康來源的區域。
    • HEALTH_SOURCE:要更新的健康狀態來源名稱。
    • DESCRIPTION:健康來源的更新說明。
    • BACKEND_SERVICE:要用做健康狀態來源的後端服務名稱。

      後端服務必須符合下列規定:

      • 負載平衡架構必須為 INTERNALINTERNAL_MANAGED
      • 必須與您建立的健康狀態來源位於相同區域。
      • 後端必須是 GCE_VM_IPGCE_VM_IP_PORT 類型的執行個體群組或網路端點群組。
    • POLICY:要套用至這個健康來源的健康資料匯總政策更新。

    • FINGERPRINT:您在上一步中找到的 fingerprint 鍵最新值。

刪除健康狀態來源

如果健康來源未與現有的複合型健康狀態檢查建立關聯,即可刪除。

控制台

  1. 前往 Google Cloud 控制台的「Composite Health」(綜合健康狀態) 頁面:

    前往「複合健康狀態」

  2. 按一下「健康資料來源」

  3. 找出要刪除的健康資料來源,然後選取旁邊的核取方塊。

  4. 按一下「刪除」圖示

  5. 按一下「Delete」(刪除) 確認操作。

gcloud

使用 gcloud compute health-sources delete 指令。

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

更改下列內容:

  • HEALTH_SOURCE:要刪除的健康資料來源名稱
  • REGION:健康狀態來源的區域

API

regionHealthSources.delete 方法傳送要求

HTTP 方法和網址:

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE

更改下列內容:

  • PROJECT_ID:健康來源的專案 ID。
  • REGION:健康來源的區域。
  • HEALTH_SOURCE:要刪除的健康來源名稱。

管理複合型健康狀態檢查

以下各節說明如何管理複合健康狀態檢查。

列出複合型健康狀態檢查

您可以列出已設定的複合型健康狀態檢查。

控制台

  1. 前往 Google Cloud 控制台的「Composite Health」(綜合健康狀態) 頁面:

    前往「複合健康狀態」

  2. 按一下「複合型健康狀態檢查」

gcloud

如要列出區域中的所有複合健康狀態檢查,請使用 gcloud compute composite-health-checks list 指令

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

REGION 替換為複合型健康狀態檢查的區域。

API

如要列出區域中的所有複合健康狀態檢查,請向 regionCompositeHealthChecks.list 方法傳送要求。

HTTP 方法和網址:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/compositeHealthChecks

更改下列內容:

  • PROJECT_ID:複合健康狀態檢查的專案 ID。
  • REGION:複合健康狀態檢查的區域。

說明複合型健康狀態檢查

您可以描述複合型健康狀態檢查,查看詳細資料。

控制台

  1. 前往 Google Cloud 控制台的「Composite Health」(綜合健康狀態) 頁面:

    前往「複合健康狀態」

  2. 按一下「複合型健康狀態檢查」

  3. 按一下要說明的複合健康狀態檢查名稱。

gcloud

使用 gcloud compute composite-health-checks describe 指令。

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

更改下列內容:

  • COMPOSITE_HEALTH_CHECK:複合健康狀態檢查的名稱
  • REGION:複合型健康狀態檢查的區域

API

regionCompositeHealthChecks.get 方法傳送要求

HTTP 方法和網址:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/compositeHealthChecks/COMPOSITE_HEALTH_CHECK

更改下列內容:

  • PROJECT_ID:複合健康狀態檢查的專案 ID。
  • REGION:複合健康狀態檢查的區域。
  • COMPOSITE_HEALTH_CHECK:複合健康狀態檢查的名稱。

更新複合型健康狀態檢查

您可以更新複合型健康狀態檢查的說明、健康狀態來源或健康狀態目的地。

控制台

  1. 前往 Google Cloud 控制台的「Composite Health」(綜合健康狀態) 頁面:

    前往「複合健康狀態」

  2. 按一下「複合型健康狀態檢查」

  3. 按一下要更新的複合健康狀態檢查名稱。

  4. 按一下「Edit」(編輯)

  5. 更新要變更的欄位。

  6. 按一下 [儲存]

gcloud

使用 gcloud compute composite-health-checks update 指令。如不想更新屬性,請省略相關標記。

gcloud 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:要與複合健康狀態檢查建立關聯的一或多個健康狀態來源名稱

    您可以在以半形逗號分隔的清單中加入多個健康資料來源。

  • HEALTH_DESTINATION:轉送規則的 URI,會從這個複合健康狀態檢查接收複合健康狀態,例如 projects/PROJECT_ID/regions/REGION/forwardingRules/FORWARDING_RULE

    轉送規則必須與支援複合型健康狀態檢查的生產者負載平衡器建立關聯,並符合下列規定:

    • 負載平衡架構必須為 INTERNALINTERNAL_MANAGED
    • 必須與複合健康檢查位於相同區域。

API

  1. 說明複合健康狀態檢查,並記下 fingerprint 鍵的值,以供下個步驟使用。

  2. regionCompositeHealthChecks.patch 方法傳送要求。如不想更新房源的屬性,請省略相關欄位。

    HTTP 方法和網址:

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/compositeHealthChecks/COMPOSITE_HEALTH_CHECK
    

    JSON 要求主體:

    {
      "description": "DESCRIPTION",
      "healthSources": [
        "projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE"
      ],
      "healthDestination": "projects/PROJECT_ID/regions/REGION/forwardingRules/FORWARDING_RULE",
      "fingerprint": "FINGERPRINT"
    }
    

    更改下列內容:

    • PROJECT_ID:複合健康狀態檢查的專案 ID。
    • REGION:複合健康狀態檢查的區域。
    • COMPOSITE_HEALTH_CHECK:要更新的複合健康狀態檢查名稱。
    • DESCRIPTION:更新後的說明。
    • HEALTH_SOURCE:要與複合健康狀態檢查建立關聯的健康狀態來源名稱。如要關聯多個健康資料來源,請將每個來源新增至 healthSources 陣列。
    • FORWARDING_RULE:接收這項複合健康狀態檢查複合健康狀態的轉送規則。
    • FINGERPRINT:您在上一個步驟中找到的 fingerprint 鍵最新值。

刪除複合型健康狀態檢查

您可以刪除複合型健康狀態檢查。

控制台

  1. 前往 Google Cloud 控制台的「Composite Health」(綜合健康狀態) 頁面:

    前往「複合健康狀態」

  2. 按一下「複合型健康狀態檢查」

  3. 在要刪除的複合式健康檢查旁,選取核取方塊。

  4. 按一下「刪除」圖示

  5. 按一下「Delete」(刪除) 確認操作。

gcloud

使用 gcloud compute composite-health-checks delete 指令。

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

更改下列內容:

  • COMPOSITE_HEALTH_CHECK:要刪除的複合健康狀態檢查名稱
  • REGION:複合式健康狀態檢查的區域

API

regionCompositeHealthChecks.delete 方法傳送要求

HTTP 方法和網址:

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/compositeHealthChecks/COMPOSITE_HEALTH_CHECK

更改下列內容:

  • PROJECT_ID:複合健康狀態檢查的專案 ID。
  • COMPOSITE_HEALTH_CHECK:要刪除的複合健康狀態檢查名稱。
  • REGION:複合健康狀態檢查的區域。