View a markdown version of this page

AWS::Serverless::Connettore - AWS Serverless Application Model

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

AWS::Serverless::Connettore

Configura le autorizzazioni tra due risorse. Per un'introduzione ai connettori, vedere Gestione delle autorizzazioni delle risorse con AWS SAM connettori.

Per ulteriori informazioni sui generati AWS CloudFormation risorse, vedi CloudFormation risorse generate quando si specifica AWS::Serverless::Connector.

Per fornire un feedback sui connettori, invia un nuovo problema al modello di applicazione serverless AWS GitHub magazzino.

Nota

Quando esegui il deployment su AWS CloudFormation, AWS SAM trasforma il tuo AWS SAM risorse in CloudFormation risorse. Per ulteriori informazioni, consulta Generato CloudFormation risorse per AWS SAM.

Sintassi

Per dichiarare questa entità nel tuo AWS Serverless Application Model (AWS SAM) modello, utilizzare una delle seguenti sintassi.

Nota

Si consiglia di utilizzare la sintassi dei connettori incorporati per la maggior parte dei casi d'uso. L'integrazione nella risorsa sorgente ne facilita la lettura e la gestione nel tempo. Quando è necessario fare riferimento a una risorsa sorgente che non si trova nella stessa AWS SAM modello, ad esempio una risorsa in uno stack annidato o una risorsa condivisa, usa il AWS::Serverless::Connector sintassi.

Connettori integrati

<source-resource-logical-id>: Connectors: <connector-logical-id: Properties: Destination: ResourceReference | List of ResourceReference Permissions: List SourceReference: SourceReference

AWS::Serverless::Connettore

Type: AWS::Serverless::Connector Properties: Destination: ResourceReference | List of ResourceReference Permissions: List Source: ResourceReference

Properties

Destination

La risorsa di destinazione.

Tipo: ResourceReference | Elenco di ResourceReference

Obbligatorio: sì

CloudFormation compatibilità: Questa proprietà è unica per AWS SAM e non ha un CloudFormation equivalente.

Permissions

Il tipo di autorizzazione che la risorsa di origine è autorizzata a eseguire sulla risorsa di destinazione.

Read include AWS Identity and Access Management (IAM) azioni che consentono la lettura dei dati dalla risorsa.

Write include azioni IAM che consentono di avviare e scrivere dati su una risorsa.

Valori validi: Read o Write

Tipo: elenco

Obbligatorio: sì

CloudFormation compatibilità: Questa proprietà è unica per AWS SAM e non ha un CloudFormation equivalente.

Source

La risorsa di origine. Obbligatorio quando si utilizza AWS::Serverless::Connector sintassi.

Tipo: ResourceReference

Required: Conditional

CloudFormation compatibilità: Questa proprietà è unica per AWS SAM e non ha un CloudFormation equivalente.

SourceReference

La risorsa di origine.

Nota

Da utilizzare con la sintassi dei connettori incorporati quando si definiscono proprietà aggiuntive per la risorsa di origine.

Tipo: SourceReference

Obbligatorio: no

CloudFormation compatibilità: Questa proprietà è unica per AWS SAM e non ha un CloudFormation equivalente.

Esempi

Connettori integrati

L'esempio seguente utilizza connettori incorporati per definire un Write connessione dati tra un AWS Lambda Funzione evento e tabella Amazon DynamoDB:

Transform: AWS::Serverless-2016-10-31 ... Resources: MyTable: Type: AWS::Serverless::SimpleTable MyFunction: Type: AWS::Serverless::Function Connectors: MyConn: Properties: Destination: Id: MyTable Permissions: - Write ...

L'esempio seguente utilizza connettori incorporati per definire Read e Write autorizzazioni:

Transform: AWS::Serverless-2016-10-31 ... Resources: MyFunction: Type: AWS::Serverless::Function Connectors: MyConn: Properties: Destination: Id: MyTable Permissions: - Read - Write MyTable: Type: AWS::DynamoDB::Table ...

L'esempio seguente utilizza connettori incorporati per definire una risorsa di origine con una proprietà diversa da Id:

Transform: AWS::Serverless-2016-10-31 ... Resources: MyApi: Type: AWS::Serverless::Api Connectors: ApitoLambdaConn: Properties: SourceReference: Qualifier: Prod/GET/foobar Destination: Id: MyTable Permissions: - Read - Write MyTable: Type: AWS::DynamoDB::Table ...

AWS::Serverless:: Connettore

L'esempio seguente utilizza AWS::Serverless::Connettore risorsa per avere un AWS Lambda funzione di lettura e scrittura su una tabella Amazon DynamoDB:

MyConnector: Type: AWS::Serverless::Connector Properties: Source: Id: MyFunction Destination: Id: MyTable Permissions: - Read - Write

L'esempio seguente utilizza AWS::Serverless::Connettore risorsa per fare in modo che una funzione Lambda scriva su un argomento Amazon SNS, con entrambe le risorse nello stesso modello:

MyConnector: Type: AWS::Serverless::Connector Properties: Source: Id: MyLambda Destination: Id: MySNSTopic Permissions: - Write

L'esempio seguente utilizza AWS::Serverless::Connettore risorsa per fare in modo che un argomento Amazon SNS scriva su una funzione Lambda, che quindi scrive su una tabella Amazon DynamoDB, con tutte le risorse nello stesso modello:

Transform: AWS::Serverless-2016-10-31 Resources: Topic: Type: AWS::SNS::Topic Properties: Subscription: - Endpoint: !GetAtt Function.Arn Protocol: lambda Function: Type: AWS::Serverless::Function Properties: Runtime: nodejs16.x Handler: index.handler InlineCode: | const AWS = require('aws-sdk'); exports.handler = async (event, context) => { const docClient = new AWS.DynamoDB.DocumentClient(); await docClient.put({ TableName: process.env.TABLE_NAME, Item: { id: context.awsRequestId, event: JSON.stringify(event) } }).promise(); }; Environment: Variables: TABLE_NAME: !Ref Table Table: Type: AWS::Serverless::SimpleTable TopicToFunctionConnector: Type: AWS::Serverless::Connector Properties: Source: Id: Topic Destination: Id: Function Permissions: - Write FunctionToTableConnector: Type: AWS::Serverless::Connector Properties: Source: Id: Function Destination: Id: Table Permissions: - Write

Quanto segue è la trasformazione AWS CloudFormation modello tratto dall'esempio precedente:

"FunctionToTableConnectorPolicy": { "Type": "AWS::IAM::ManagedPolicy", "Metadata": { "aws:sam:connectors": { "FunctionToTableConnector": { "Source": { "Type": "AWS::Lambda::Function" }, "Destination": { "Type": "AWS::DynamoDB::Table" } } } }, "Properties": { "PolicyDocument": { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "dynamodb:PutItem", "dynamodb:UpdateItem", "dynamodb:DeleteItem", "dynamodb:BatchWriteItem", "dynamodb:PartiQLDelete", "dynamodb:PartiQLInsert", "dynamodb:PartiQLUpdate" ], "Resource": [ { "Fn::GetAtt": [ "MyTable", "Arn" ] }, { "Fn::Sub": [ "${DestinationArn}/index/*", { "DestinationArn": { "Fn::GetAtt": [ "MyTable", "Arn" ] } } ] } ] } ] }, "Roles": [ { "Ref": "MyFunctionRole" } ] } }