驗證回應資料

Google Cloud 控制台

如要建立運作時間檢查來驗證回應資料，請執行下列操作：

1. 在 Google Cloud 控制台中，前往 「Uptime checks」頁面：

   前往「Uptime checks」(運作時間檢查)

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。

2. 在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如要設定 App Hub，請選取 App Hub 主機專案或啟用應用程式的資料夾管理專案。
3. 按一下「建立運作時間檢查」。
4. 輸入標題，然後點選「下一步」。
5. 輸入目標，然後點選「下一步」。

6. 設定「回應驗證」：

   • 如要驗證回應資料，請確認畫面上顯示「Content matching is enabled」，然後填寫與回應驗證相關的欄位。如要瞭解這些選項，請參閱本文的下一節。
   • 針對 HTTP 運作時間檢查，請設定可接受的回應代碼。根據預設，HTTP 運作時間檢查會將任何 2xx 回應標示為成功回應。

7. 按一下「下一步」，然後完成運作時間檢查設定。

Cloud Monitoring API

如要設定運作時間檢查來驗證回應資料，請填入 UptimeCheckConfig 物件的 contentMatchers 陣列。

ContentMatcher 物件包含下列欄位：

• matcher：說明比較方式。如需值清單，請參閱 ContentMatcherOption。

  請勿使用 CONTENT_MATCHER_OPTION_UNSPECIFIED 值。

• content：儲存要搜尋的回應資料值。值為字串常值或規則運算式。

• jsonPathMatcher：儲存 JsonPathMatcher 物件，說明要搜尋哪個 JSONpath，以及如何執行比較。

  除非運作時間檢查是驗證特定 JSONpath，否則請省略這個欄位。

本文件的其餘部分會說明如何使用內容比對選項。

Google Cloud 控制台

如要設定運作時間檢查，讓系統在回應資料包含文字常值子字串時通過，請使用下列設定：

1. 在「回應內容比對類型」選單中選取「包含」。
2. 在「回應內容」欄位中輸入文字子字串。
3. 如要驗證設定，請按一下「Test」。

如要設定在回應資料包含文字子字串時，運作時間檢查作業會失敗，請使用下列設定：

1. 在「回應內容比對類型」選單中選取「不包含」。
2. 在「回應內容」欄位中輸入文字子字串。
3. 如要驗證設定，請按一下「Test」。

Cloud Monitoring API

如要設定當回應資料包含文字值子串時，讓服務時間檢查通過，請使用下列值：

...
"contentMatchers": [
    {
      "content": "Set to the string to be matched.",
      "matcher": "CONTAINS_STRING"
    }
],
...

如要設定當回應資料包含文字常值子字串時，上線時間檢查作業會失敗，請使用下列值：

...
"contentMatchers": [
    {
      "content": "Set to the string to be matched.",
      "matcher": "NOT_CONTAINS_STRING"
    }
],
...

Google Cloud 控制台

如要設定運作時間檢查，讓系統在回應資料符合規則運算式時通過，請使用下列設定：

1. 在「回覆內容比對類型」選單中，選取「與規則運算式相符」。
2. 在「回應內容」欄位中輸入規則運算式。
3. 如要驗證設定，請按一下「Test」。

如要設定運作時間檢查，在回應資料符合規則運算式時失敗，請使用下列設定：

1. 在「回應內容比對類型」選單中，選取「與規則運算式不符」。
2. 在「回應內容」欄位中輸入規則運算式。
3. 如要驗證設定，請按一下「Test」。

Cloud Monitoring API

如要設定在回應資料符合規則運算式時，讓服務時間檢查通過，請使用下列值：

...
"contentMatchers": [
    {
      "content": "Set to the regular expression to be matched.",
      "matcher": "MATCHES_REGEX"
    }
],
...

如要設定在回應資料符合規則運算式時，讓正常運作時間檢查失敗，請使用下列值：

