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

AWS::ImageBuilder::Image

映像构建版本。映像是一个自定义、安全且最新的“黄金”服务器映像,它预先安装并预先配置了软件和设置,以满足特定的 IT 标准。

语法

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

JSON

{ "Type" : "AWS::ImageBuilder::Image", "Properties" : { "DistributionConfigurationArn" : String, "EnhancedImageMetadataEnabled" : Boolean, "ImageRecipeArn" : String, "ImageTestsConfiguration" : ImageTestsConfiguration, "InfrastructureConfigurationArn" : String, "Tags" : {Key : Value, ...} } }

YAML

Type: AWS::ImageBuilder::Image Properties: DistributionConfigurationArn: String EnhancedImageMetadataEnabled: Boolean ImageRecipeArn: String ImageTestsConfiguration: ImageTestsConfiguration InfrastructureConfigurationArn: String Tags: Key : Value

属性

DistributionConfigurationArn

此分发配置的 Amazon 资源名称 (ARN)。

必需:否

类型:字符串

模式^arn:aws[^:]*:imagebuilder:[^:]+:(?:\d{12}|aws):(?:image-recipe|infrastructure-configuration|distribution-configuration|component|image|image-pipeline)/[a-z0-9-_]+(?:/(?:(?:x|\d+)\.(?:x|\d+)\.(?:x|\d+))(?:/\d+)?)?$

Update requires: Replacement

EnhancedImageMetadataEnabled

收集有关正在创建的映像的其他信息,包括操作系统 (OS) 版本和程序包列表。此信息用于增强使用 EC2 映像生成器的整体体验。默认情况下启用。

必需:否

类型:布尔值

Update requires: Replacement

ImageRecipeArn

映像配方的 Amazon 资源名称 (ARN)。

必需:是

类型:字符串

模式^arn:aws[^:]*:imagebuilder:[^:]+:(?:\d{12}|aws):(?:image-recipe|infrastructure-configuration|distribution-configuration|component|image|image-pipeline)/[a-z0-9-_]+(?:/(?:(?:x|\d+)\.(?:x|\d+)\.(?:x|\d+))(?:/\d+)?)?$

Update requires: Replacement

ImageTestsConfiguration

创建此映像时使用的映像测试的配置。

必需:否

类型ImageTestsConfiguration

Update requires: Replacement

InfrastructureConfigurationArn

用于创建此映像的基础设施配置的 Amazon 资源名称 (ARN)。

必需:是

类型:字符串

模式^arn:aws[^:]*:imagebuilder:[^:]+:(?:\d{12}|aws):(?:image-recipe|infrastructure-configuration|distribution-configuration|component|image|image-pipeline)/[a-z0-9-_]+(?:/(?:(?:x|\d+)\.(?:x|\d+)\.(?:x|\d+))(?:/\d+)?)?$

Update requires: Replacement

Tags

映像的标签。

必需:否

类型:字符串的映射

Update requires: Replacement

返回值

Ref

在将此资源的逻辑 ID 传递给内部 Ref 函数时,Ref 返回 资源 ARN,如 arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-image

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

Fn::GetAtt

Fn::GetAtt 内部函数返回此类型的一个指定属性的值。以下为可用属性和示例返回值。

有关使用 Fn::GetAtt 内部函数的更多信息,请参阅 Fn::GetAtt

Arn

返回映像的 Amazon 资源名称 (ARN)。例如:arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/1

ImageId

返回使用映像生成器的区域中 EC2 AMI 的 AMI ID。

示例

创建镜像

以下示例同时以 YAML 和 JSON 格式显示 Image 资源文档的所有参数的架构。

YAML

Resources: ImageAllParameters: Type: 'AWS::ImageBuilder::Image' Properties: ImageRecipeArn: !Ref ImageRecipeArn InfrastructureConfigurationArn: !Ref InfrastructureConfigurationArn DistributionConfigurationArn: !Ref DistributionConfigurationArn ImageTestsConfiguration: ImageTestsEnabled: false TimeoutMinutes: 60 Tags: CustomerImageTagKey1: 'CustomerImageTagValue1' CustomerImageTagKey2: 'CustomerImageTagValue2'

JSON

{ "Resources": { "ImageAllParameters": { "Type": "AWS::ImageBuilder::Image", "Properties": { "ImageRecipeArn": { "Ref": "ImageRecipeArn" }, "InfrastructureConfigurationArn": { "Ref": "InfrastructureConfigurationArn" }, "DistributionConfigurationArn": { "Ref": "DistributionConfigurationArn" }, "ImageTestsConfiguration": { "ImageTestsEnabled": false, "TimeoutMinutes": 60 }, "Tags": { "CustomerImageTagKey1": "CustomerImageTagValue1", "CustomerImageTagKey2": "CustomerImageTagValue2" } } } } }