呼叫本機函式

設定

本文假設您已在 localhost 上設定在本機執行的函式，並使用 Functions Framework 或 Buildpacks。此外，本文也假設您已在本機電腦上安裝 curl 工具。

將要求傳送至本機函式

您可以透過本機服務程序傳送 HTTP 要求，藉此觸發在本機執行的函式。

如要判斷函式在本機的執行位置，請檢查執行函式時顯示的網址。依預設，函式會託管在 localhost:8080。

HTTP 函式

從開發環境測試 HTTP 函式時，函式通常會監聽 localhost:8080 的要求。此介面只能從執行函式的機器或 VM 進行存取；從任何其他系統傳送的要求都無法存取。因此，您必須從執行函式的相同系統發出 HTTP 要求。在下列範例中，如果您函式監聽的通訊埠不是 8080，請將範例中的 8080 替換為函式的通訊埠號碼。

使用 Cloud Shell 測試 HTTP 函式

如果您要使用 Cloud Shell 建構並測試函式，請在 Cloud Shell 終端機視窗中以本機啟動函式，然後從瀏覽器或 curl 執行個體發出 HTTP 觸發要求，如下所示：

瀏覽器

按一下 Cloud Shell 工具列上的 網頁預覽按鈕 圖示，然後選擇「port 8080」(通訊埠 8080)或「Change port」(變更通訊埠)，以選取其他通訊埠。系統會開啟正確系統的瀏覽器視窗，並對指定通訊埠發出 GET 要求。

Curl

如要控制 HTTP 要求的格式，或查看未格式化的回覆，請使用 curl：

  1. 按一下 Cloud Shell 選單列中的「+」圖示，在執行函式的相同系統上開啟新的終端機視窗。

  2. 在該視窗中執行 curl 指令以觸發函式。 例如：

    curl localhost:8080

在電腦伺服器上測試 HTTP 函式

如果您是在本機電腦系統上建構及執行函式，請先在本機啟動函式，然後從瀏覽器或 curl 執行個體發出 HTTP 觸發要求，如下所示：

瀏覽器

開啟新的瀏覽器視窗或分頁，然後在瀏覽器網址列中輸入 http://localhost:8080。這會在您的電腦伺服器上開啟前往 localhost:8080 的瀏覽器視窗，以觸發函式。

Curl

在本機電腦上開啟新的終端機視窗，然後在該視窗中執行 curl 指令，觸發函式。例如：

 curl localhost:8080

這會執行指定的 curl 指令來觸發函式，並顯示未格式化的回應。

CloudEvent 函式

您可以使用 curl 將範例事件傳送至 CloudEvent 函式。下列 curl 要求說明如何將 Cloud Pub/Sub 和 Cloud Storage 範例事件傳送至在 localhost:8080 執行的 CloudEvent 函式。

Pub/Sub 

curl localhost:8080 \
  -X POST \
  -H "Content-Type: application/json" \
  -H "ce-id: 123451234512345" \
  -H "ce-specversion: 1.0" \
  -H "ce-time: 2020-01-02T12:34:56.789Z" \
  -H "ce-type: google.cloud.pubsub.topic.v1.messagePublished" \
  -H "ce-source: //pubsub.googleapis.com/projects/MY-PROJECT/topics/MY-TOPIC" \
  -d '{
        "message": {
          "data": "d29ybGQ=",
          "attributes": {
             "attr1":"attr1-value"
          }
        },
        "subscription": "projects/MY-PROJECT/subscriptions/MY-SUB"
      }'

儲存空間 

curl localhost:8080 \
  -X POST \
  -H "Content-Type: application/json" \
  -H "ce-id: 123451234512345" \
  -H "ce-specversion: 1.0" \
  -H "ce-time: 2020-01-02T12:34:56.789Z" \
  -H "ce-type: google.cloud.storage.object.v1.finalized" \
  -H "ce-source: //storage.googleapis.com/projects/_/buckets/MY-BUCKET-NAME" \
  -H "ce-subject: objects/MY_FILE.txt" \
  -d '{
        "bucket": "MY_BUCKET",
        "contentType": "text/plain",
        "kind": "storage#object",
        "md5Hash": "...",
        "metageneration": "1",
        "name": "MY_FILE.txt",
        "size": "352",
        "storageClass": "MULTI_REGIONAL",
        "timeCreated": "2020-04-23T07:38:57.230Z",
        "timeStorageClassUpdated": "2020-04-23T07:38:57.230Z",
        "updated": "2020-04-23T07:38:57.230Z"
      }'

背景函式

您可以使用 curl 將範例事件傳送至背景函式。下列 curl 要求顯示如何將 Cloud Pub/Sub 和 Cloud Storage 範例事件傳送至在 localhost:8080 執行的背景函式。

Pub/Sub 

# 'world' base64-encoded is 'd29ybGQ='
curl localhost:8080 \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
        "context": {
          "eventId":"1144231683168617",
          "timestamp":"2020-05-06T07:33:34.556Z",
          "eventType":"google.pubsub.topic.publish",
          "resource":{
            "service":"pubsub.googleapis.com",
            "name":"projects/sample-project/topics/gcf-test",
            "type":"type.googleapis.com/google.pubsub.v1.PubsubMessage"
          }
        },
        "data": {
          "@type": "type.googleapis.com/google.pubsub.v1.PubsubMessage",
          "attributes": {
             "attr1":"attr1-value"
          },
          "data": "d29ybGQ="
        }
      }'

儲存空間 

curl localhost:8080 \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
        "context": {
          "eventId": "1147091835525187",
          "timestamp": "2020-04-23T07:38:57.772Z",
          "eventType": "google.storage.object.finalize",
          "resource": {
             "service": "storage.googleapis.com",
             "name": "projects/_/buckets/MY_BUCKET/MY_FILE.txt",
             "type": "storage#object"
          }
        },
        "data": {
          "bucket": "MY_BUCKET",
          "contentType": "text/plain",
          "kind": "storage#object",
          "md5Hash": "...",
          "metageneration": "1",
          "name": "MY_FILE.txt",
          "size": "352",
          "storageClass": "MULTI_REGIONAL",
          "timeCreated": "2020-04-23T07:38:57.230Z",
          "timeStorageClassUpdated": "2020-04-23T07:38:57.230Z",
          "updated": "2020-04-23T07:38:57.230Z"
        }
      }'