本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

模板的全局部分 AWS SAM

有時，您在AWS SAM模板中聲明的資源具有通用配置。例如，您的應用程式可能包含多個具有相同Runtime、、MemoryVPCConfigEnvironment、和Cors組態的AWS::Serverless::Function資源。您可以在Globals部分中聲明一次，並讓您的資源繼承它們，而不是在每個資源中複製這些信息。

此Globals區段支援下列AWS SAM資源類型：

範例：

Globals:
  Function:
    Runtime: nodejs12.x
    Timeout: 180
    Handler: index.handler
    Environment:
      Variables:
        TABLE_NAME: data-table

Resources:
  HelloWorldFunction:
    Type: AWS::Serverless::Function
    Properties:
      Environment:
        Variables:
          MESSAGE: "Hello From SAM"

  ThumbnailFunction:
    Type: AWS::Serverless::Function
    Properties:
      Events:
        Thumbnail:
          Type: Api
          Properties:
            Path: /thumbnail
            Method: POST

在這個例子中，HelloWorldFunction並ThumbnailFunction使用「nodejs12.x」表示Runtime，「180」秒代表Timeout，並使用「索引。Handler HelloWorldFunction除了繼承的 TABLE_NAME 之外，還會新增訊息環境變數。 ThumbnailFunction繼承所有Globals屬性並添加 API 事件源。

支援的資源和屬性

AWS SAM支援下列資源和屬性。

Globals:
  Api:
    AccessLogSetting:
    Auth:
    BinaryMediaTypes:
    CacheClusterEnabled:
    CacheClusterSize:
    CanarySetting:
    Cors:
    DefinitionUri:
    Domain:
    EndpointConfiguration:
    GatewayResponses:
    MethodSettings:
    MinimumCompressionSize:
    Name:
    OpenApiVersion:
    PropagateTags:
    TracingEnabled:
    Variables:
  
  Function:
    Architectures:
    AssumeRolePolicyDocument:
    AutoPublishAlias:
    CodeUri:
    DeadLetterQueue:
    DeploymentPreference:
    Description:
    Environment:
    EphemeralStorage:
    EventInvokeConfig:
    Handler:
    KmsKeyArn:
    Layers:
    MemorySize:
    PermissionsBoundary:
    PropagateTags:
    ProvisionedConcurrencyConfig:
    ReservedConcurrentExecutions:
    Runtime:
    Tags:
    Timeout:
    Tracing:
    VpcConfig:

  HttpApi:
    AccessLogSettings:
    Auth:
    PropagateTags:
    StageVariables:
    Tags:

  SimpleTable:
    SSESpecification:
    
  StateMachine:
    PropagateTags:

隱含的 API

AWS SAM當您在區段中宣告 API 時，會建立隱含Events的 API。您可以使Globals用覆蓋隱式 API 的所有屬性。

可重新定義屬性

資源可以覆寫您在Globals區段中宣告的屬性。例如，您可以將新變數新增至環境變數 map，或者您可以覆寫全域宣告的變數。但資源無法移除Globals區段中指定的屬性。

更一般地說，該Globals部分聲明了所有資源共享的屬性。某些資源可以為全域宣告的屬性提供新值，但無法移除它們。如果某些資源使用屬性，但其他資源不使用，那麼您不能在該Globals部分中聲明它們。

下列各節說明覆寫如何針對不同的資料類型運作。

原始數據類型被替換

原始數據類型包括字符串，數字，布爾值等。

區段中指定的值會取代Resources區Globals段中的值。

範例：

Globals:
  Function:
    Runtime: nodejs12.x

Resources:
  MyFunction:
    Type: AWS::Serverless::Function
    Properties:
      Runtime: python3.9

用Runtime於MyFunction設定為python3.9。

地圖被合併

地圖也被稱為字典或鍵值對的集合。

Resources區段中的地圖項目會與全域地圖項目合併。如果存在重複項目，則Resource剖面項目會取代Globals剖面項目。

範例：

Globals:
  Function:
    Environment:
      Variables:
        STAGE: Production
        TABLE_NAME: global-table

Resources:
  MyFunction:
    Type: AWS::Serverless::Function
    Properties:
      Environment:
        Variables:
          TABLE_NAME: resource-table
          NEW_VAR: hello

的環境變數設MyFunction定為下列項目：

{
  "STAGE": "Production",
  "TABLE_NAME": "resource-table",
  "NEW_VAR": "hello"
}

列表是可添加的

列表也被稱為數組。

Globals區段中的清單項目會附加在區段中的清單之Resources前。

範例：

Globals:
  Function:
    VpcConfig:
      SecurityGroupIds:
        - sg-123
        - sg-456

Resources:
  MyFunction:
    Type: AWS::Serverless::Function
    Properties:
      VpcConfig:
        SecurityGroupIds:
          - sg-first

for SecurityGroupIds 設定VpcConfig為下列項目：MyFunction

[ "sg-123", "sg-456", "sg-first" ]