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

AWS::SageMaker::Model ContainerDefinition

描述容器,属于模型定义的一部分。

语法

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

JSON

{ "ContainerHostname" : String, "Environment" : Json, "Image" : String, "Mode" : String, "ModelDataUrl" : String }

YAML

ContainerHostname: String Environment: Json Image: String Mode: String ModelDataUrl: String

属性

ContainerHostname

对于仅包含一个 PrimaryContainer 的模型,将忽略此参数。

ContainerDefinition 属于某个推理管道时,参数的值唯一标识用于日志记录和指标用途的容器。有关信息,请参阅使用日志和指标监控推理管道。如果您没有为属于推理管道的 ContainerDefinition 指定此参数的值,则根据管道中的 ContainerDefinition 部分自动分配唯一名称。如果您为属于推理管道的任意 ContainerDefinition 指定了 ContainerHostName 的值,您必须为该管道中的每个 ContainerDefinition 指定 ContainerHostName 参数的值。

必需:否

类型:字符串

最高63

模式^[a-zA-Z0-9](-*[a-zA-Z0-9])*

Update requires: Replacement

Environment

要在 Docker 容器中设置的环境变量。Environment 字符串到字符串映射中的每个键和值的长度最多为 1024。我们允许映射中最多有 16 个条目。

必需:否

类型:Json

Update requires: Replacement

Image

用于存储推理代码的 Amazon EC2 Container Registry (Amazon ECR) 路径。如果您使用自己的自定义算法而非 Amazon SageMaker 提供的算法,则推理代码必须满足 Amazon SageMaker 要求。Amazon SageMaker 支持 registry/repository[:tag]registry/repository[@digest] 映像路径格式。有关更多信息,请参阅将您自己的算法和 Amazon SageMaker 一起使用

必需:是

类型:字符串

最高255

模式[\S]+

Update requires: Replacement

Mode

容器托管单个模型还是多个模型。

必需:否

类型:字符串

允许的值MultiModel | SingleModel

Update requires: Replacement

ModelDataUrl

用于存储模型项目(通过模型训练获得)的 S3 路径。此路径必须指向单个 gzip 压缩 tar 存档文件(.tar.gz 后缀)。Amazon SageMaker 内置算法需要 S3 路径,但如果您使用自己的算法,则不需要该路径。有关内置算法的更多信息,请参阅常见参数

如果您提供此参数的值,Amazon SageMaker 使用 AWS Security Token Service 从您提供的 S3 路径下载模型构件。默认情况下,您的 IAM 用户账户中会激活 AWS STS。如果您之前已停用某个区域的 AWS STS,则需要重新激活该区域的 AWS STS。有关更多信息,请参阅 AWS Identity and Access Management 用户指南中的在 AWS 区域中激活和停用 AWS STS

重要

如果您使用内置算法创建模型,则 Amazon SageMaker 会要求您提供 ModelDataUrl 中模型构件的 S3 路径。

必需:否

类型:字符串

最高1024

模式^(https|s3)://([^/]+)/?(.*)$

Update requires: Replacement