查看 Application Integration 支援的連接器。

建立自訂連接器和連線

預先發布版

這項產品或功能適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》。 正式發布前的產品和功能是按照「原樣」提供，支援範圍可能有限。 詳情請參閱推出階段說明。

本頁說明如何為網路服務建立 OpenAPI 規格，然後為這個規格建立自訂連接器和連接。

建立自訂連接器之前，您必須先為網路服務建立 OpenAPI 規格。

為網路服務建立 OpenAPI 規格

自訂連接器支援 OpenAPI 3.0。您也可以手動建立規格。如要瞭解 OpenAPI 規格，請參閱 OpenAPI 規格。

您也可以使用 gin swagger 中介軟體自動產生 OpenAPI 2.0 規範。詳情請參閱 Gin Swagger。您必須使用 Swagger 轉換器，將 OpenAPI 2.0 規範轉換為 OpenAPI v3.0 規範。

OpenAPI 規格範例。

{
  "openapi": "3.0.0",
  "info": {
    "title": "Go HTTPbin Proxy Service",
    "description": "A simple Go service that proxies requests to httpbin.org, adding custom headers.",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "http://localhost:8080"
    }
  ],
  "paths": {
    "/getData": {
      "get": {
        "summary": "Fetch data from httpbin.org/get",
        "description": "Sends a GET request to httpbin.org/get, including any custom headers.",
        "responses": {
          "200": {
            "description": "Successful response from httpbin.org",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/postData/{id}": {
      "post": {
        "summary": "Post data to httpbin.org/post",
        "description": "Sends a POST request to httpbin.org/post with data, including any custom headers.",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"   

                  },
                  "address": {
                    "type": "string"
                  },
                  "gender": {
                    "type": "string"   
                  }
                },
                "required": [
                  "name",
                  "address",
                  "gender"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response from httpbin.org",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - Invalid request body"
          }
        }
      }
    }
  }
}

建立自訂連接器並驗證服務

您必須建立自訂連接器，然後在 Application Integration 的連線中使用該連接器，驗證 Web 服務。

事前準備

為這部虛擬機器設定 Private Service Connect (PSC)，然後建立端點附件。

建立自訂連接器

1. 在 Console 中，前往「Application Integration」> Custom connectors 頁面，然後選取或建立 Google Cloud 專案。

   前往「Custom connectors」(自訂連接器) 頁面

2. 按一下「建立新項目」，開啟「建立自訂連接器」頁面。
3. 在「連接器詳細資料」部分，指定必要欄位，例如「連接器名稱」和「顯示名稱」。此外，在「說明」欄位中輸入連接器的用途。
4. 設定後端存取的連接器目的地：啟用這個選項。頁面會顯示其他設定區段。
5. 服務帳戶：選取具備必要角色的服務帳戶。
6. 標誌：將圖片上傳至 Cloud Storage 值區，做為連結器標誌。
   注意： 請確認 Cloud Storage bucket 已停用禁止公開存取。
7. 在「連結器規格」部分，輸入開放式 API 規格的公開網址，或將規格檔案上傳至 Cloud Storage 值區。
8. 在「連接器目的地」部分，新增端點附件的 IP 位址，以及服務執行的通訊埠。
9. 在「連接器驗證」部分中，選取「無驗證」。Marketplace 連接器不支援驗證類型。
10. 在「後端變數」部分，新增要在建立連線時做為輸入內容的變數。這些變數會顯示在連線建立頁面中，並在每次對服務發出的 API 呼叫中傳送。不會隨 API 變更的值 (例如第三方後端憑證) 必須新增至這個區段。
11. 建立自訂連接器。確認您已指定標誌，並說明自訂連接器的用途。

建立連線

建立自訂連接器後，請為這個連接器建立連線。

1. 按一下「新建」開啟「建立連線」頁面。
2. 選取您建立的自訂連接器。
3. 為您定義的連結欄位新增值。
4. 建立連線。

驗證服務

如要驗證服務，請建立新的整合。

1. 前往 Google Cloud控制台的「Application Integration」頁面，然後建立整合。
2. 新增 API 觸發條件和連接器工作。
3. 設定連接器工作，使用先前步驟中建立的連線。視需要新增資料對應工具。
4. 根據結構定義，設定連接器的 connectorInputPayload。
5. 執行整合功能，確認連線是否正常運作。

如果整合功能順利執行並傳回預期回應，即表示網路服務已通過驗證。

後續步驟

• 瞭解如何為網路服務建立啟動指令碼。