DynamoDb - AWS Serverless Application Model
语法属性

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

DynamoDb

将 Amazon DynamoDB 表配置为 GraphQL API 解析程序的数据源。

语法

要在 AWS Serverless Application Model (AWS SAM) 模板中声明此实体，请使用以下语法。

YAML

LogicalId:
  DeltaSync: DeltaSyncConfig
  Description: String
  Name: String
  Permissions: List
  Region: String
  ServiceRoleArn: String
  TableArn: String
  TableName: String
  UseCallerCredentials: Boolean
  Versioned: Boolean

属性

DeltaSync

描述增量同步配置。

类型:DeltaSyncConfig

必需：否

AWS CloudFormation 兼容性：此属性直接传递给AWS::AppSync::DataSource DynamoDBConfig对象的DeltaSyncConfig属性。

Description

数据源的描述。

类型：字符串

必需：否

AWS CloudFormation 兼容性：此属性直接传递给AWS::AppSync::DataSource资源的Description属性。

LogicalId

数据源的唯一名称。

类型：字符串

必需：是

AWS CloudFormation 兼容性：此属性直接传递给AWS::AppSync::DataSource资源的Name属性。

Name

数据源的名称。指定此属性以覆盖 LogicalId 值。

类型：字符串

必需：否

AWS CloudFormation 兼容性：此属性直接传递给AWS::AppSync::DataSource资源的Name属性。

Permissions

使用 AWS SAM 连接器 配置对数据源的权限。您可以在列表中提供以下任何值：

  • Read - 允许解析程序读取数据源。

  • Write - 允许解析程序将数据写入到数据源。

AWS SAM 使用在部署时转换的AWS::Serverless::Connector资源来配置您的权限。要了解有关生成的资源的信息，请参阅在指定了 AWS::Serverless::Connector 的情况下生成的 AWS CloudFormation 资源。

注意

您可以指定 Permissions 或 ServiceRoleArn，但不能同时指定两者。如果两者都未指定，则 AWS SAM 将生成默认值为 Read and Write。要撤消对数据源的访问权限，请从模板中移除 DynamoDB 对象。 AWS SAM

类型：列表

必需：否

AWS CloudFormation 兼容性：此属性是独有的 AWS SAM ，没有 AWS CloudFormation 等效属性。它类似于 AWS::Serverless::Connector 资源的 Permissions 属性。

Region

你的 AWS 区域 DynamoDB 表的。如果未指定，则 AWS SAM 使用AWS::Region。

类型：字符串

必需：否

AWS CloudFormation 兼容性：此属性直接传递给AWS::AppSync::DataSource DynamoDBConfig对象的AwsRegion属性。

ServiceRoleArn

数据 AWS Identity and Access Management 源的 (IAM) 服务角色 ARN。在访问数据源时，系统将代入此角色。

您可以指定 Permissions 或 ServiceRoleArn，但不能同时指定两者。

类型：字符串

必填项：否。 如果未指定，则 AWS SAM 应用的默认值Permissions。

AWS CloudFormation 兼容性：此属性直接传递给AWS::AppSync::DataSource资源的ServiceRoleArn属性。

TableArn

DynamoDB 表的 ARN。

类型：字符串

必填：条件性。如果未指定 ServiceRoleArn，则需要有 TableArn。

AWS CloudFormation 兼容性：此属性是独有的 AWS SAM ，没有 AWS CloudFormation 等效属性。

TableName

表名称。

类型：字符串

必需：是

AWS CloudFormation 兼容性：此属性直接传递给AWS::AppSync::DataSource DynamoDBConfig对象的TableName属性。

UseCallerCredentials

设置为 true 以将 IAM 与此数据源一起使用。

类型：布尔值

必需：否

AWS CloudFormation 兼容性：此属性直接传递给AWS::AppSync::DataSource DynamoDBConfig对象的UseCallerCredentials属性。

Versioned

设置为 true 以将冲突检测、冲突解决和同步与该数据源一起使用。

类型：布尔值

必需：否

AWS CloudFormation 兼容性：此属性直接传递给AWS::AppSync::DataSource DynamoDBConfig对象的Versioned属性。