翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Api
Api イベントソースタイプを説明するオブジェクトです。AWS::Serverless::Api リソースが定義されている場合、パスとメソッドの値は、API の OpenApi 定義にあるオペレーションに対応している必要があります。
AWS::Serverless::Api が定義されていない場合、関数の入出力は HTTP リクエストと HTTP レスポンスの表現です。
例えば、JavaScript API を使用すると、statusCode および body キーを持つオブジェクトを返すことによって、レスポンスのステータスコードと本文を制御できます。
構文
AWS Serverless Application Model (AWS SAM) テンプレートでこのエンティティを宣言するには、次の構文を使用します。
YAML
Auth:ApiFunctionAuthMethod:StringPath:StringRequestModel:RequestModelRequestParameters:List of [ String | RequestParameter ]RestApiId:StringResponseTransferMode:StringTimeoutInMillis:Integer
プロパティ
-
Auth -
この特定の Api とパスとメソッドの認証設定です。
DefaultAuthorizerが指定されていない場合に個々のパス上にある API のDefaultAuthorizer設定の認証設定を上書きする、またはデフォルトのApiKeyRequired設定を上書きするために役立ちます。タイプ: ApiFunctionAuth
必須: いいえ
CloudFormation 互換性: このプロパティは に固有 AWS SAM であり、 CloudFormation 同等のものはありません。
-
Method -
この関数が呼び出される HTTP メソッドです。オプションには
DELETE、GET、HEAD、OPTIONS、PATCH、POST、PUT、およびANYがあります。詳細については、「API Gateway デベロッパーガイド」の「HTTP メソッドをセットアップする」を参照してください。タイプ: 文字列
必須: はい
CloudFormation 互換性: このプロパティは に固有 AWS SAM であり、 CloudFormation 同等のものはありません。
-
Path -
この関数が呼び出される URI パスです。
/で始まる必要があります。タイプ: 文字列
必須: はい
CloudFormation 互換性: このプロパティは に固有 AWS SAM であり、 CloudFormation 同等のものはありません。
-
RequestModel -
この特定の Api とパスとメソッドに使用するリクエストモデルです。これは、AWS::Serverless::Api リソースの
Modelsセクションに指定されているモデルの名前を参照する必要があります。タイプ: RequestModel
必須: いいえ
CloudFormation 互換性: このプロパティは に固有 AWS SAM であり、 CloudFormation 同等のプロパティはありません。
-
RequestParameters -
この特定の API、パス、メソッドのリクエストパラメータ設定です。すべてのパラメータ名は
method.requestで始まりmethod.request.header、method.request.querystring、またはmethod.request.pathに制限する必要があります。リストには、パラメータ名の文字列と RequestParameter オブジェクトの両方を含めることができます。文字列の場合、
RequiredおよびCachingプロパティはデフォルトでfalseになります。タイプ: [ String | RequestParameter ] のリスト
必須: いいえ
CloudFormation 互換性: このプロパティは に固有 AWS SAM であり、 CloudFormation 同等のものはありません。
-
RestApiId -
RestApi リソースの識別子です。これには、指定されたパスとメソッドを持つオペレーションが含まれている必要があります。通常、このテンプレートで定義される AWS::Serverless::Api リソースを参照するように設定されます。
このプロパティを定義しない場合、 は生成された
OpenApiドキュメントを使用してデフォルトのAWS::Serverless::Apiリソース AWS SAM を作成します。そのリソースには、RestApiIdを指定しない同じテンプレート内のApiイベントによって定義されるすべてのパスとメソッドの和集合が含まれます。これは、別のテンプレートで定義された AWS::Serverless::Api リソースを参照できません。
タイプ: 文字列
必須: いいえ
CloudFormation 互換性: このプロパティは に固有 AWS SAM であり、 CloudFormation 同等のものはありません。
ResponseTransferMode-
Lambda 関数統合のレスポンス転送モード。に設定する
RESPONSE_STREAMと、API Gateway を介した Lambda レスポンスのストリーミングが有効になり、関数はレスポンスをクライアントにストリーミングできます。に設定するとRESPONSE_STREAM、API Gateway は Lambda InvokeWithResponseStreaming API を使用します。タイプ: 文字列
必須: いいえ
有効な値:
BUFFERED|RESPONSE_STREAMCloudFormation 互換性: このプロパティは、 の
ResponseTransferModeプロパティに直接渡されますAWS::ApiGateway::Method Integration。 TimeoutInMillis-
50～29,000 ミリ秒のカスタムタイムアウトです。
注記
このプロパティを指定すると、 は OpenAPI 定義 AWS SAM を変更します。OpenAPI の定義は、
DefinitionBodyプロパティを使用してインラインで指定する必要があります。タイプ: 整数
必須: いいえ
デフォルト = 29,000 ミリ秒 (29 秒)
CloudFormation 互換性: このプロパティは に固有 AWS SAM であり、同等の CloudFormation ものはありません。
例
基本的な の例
YAML
Events: ApiEvent: Type: Api Properties: Path: /path Method: get RequestParameters: - method.request.header.Authorization - method.request.querystring.keyword: Required: true Caching: false
