Api - AWS Serverless Application Model
構文プロパティ例

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Api

Api イベントソースタイプを説明するオブジェクトです。AWS::Serverless::Api リソースが定義されている場合、パスとメソッドの値は、API の OpenApi 定義にあるオペレーションに対応している必要があります。

構文

AWS Serverless Application Model (AWS SAM) テンプレートでこのエンティティを宣言するには、以下の構文を使用します。

YAML

  Auth: ApiStateMachineAuth
  Method: String
  Path: String
  RestApiId: String
  UnescapeMappingTemplate: Boolean

プロパティ

Auth

この API、パス、およびメソッドの認可設定です。

このプロパティを使用して、DefaultAuthorizer が指定されていない場合、またはデフォルトの ApiKeyRequired 設定を上書きするために、個々のパスに対する API の DefaultAuthorizer 設定を上書きします。

タイプ: ApiStateMachineAuth

必須: いいえ

CloudFormation との互換性: このプロパティは AWS SAM に固有であり、CloudFormation に同等のものはありません。

Method

この関数が呼び出される HTTP メソッドです。

タイプ: 文字列

必須: はい

CloudFormation との互換性: このプロパティは AWS SAM に固有であり、CloudFormation に同等のものはありません。

Path

この関数が呼び出される URI パスです。値は / で始める必要があります。

タイプ: 文字列

必須: はい

CloudFormation との互換性: このプロパティは AWS SAM に固有であり、CloudFormation に同等のものはありません。

RestApiId

RestApi リソースの識別子で、所定のパスとメソッドでのオペレーションが含まれている必要があります。これは通常、このテンプレートで定義された AWS::Serverless::Api リソースを参照するように設定されます。

このプロパティを定義しない場合は、AWS SAM が生成された OpenApi ドキュメントを使用してデフォルトの AWS::Serverless::Api リソースを作成します。そのリソースには、RestApiId を指定しない同じテンプレート内の Api イベントによって定義されるすべてのパスとメソッドの和集合が含まれます。

このプロパティは、別のテンプレートで定義された AWS::Serverless::Api リソースを参照できません。

タイプ: 文字列

必須: いいえ

CloudFormation との互換性: このプロパティは AWS SAM に固有であり、CloudFormation に同等のものはありません。

UnescapeMappingTemplate

\' を ' に置き換えて、ステートマシンに渡される入力の一重引用符のエスケープを解除します。入力に一重引用符が含まれている場合に使用します。

注記

False に設定し、入力に一重引用符が含まれている場合、エラーが発生します。

タイプ: ブール

必須: いいえ

デフォルト: False

CloudFormation との互換性: このプロパティは AWS SAM に固有であり、CloudFormation に同等のものはありません。

例

ApiEvent

以下は、Api タイプのイベントの例です。

YAML

Events:
  ApiEvent:
    Type: Api
    Properties:
      Path: /path
      Method: get