API
Cloud Runの呼び出し
概要
このブロックは、Cloud Run functionsやCloud Runをはじめとする各種HTTPベースのサービスやAPIを、指定したHTTPメソッドを使用してHTTPリクエストによって呼び出します。
このブロックは、Cloud Functionsだけでなく、Cloud Runにホストされたサービスやその他のHTTPエンドポイントにも対応しています。対応するHTTPメソッドは以下のとおりです。
- GET
- POST
- PUT
- DELETE
- OPTIONS
このブロックで呼び出すCloud Run functionsは、HTTPトリガータイプとしてデプロイされている必要があります。このデプロイ方法については、Googleのドキュメント「HTTPトリガー」を参照してください。
このブロックでは、認証あり・認証なしのどちらにも対応しています。認証ありの場合は、認証をパスできるGCPサービスアカウントを準備してください。具体的には、Cloud Run functionsやCloud Runなどのサービスに対して、適切な権限（例：Cloud Functions 起動元やCloud Run 起動元など）を持つサービスアカウントを使用して認証を実施します。
実行時間の制限
- Cloud Run functions: 最大9分に延長された関数を実行可能
- Cloud Run: 最大60分に延長されたサービスを実行可能
エラーハンドリング
HTTPレスポンス時のステータスコードが、400番台および500番台の場合、ブロックの実行は失敗とみなされます。
注意
Google CloudのプロジェクトIDにコロン（:）が含まれている場合、当該プロジェクトの関数やサービスは呼び出せません。
プロパティ
| プロパティ名 | 説明 | ||||||
|---|---|---|---|---|---|---|---|
| ブロック名 |
ブロックの名前を指定します。この名前はブロックに表示され、フロー内でブロックを識別するために使用されます。わかりやすい名前を設定することで、フローの可読性が向上します |
||||||
| GCPサービスアカウント |
このブロックで使用するGCPサービスアカウントを選択します。 認証ありでサービスや関数を呼び出す場合は、認証をパスできるGCPサービスアカウントを準備し、選択してください。具体的には、Cloud Run functionsやCloud Runなどのサービスに対して、適切な権限（例： |
||||||
| HTTPメソッド |
HTTPメソッドを選択します。選択可能なHTTPメソッドは以下のとおりです。
|
||||||
| URL |
呼び出す関数やサービスのHTTPエンドポイントを指定します。
例：
https://us-central1-MY_PROJECT.cloudfunctions.net/addMessage
HTTPエンドポイントをコピー＆ペーストで貼り付ける際は、前後に無駄な空白が付かないように注意してください。前後に空白が含まれると、本ブロックの実行時に以下のエラーが発生します。 URI::InvalidURIError:bad URI(is not URI?) |
||||||
| コンテンツタイプ |
コンテンツタイプ（Content-Type：送信するデータの種類）を以下のいずれかから選択します。
|
||||||
| パラメーター |
関数に送信するデータを指定します。データは、キーとバリューの組合せで指定します。バリューには、変数展開および%形式の文字列書式を使用できます。 |
||||||
| リクエストボディを指定する変数 |
HTTPリクエストのボディを使ってデータを送信したいときに、データが格納された変数を指定します。 このプロパティを設定すると、コンテンツタイププロパティとパラメータープロパティの設定内容は無視されます。この際のコンテンツタイプは、コンテンツタイププロパティの選択内容に関わらず、application/json固定となります。 |
||||||
| ブロックメモ |
ブロックに対するコメントを指定します。フローの管理やメンテナンス時に役立ちます。 |
||||||
| エラー時の繰り返し回数 | エラー時の繰り返し回数を指定します。 | ||||||
| 繰り返し間隔 | エラー時の繰り返し間隔を秒単位で指定します。 | ||||||
| レスポンスを格納する変数 |
HTTPレスポンスを格納する変数を指定します。 変数に格納する値は、HTTPレスポンスのボティのみです。HTTPレスポンスのContent-Typeヘッダーがapplication/jsonの場合は、ボディをデコードした結果を変数に格納します。 |
||||||
| リクエストヘッダー |
関数呼び出し時に追加したいHTTPリクエストのヘッダーをキーとバリューの組合せで指定します。バリューには、変数展開および%形式の文字列書式が記述できます。 |