...
"contentMatchers": [
    {
      "content": "Set to the regular expression to be matched.",
      "matcher": "NOT_MATCHES_REGEX"
    }
],
...

Google Cloud 控制台

如要設定運作時間檢查，讓系統在回應資料中的特定 JSONpath 與字串文字相符時通過，請使用下列設定：

1. 在「回應內容比對類型」選單中，選取「與 JSONPath 中的內容相符」。
2. 在「JSONPath」JSONPath欄位中輸入路徑。
3. 在「回應內容」欄位中輸入數字或字串文字。
4. 如要驗證設定，請按一下「Test」。

如要設定運作時間檢查，當回應資料中的特定 JSONpath 與字串文字相符時，檢查作業就會失敗，請使用下列設定：

1. 在「回應內容比對類型」選單中，選取「與 JSONPath 中的內容不符」。
2. 在「JSONPath」JSONPath欄位中輸入路徑。
3. 在「回應內容」欄位中輸入數字或字串文字。
4. 如要驗證設定，請按一下「Test」。

Cloud Monitoring API

如要設定當 JSON 格式回應中的特定欄位與數字或字串文字相符時，讓正常運作時間檢查通過，請為 ContentMatcher 物件使用下列值：

...
"contentMatchers": [
    {
       "content" : "Set to a number, a boolean, or the string to be matched.",
       "matcher" : "MATCHES_JSON_PATH",
       "jsonPathMatcher" : {
           "jsonPath" : "Set to the JSONpath.",
           "jsonMatcher" : "EXACT_MATCH"
    }
],
...

如要將正常運作時間檢查設為在 JSON 格式回應中的特定欄位與數字或字串文字相符時失敗，請為 ContentMatcher 物件使用下列值：

...
"contentMatchers": [
    {
       "content" : "Set to a number, a boolean, or the string to be matched.",
       "matcher" : "NOT_MATCHES_JSON_PATH",
       "jsonPathMatcher" : {
           "jsonPath" : "Set to the JSONpath.",
           "jsonMatcher" : "EXACT_MATCH"
    }
],
...

Google Cloud 控制台

如要設定運作時間檢查，讓系統在回應資料中的特定 JSONpath 與規則運算式相符時通過，請使用下列設定：

1. 在「回應內容比對類型」選單中，選取「與 JSONPath 中的內容相符」。
2. 在「JSONPath」JSONPath欄位中輸入路徑。
3. 在「回應內容」欄位中輸入規則運算式。
4. 如要驗證設定，請按一下「Test」。

如要設定運作時間檢查，當回應資料中的特定 JSONpath 與規則運算式相符時，檢查作業就會失敗，請使用下列設定：

1. 在「回應內容比對類型」選單中，選取「與 JSONPath 中的內容不符」。
2. 在「JSONPath」JSONPath欄位中輸入路徑。
3. 在「回應內容」欄位中輸入規則運算式。
4. 如要驗證設定，請按一下「Test」。

Cloud Monitoring API

如要設定當 JSON 格式回應中的特定欄位與規則運算式相符時，讓服務時間檢查通過，請為 ContentMatcher 物件使用下列值：

...
"contentMatchers": [
    {
       "content" : "Set to the regular expression to be matched."
       "matcher" : "MATCHES_JSON_PATH",
       "jsonPathMatcher" : {
           "jsonPath" : "Set to the JSONpath.",
           "jsonMatcher" : "REGEX_MATCH"
    }
],
...

如要將上線時間檢查設為在 JSON 格式回應中的特定欄位與規則運算式相符時失敗，請為 ContentMatcher 物件使用下列值：

...
"contentMatchers": [
    {
       "content" : "Set to the regular expression to be matched.",
       "matcher" : "NOT_MATCHES_JSON_PATH",
       "jsonPathMatcher" : {
           "jsonPath" : "Set to the JSONpath.",
           "jsonMatcher" : "REGEX_MATCH"
    }
],
...