カスタムランタイムでは、共通リクエストヘッダーとログヘッダーには、ランタイムのカスタマイズに使用できるコンテキスト情報と実行ログが含まれています。
Function Compute の共通リクエストヘッダー
次の表は、カスタムランタイムが Function Compute から受信する可能性のある共通リクエストヘッダーについて説明しています。他の Alibaba Cloud サービスにアクセスする場合は、一時的な AccessKey ペアを指定するリクエストヘッダーを使用する必要がある場合があります。既存のアプリケーションを Function Compute に移行する場合は、以下の情報は無視してください。
イベント関数と HTTP 関数の両方に共通リクエストヘッダーが含まれています。
共通リクエストヘッダーは、Function Compute によって自動的に生成されます。これらには、関連する権限など、関数に関する基本情報が含まれています。
ヘッダー | 説明 |
x-fc-request-id | リクエスト ID。 |
x-fc-access-key-id | 一時的な AccessKey ID。関数にロールを設定すると、Function Compute は AssumeRole 操作を呼び出して、この AccessKey ID を取得します。 |
x-fc-access-key-secret | 一時的な AccessKey シークレット。関数にロールを設定すると、Function Compute は AssumeRole 操作を呼び出して、この AccessKey シークレットを取得します。 |
x-fc-security-token | 一時的なセキュリティトークン。関数にロールを設定すると、Function Compute は AssumeRole 操作を呼び出して、この一時的なセキュリティトークンを取得します。 |
x-fc-function-handler | 関数のハンドラー。ランタイムが関数の場合、たとえば、カスタムランタイムまたはカスタムコンテナランタイムで実行される関数の場合、このパラメーターは無視され、ランダムな文字列に設定できます。 |
x-fc-function-memory | 関数が使用できる最大メモリ。 |
x-fc-region | 関数が存在するリージョン。 |
x-fc-account-id | 関数オーナーの ID。 |
x-fc-qualifier | 関数を呼び出すときに指定するサービスバージョンまたはエイリアス。詳細については、「バージョンとエイリアスを使用してカナリアリリースを実装する」をご参照ください。 |
x-fc-version-id | 関数を呼び出すときに指定するサービスバージョン。 |
x-fc-function-name | 関数の名前。 |
x-fc-service-logproject | 関数が属するサービスに設定されている Simple Log Service プロジェクト。 |
x-fc-service-logstore | 関数が属するサービスに設定されている Simple Log Service ログストア。 |
x-fc-control-path | 関数のリクエストタイプ。 カスタムランタイムまたはカスタムコンテナランタイムの場合、このパラメーターは、関数が HTTP リクエストによって呼び出されるか、イベントによってトリガーされるかを示します。有効な値:
|
セキュリティ上の理由から、x-fc-security-token は、カスタムランタイム(Debian 11)ではサポートされなくなりました。引き続き一時的な権限情報が必要な場合は、ALIBABA_CLOUD_ACCESS_KEY_ID、ALIBABA_CLOUD_ACCESS_KEY_SECRET、および ALIBABA_CLOUD_SECURITY_TOKEN 環境変数を使用して取得できます。詳細については、「環境変数を設定する」をご参照ください。
関数ログ形式
Function Compute でサービスを作成するときに、ロギング機能を有効にすることをお勧めします。このようにして、カスタムランタイムの stdout に出力されるすべてのログは、指定した Simple Log Service のログストアに自動的に収集されます。詳細については、「ロギング機能を設定する」をご参照ください。
カスタムランタイムとカスタムコンテナランタイム以外のランタイムでは、リクエストヘッダーに x-fc-log-type = "Tail" が含まれている場合、x-fc-log-result ヘッダーを含む返されるコンテンツは関数実行ログです。各ログのサイズは最大 4 KB です。 Function Compute コンソール の関数呼び出しの結果でログを表示できます。
ログレベルを指定するために呼び出すことができる API は、プログラミング言語によって異なります。詳細については、「基本」をご参照ください。
参照
カスタムランタイムの関数の詳細については、「概要」をご参照ください。
カスタムランタイムのコールドスタートと HTTP サーバーの設定方法の詳細については、「原則」をご参照ください。
カスタムランタイムで関数を呼び出す方法の詳細については、「Web 関数」をご参照ください。
カスタムランタイムで関数インスタンスのライフサイクルフックを実装する方法の詳細については、「関数インスタンスのライフサイクルフック」をご参照ください。