AWS::Greengrass::CoreDefinitionVersion - AWS CloudFormation
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

AWS::Greengrass::CoreDefinitionVersion

AWS::Greengrass::CoreDefinitionVersion 资源表示 AWS IoT Greengrass 的核心定义版本。核心定义版本包含 Greengrass 核心。

注意

要创建核心定义版本,您必须指定要与此版本关联的核心定义的 ID。有关创建核心定义的信息,请参阅 AWS::Greengrass::CoreDefinition

在创建包含要部署的核心的核心定义版本后,您必须将其添加到组版本。有关更多信息,请参阅 AWS::Greengrass::Group

语法

要在 AWS CloudFormation 模板中声明此实体,请使用以下语法:

JSON

{ "Type" : "AWS::Greengrass::CoreDefinitionVersion", "Properties" : { "CoreDefinitionId" : String, "Cores" : [ Core, ... ] } }

YAML

Type: AWS::Greengrass::CoreDefinitionVersion Properties: CoreDefinitionId: String Cores: - Core

属性

CoreDefinitionId

与此版本关联的核心定义的 ID。此值是 GUID。

必需:是

类型:字符串

Update requires: Replacement

Cores

此版本中的 Greengrass 核心。目前,核心定义版本的 Cores 属性只能包含一个核心。

必需:是

类型Core 的列表

Update requires: Replacement

返回值

Ref

在将此资源的逻辑 ID 传递给内部 Ref 函数时,Ref 返回核心定义版本的 Amazon 资源名称 (ARN),例如 arn:aws:greengrass:us-east-1:123456789012:/greengrass/definition/cores/1234a5b6-78cd-901e-2fgh-3i45j6k178l9/versions/9876ac30-4bdb-4f9d-95af-b5fdb66be1a2

For more information about using the Ref function, see Ref.

示例

创建核心定义版本

以下示例创建两个资源:一个核心定义和一个包含核心的核心定义版本。

该模板使用 Ref 函数以提供核心定义版本的 CoreDefinitionId(它将版本与核心定义关联)。该模板使用参数来表示要用于核心的核心定义名称和 ID、事物 ARN 和证书 ARN。它还输出新核心定义的 ID 和新核心定义版本的 ARN。

有关其他模板示例,请参阅 AWS::Greengrass::Group 资源。

JSON

{ "Description": "Create CoreDefinition and associated CoreDefinitionVersion", "Parameters": { "CoreDefinitionName": { "Type": "String", "Default": "TestCoreDefinition" }, "CoreId": { "Type": "String", "Default": "TestCoreId" }, "CoreThingArn": { "Type": "String", "Default": "TestCoreThingArn" }, "CoreCertificateArn": { "Type": "String", "Default": "TestCoreCertArn" } }, "Resources": { "CoreDefinition": { "Type": "AWS::Greengrass::CoreDefinition", "Properties": { "Name": { "Ref": "CoreDefinitionName" } } }, "CoreDefinitionVersion": { "Type": "AWS::Greengrass::CoreDefinitionVersion", "Properties": { "CoreDefinitionId": { "Ref": "CoreDefinition" }, "Cores": [ { "Id": { "Ref": "CoreId" }, "CertificateArn": { "Ref": "CoreCertificateArn" }, "ThingArn": { "Ref": "CoreThingArn" }, "SyncShadow": "true" } ] } } }, "Outputs": { "CoreDefinitionId": { "Value": { "Ref": "CoreDefinition" } }, "CoreDefinitionVersionArn": { "Value": { "Ref": "CoreDefinitionVersion" } } } }

YAML

Description: Create CoreDefinition and associated CoreDefinitionVersion Parameters: CoreDefinitionName: Type: String Default: TestCoreDefinition CoreId: Type: String Default: TestCoreId CoreThingArn: Type: String Default: TestCoreThingArn CoreCertificateArn: Type: String Default: TestCoreCertArn Resources: CoreDefinition: Type: 'AWS::Greengrass::CoreDefinition' Properties: Name: !Ref CoreDefinitionName CoreDefinitionVersion: Type: 'AWS::Greengrass::CoreDefinitionVersion' Properties: CoreDefinitionId: !Ref CoreDefinition Cores: - Id: !Ref CoreId CertificateArn: !Ref CoreCertificateArn ThingArn: !Ref CoreThingArn SyncShadow: 'true' Outputs: CoreDefinitionId: Value: !Ref CoreDefinition CoreDefinitionVersionArn: Value: !Ref CoreDefinitionVersion

另请参阅