你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
ContainerProperties.DefaultTimeToLive 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
从 Azure Cosmos 服务获取容器中项的默认生存时间(以秒为单位)。
public int? DefaultTimeToLive { get; set; }
member this.DefaultTimeToLive : Nullable<int> with get, set
Public Property DefaultTimeToLive As Nullable(Of Integer)
属性值
它是一个可选属性。
有效值必须是非零正时间跨度或 null
。
默认情况下,DefaultTimeToLive 设置为 null,这意味着容器的生存时间已关闭。
度量单位为秒。 允许的最大值为2147483647。
示例
下面的示例禁用容器的生存时间。
container.DefaultTimeToLive = null;
下面的示例在容器上启用生存时间。 默认情况下,所有项永不过期。
container.DefaultTimeToLive = TimeSpan.FromDays(2);
下面的示例在容器上启用生存时间。 默认情况下,该项将在自上次写入后 1000 秒后过期。
container.DefaultTimeToLive = TimeSpan.FromSeconds(1000);
注解
DefaultTimeToLive将应用于容器中的所有项,作为默认生存时间策略。 单个项可以通过设置生存时间来替代默认生存时间策略。
DefaultTimeToLive当 为 null
时,将为容器关闭生存时间。 这意味着所有项永远不会过期。 将忽略单个项的生存时间。
DefaultTimeToLive当 为“-1”时,将为容器打开生存时间。 默认情况下,所有项永远不会过期。 可以通过设置单个项的生存时间,为其指定特定的生存时间值。 项目的生存时间将得到遵守,过期的项目将在后台删除。
DefaultTimeToLive当 为非零正整数时,将为容器打开生存时间。 默认生存时间(以秒为单位)将应用于所有项。 项将在指定值(以秒为单位)后 DefaultTimeToLive 过期,自上次写入时间以来。