As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
CloudFormationrecursos gerados quando AWS::Serverless::Function é especificado
Quando um AWS::Serverless::Function é especificado, AWS Serverless Application Model (AWS SAM) gera um recurso AWS::Lambda::Function com base CloudFormation.
AWS::Lambda::Function-
LogicalId:<function‑LogicalId>Propriedade referenciável: N/A (você deve usar o
LogicalIdpara referenciar este recurso CloudFormation)
Além desse recurso CloudFormation, quando AWS::Serverless::Function especificado, AWS SAM também gera recursos CloudFormation para os seguintes cenários.
Propriedades da função principal
Os cenários a seguir geram recursos do CloudFormation com base nas propriedades da função principal:
A propriedade da função não foi especificada
Quando a propriedade Role de um AWS::Serverless::Function não é especificada, o AWS SAM gera um recurso AWS::IAM::Role do CloudFormation.
AWS::IAM::Role-
LogicalId:<function‑LogicalId>RolePropriedade referenciável: N/A (você deve usar o
LogicalIdpara referenciar este recurso CloudFormation)
A propriedade AutoPublishAlias é especificada
Quando a propriedadeAutoPublishAlias de um AWS::Serverless::Function é especificada, AWS SAM gera os seguintes recursos CloudFormation: AWS::Lambda::Alias e AWS::Lambda::Version.
AWS::Lambda::Alias-
LogicalId:<function‑LogicalId>Alias<alias‑name>é a string que está definida como<alias‑name>AutoPublishAlias.Por exemplo, se vocêAutoPublishAliasdefinir comolive,LogicalIdé:myFunction Alias live.Propriedade referenciável:
<function‑LogicalId>.Alias AWS::Lambda::Version-
LogicalId:<function‑LogicalId>Version<sha>O
é um valor de hash exclusivo que é gerado quando a pilha é criada.<sha>Por exemplo,MyFunctionVersion 926eeb5ff1.Propriedade referenciável:
<function‑LogicalId>.Version
Para obter informações adicionais sobre a propriedade AutoPublishAlias, consulte a seção de Propriedades de AWS::Serverless::Function.
A propriedade DeploymentPreference é especificada
Quando a propriedadeDeploymentPreference de um AWS::Serverless::Function é especificada, AWS SAM gera os seguintes recursos CloudFormation: AWS::CodeDeploy::Application e AWS::CodeDeploy::DeploymentGroup. Além disso, se a propriedade Role do objeto DeploymentPreference não for especificada, o AWS SAM também gera um recurso AWS::IAM::Role do CloudFormation.
AWS::CodeDeploy::Application-
LogicalId:ServerlessDeploymentApplicationPropriedade referenciável: N/A (você deve usar o
LogicalIdpara referenciar este recurso CloudFormation)
AWS::CodeDeploy::DeploymentGroup-
LogicalId:<function‑LogicalId>DeploymentGroupPropriedade referenciável: N/A (você deve usar o
LogicalIdpara referenciar este recurso CloudFormation) AWS::IAM::Role-
LogicalId:CodeDeployServiceRolePropriedade referenciável: N/A (você deve usar o
LogicalIdpara referenciar este recurso CloudFormation)
A propriedade FunctionUrlConfig é especificada
Quando a propriedade FunctionUrlConfig é especificada, o AWS SAM gera recursos do CloudFormation diferentes com base no AuthType.
Quando o AuthType: NONE é especificado, o AWS SAM gera os seguintes recursos do CloudFormation:
AWS::Lambda::Permission(Invocar acesso)-
LogicalId:<function‑LogicalId>URLInvokeAllowPublicAccessPropriedade referenciável: N/A (você deve usar o
LogicalIdpara referenciar este recurso CloudFormation) AWS::Lambda::Permission(Acesso público)-
LogicalId:<function‑LogicalId>UrlPublicPermissionsPropriedade referenciável: N/A (você deve usar o
LogicalIdpara referenciar este recurso CloudFormation) AWS::Lambda::Url-
LogicalId:<function‑LogicalId>UrlPropriedade referenciável: N/A (você deve usar o
LogicalIdpara referenciar este recurso CloudFormation)
Quando o AuthType: AWS_IAM é especificado, o AWS SAM gera somente:
AWS::Lambda::Url-
LogicalId:<function‑LogicalId>UrlPropriedade referenciável: N/A (você deve usar o
LogicalIdpara referenciar este recurso CloudFormation)
Para obter mais informações sobre a propriedade FunctionUrlConfig, consulte FunctionUrlConfig.
Origens de eventos
Os cenários a seguir geram recursos do CloudFormation com base em fontes de eventos:
Uma fonte de eventos da Api é especificada
Quando a propriedade Event de um AWS::Serverless::Function é definida como Api, mas a propriedade RestApiId não é especificada, AWS SAM gera o recurso AWS::ApiGateway::RestApi CloudFormation.
AWS::ApiGateway::RestApi-
LogicalId:ServerlessRestApiPropriedade referenciável: N/A (você deve usar o
LogicalIdpara referenciar este recurso CloudFormation)
Uma fonte de eventos HttpAPI é especificada
Quando a propriedade Event de um AWS::Serverless::Function é definida como HttpApi, mas a propriedade ApiId não é especificada, AWS SAM gera o recurso AWS::ApiGatewayV2::Api CloudFormation.
AWS::ApiGatewayV2::Api-
LogicalId:ServerlessHttpApiPropriedade referenciável: N/A (você deve usar o
LogicalIdpara referenciar este recurso CloudFormation)
Uma fonte de eventos de streaming é especificada
Quando a propriedade Event de um AWS::Serverless::Function é definida como um dos tipos de streaming, AWS SAM gera o recurso AWS::Lambda::EventSourceMapping CloudFormation. Isso se aplica aos seguintes tipos: DynamoDB, Kinesis, MQ, MSK e SQS.
AWS::Lambda::EventSourceMapping-
LogicalId:<function‑LogicalId><event‑LogicalId>Propriedade referenciável: N/A (você deve usar o
LogicalIdpara referenciar este recurso CloudFormation)
Uma fonte de eventos de ponte de eventos (ou barramento de eventos) é especificada
Quando a propriedade Event de um AWS::Serverless::Function é definida como um dos tipos de ponte de eventos (ou barramento de eventos), AWS SAM gera o recurso AWS::Events::Rule CloudFormation. Isso se aplica aos seguintes tipos: EventBridgeRule, Schedule e CloudWatchEvents.
AWS::Events::Rule-
LogicalId:<function‑LogicalId><event‑LogicalId>Propriedade referenciável: N/A (você deve usar o
LogicalIdpara referenciar este CloudFormation recurso)
Uma fonte de eventos IoTRule é especificada
Quando a propriedade Event de um AWS::Serverless::Function é definida como IotRule, AWS SAM gera o recurso AWS::IoT::TopicRule CloudFormation.
AWS::IoT::TopicRule-
LogicalId:<function‑LogicalId><event‑LogicalId>Propriedade referenciável: N/A (você deve usar o
LogicalIdpara referenciar este CloudFormation recurso)
Configuração do evento
Os cenários a seguir geram recursos do CloudFormation com base na configuração do evento:
A propriedade OnSuccess (ou OnFailure) é especificada para eventos do Amazon SNS
Quando a propriedade OnSuccess (ouOnFailure) da propriedade DestinationConfig da propriedade EventInvokeConfig de uma AWS::Serverless::Function é especificada e o tipo de destino é SNS, mas o ARN de destino não está especificado, AWS SAM gera os seguintes recursos CloudFormation: AWS::Lambda::EventInvokeConfig e AWS::SNS::Topic.
AWS::Lambda::EventInvokeConfig-
LogicalId:<function‑LogicalId>EventInvokeConfigPropriedade referenciável: N/A (você deve usar o
LogicalIdpara referenciar este CloudFormation recurso) AWS::SNS::Topic-
LogicalId:(ou<function‑LogicalId>OnSuccessTopic)<function‑LogicalId>OnFailureTopicPropriedade referenciável:
<function‑LogicalId>.DestinationTopicSe ambos
OnSuccesseOnFailureforem especificados para um evento do Amazon SNS, para distinguir entre os recursos gerados, você deverá usar oLogicalId.
A propriedade OnSuccess (ou OnFailure) é especificada para eventos do Amazon SQS
Quando a propriedade OnSuccess (ouOnFailure) da propriedade DestinationConfig da propriedade EventInvokeConfig de uma AWS::Serverless::Function é especificada e o tipo de destino é SQS, mas o ARN de destino não está especificado, AWS SAM gera os seguintes recursos CloudFormation: AWS::Lambda::EventInvokeConfig e AWS::SQS::Queue.
AWS::Lambda::EventInvokeConfig-
LogicalId:<function‑LogicalId>EventInvokeConfigPropriedade referenciável: N/A (você deve usar o
LogicalIdpara referenciar este CloudFormation recurso) AWS::SQS::Queue-
LogicalId:(ou<function‑LogicalId>OnSuccessQueue)<function‑LogicalId>OnFailureQueuePropriedade referenciável:
<function‑LogicalId>.DestinationQueueSe ambos
OnSuccesseOnFailureforem especificados para um evento do Amazon SQS, para distinguir entre os recursos gerados, você deverá usar oLogicalId.