クラウド関数の呼び出し

HTTPリクエストを使用して、Google Cloud Functionsを呼び出します。

［Invoke Cloud Function（クラウド関数の呼び出し）］カードは、Google Cloud Functions（第1世代）のみを呼び出します。第2世代またはCloud Run Serviceの関数を呼び出すことはできません。

第1世代のGoogle Cloud Functionsを作成するには、次のような複数の方法があります。

  • Google Cloud Function UI。

  • Google Cloud Function UIコンソール。

  • Google Cloud Function SDK。

  • Google Cloud Function API。

  • Google CLI。

  • Terraform。

以下を参照してください。

オプション

フィールド 定義 タイプ 必須

Region（地域）

プロジェクトに割り当てる地域を選択します。

各地域のクラウド関数の名前は一意ですが、2つの異なる地域で同じ名前の関数を持つことができます。

デフォルトのオプションはus-central1です。

 ドロップダウン TRUE

Function Name（関数名）

関数の名前。

 ドロップダウン TRUE

Request Type（リクエストタイプ）

カスタムAPI呼び出しでサポートされている、次の5つのHTTPリクエストメソッドのいずれか。

  • GETはパラメーターに基づいてWebサーバーからデータを取得します。GETリクエストは指定されたリソースの表現を要求します。成功した場合、GETリクエストは要求したコンテンツとともに200 OKレスポンスメッセージを返します。
  • POSTはパラメーターに基づいてWebサーバーにデータを送信します。POSTリクエストにはファイルのアップロードなどのアクションが含まれます。複数のPOSTリクエストは1つのPOSTと異なる結果になる場合があるため、意図せずに複数のリクエストを送信することについて注意が必要です。成功した場合、POSTリクエストは200 OKレスポンスメッセージを返します。
  • PUTはパラメーターに基づいてWebサーバーの場所にデータを送信します。PUTリクエストにはファイルのアップロードなどのアクションが含まれます。PUTおよびPOSTリクエストの違いはPUTが冪等であるということです。つまり、リクエストが成功なら、同じPUTリクエストを何回実行しても、1回実行したときと同じ結果になります。成功した場合、PUTリクエストは、2xxレスポンスメッセージを返します（通常201または204）。
  • PATCHはパラメーターに基づいてWebサーバー上のリソースに部分的な変更を適用します。PATCHリクエストは冪等（べきとう）ではありません。つまり、複数のPATCHリクエストによって意図しない結果が生じる可能性があります。成功した場合、PATCHリクエストは、2xxレスポンスメッセージを返します（通常204）。
  • DELETEはパラメーターに基づいてWebサーバーから特定のリソースを削除します（リソースが存在する場合）。成功した場合、DELETEリクエストは200 OKレスポンスメッセージを返します。
 ドロップダウン TRUE

入力

フィールド 定義 タイプ 必須

Query（クエリ）

URLで実行されるアクションを定めるJSONオブジェクト。

例：{"name":"something-urgent"}

オブジェクトまたはテキスト

 FALSE

Headers（ヘッダー）

リクエストのコンテンツタイプを定めるJSONオブジェクト。

例：{"Content-type":"application/json"}

 オブジェクト FALSE

Body（ボディー）

リクエストのコンテンツで受け渡されるJSONオブジェクト。

たとえば：{"id":10}

 オブジェクト FALSE

出力

フィールド 定義 タイプ

Status Code（ステータスコード）

操作の結果。コネクターは、カードによって実行されたアクションの成否を示すHTTPステータスコードを返します。例：

  • 201 Createdステータスコードは、アクションが成功し、新しいリソースが作成されたことを示します。
  • 403 Forbiddenエラーは、必要な権限が不足していたためにHTTPリクエストが処理されなかったことを示します。

発生する可能性があるステータスコードの完全なリストについては、「HTTPステータスコード」を参照してください。

 数値

Headers（ヘッダー）

出力ボディーとは関係のない、ステータスコードの詳細なコンテキスト。

レスポンスヘッダーは、選択したHTTPリクエストオプションによって決定します。すべてのヘッダーがレスポンスヘッダーというわけではありません。

 オブジェクト

Body（本文）

選択されたHTTPリクエストから返されるデータ（たとえば、GETリクエストからのデータなど）。

 オブジェクト