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

AWS::MediaStore::Container

AWS::MediaStore::Container 资源指定要保存对象的存储容器。容器与 Amazon S3 中的存储桶类似。

当您使用 AWS CloudFormation 创建容器时,模板将管理五个 API 操作的数据:创建容器、设置访问日志记录、更新默认容器策略、添加跨源资源共享 (CORS) 策略、添加对象生命周期策略。

语法

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

JSON

{ "Type" : "AWS::MediaStore::Container", "Properties" : { "AccessLoggingEnabled" : Boolean, "ContainerName" : String, "CorsPolicy" : [ CorsRule, ... ], "LifecyclePolicy" : String, "MetricPolicy" : MetricPolicy, "Policy" : String, "Tags" : [ Tag, ... ] } }

YAML

Type: AWS::MediaStore::Container Properties: AccessLoggingEnabled: Boolean ContainerName: String CorsPolicy: - CorsRule LifecyclePolicy: String MetricPolicy: MetricPolicy Policy: String Tags: - Tag

属性

AccessLoggingEnabled

容器上的访问日志记录的状态。默认情况下,此值为 false,它指示 AWS Elemental MediaStore 不会将访问日志发送到 Amazon CloudWatch Logs。当您在容器上启用访问日志记录时,MediaStore 会将此值更改为 true,这表示该服务会将存储在容器中的对象的访问日志传输到 CloudWatch Logs。

必需:否

类型:布尔值

Update requires: No interruption

ContainerName

容器的名称。名称必须为 1 到 255 个字符。容器名称对于特定区域内的 AWS 账户必须是唯一的。例如,您可以在每个区域中创建一个名为 movies 的容器,前提是您目前没有带该名称的容器。

必需:是

类型:字符串

最低1

最高255

模式[\w-]+

Update requires: Replacement

CorsPolicy

在容器上设置跨源资源共享 (CORS) 配置,以便容器能够为跨源请求提供服务。例如,您可能希望启用源为 http://www.example.com 的请求,以使用浏览器的 XMLHttpRequest 功能访问 my.example.container.com 上的 AWS Elemental MediaStore 容器。

要在容器上启用 CORS,可以将 CORS 策略附加到容器。在 CORS 策略中,您可以配置标识源的规则以及可以在容器上执行的 HTTP 方法。该策略可以包含最多 398000 个字符。您可以向 CORS 策略添加最多 100 条规则。如果多个规则适用,此服务使用列出的第一个适用规则。

要了解有关 CORS 的更多信息,请参阅 AWS Elemental MediaStore 中的跨源资源共享 (CORS)

必需:否

类型CorsRule 的列表

Update requires: No interruption

LifecyclePolicy

将一个对象生命周期策略写入到容器。如果容器已经拥有对象生命周期策略,服务使用新的策略替换现有策略。更改最多需要 20 分钟才能生效。

有关如何构建对象生命周期策略的信息,请参阅对象生命周期策略的组件

必需:否

类型:字符串

Update requires: No interruption

MetricPolicy

与容器关联的指标策略。指标策略允许 AWS Elemental MediaStore 向 Amazon CloudWatch 发送指标。在该策略中,您必须指示是否希望 MediaStore 发送容器级别的指标。您还可以包含规则,以定义希望 MediaStore 发送对象级别指标的对象组。

要查看有关如何为您的使用案例构建指标策略的示例,请参阅指标策略示例

必需:否

类型MetricPolicy

Update requires: No interruption

Policy

为指定容器创建访问策略,以限制可访问它的用户和客户端。有关访问策略中包含的数据的信息,请参阅 AWS Identity and Access Management 用户指南

对于此版本的 REST API,一个容器只能创建一个策略。如果您输入 PutContainerPolicy 两次,则第二条命令将修改现有策略。

必需:否

类型:字符串

Update requires: No interruption

Tags

与容器关联的标签集合。每个标签包含一个键:值对,它可以是您定义的任何内容。通常,标签键表示一个类别(如“environment”),标签值表示该类别中的特定值(如“test”、“development”或“production”)。您最多可以向每个容器添加 50 个标签。有关标记的更多信息,包括命名和使用惯例,请参阅标记 MediaStore 中的资源

必需:否

类型Tag 的列表

Update requires: No interruption

返回值

Ref

在将此资源的逻辑 ID 传递给内部 Ref 函数时,Ref 返回容器的名称。

例如:{ "Ref": "myContainer" }

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

Fn::GetAtt

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

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

Endpoint

容器的 DNS 终端节点。在向数据层面发送请求时,使用终端节点标识特定容器。在创建容器时,该服务会分配此值。在分配此值后,它不会更改。