クラウド関数の呼び出し

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

第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です。

ドロップダウン

関数名(Function Name)

関数の名前。

ドロップダウン

リクエストタイプ(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レスポンスメッセージを返します。
ドロップダウン

入力

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

クエリ(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リクエストからのデータなど)。

オブジェクト