ContainerProperties.DefaultTimeToLive Eigenschaft

Definition

Namespace:

Microsoft.Azure.Cosmos

Assembly:

Microsoft.Azure.Cosmos.Client.dll

Paket:

Microsoft.Azure.Cosmos v3.39.0

Quelle:

ContainerProperties.cs

Ruft die Standardlebensdauer in Sekunden für ein Element in einem Container aus dem Azure Cosmos-Dienst ab oder legt diese fest.

[Newtonsoft.Json.JsonProperty(NullValueHandling=Newtonsoft.Json.NullValueHandling.Ignore, PropertyName="defaultTtl")]
public int? DefaultTimeToLive { get; set; }

[<Newtonsoft.Json.JsonProperty(NullValueHandling=Newtonsoft.Json.NullValueHandling.Ignore, PropertyName="defaultTtl")>]
member this.DefaultTimeToLive : Nullable<int> with get, set

Public Property DefaultTimeToLive As Nullable(Of Integer)

Eigenschaftswert

Nullable<Int32>

Es handelt sich um eine optionale Eigenschaft.

Die Maßeinheit beträgt Sekunden. Der maximal zulässige Wert ist 2147483647. Ein gültiger Wert muss entweder eine positive ganze Zahl ungleich null, '-1' oder nullsein.

Standardmäßig ist DefaultTimeToLive auf NULL festgelegt, was bedeutet, dass die Gültigkeitsdauer für den Container deaktiviert ist.

Attribute

Newtonsoft.Json.JsonPropertyAttribute

Beispiele

Im folgenden Beispiel wird die Gültigkeitsdauer für einen Container deaktiviert.

container.DefaultTimeToLive = null;

Im folgenden Beispiel wird die Gültigkeitsdauer für einen Container aktiviert. Standardmäßig laufen alle Elemente nie ab.

container.DefaultTimeToLive = -1;

Im folgenden Beispiel wird die Gültigkeitsdauer für einen Container aktiviert. Standardmäßig läuft das Element nach 1.000 Sekunden seit dem letzten Schreibvorgang ab.

container.DefaultTimeToLive = 1000;

Hinweise

Wird DefaultTimeToLive auf alle Elemente im Container als Standardrichtlinie für die Gültigkeitsdauer angewendet. Das einzelne Element kann die Standardrichtlinie für die Gültigkeitsdauer überschreiben, indem die Gültigkeitsdauer festgelegt wird.

Wenn auf DefaultTimeToLive festgelegt ist null, wird die Gültigkeitsdauer für den Container deaktiviert. Dies bedeutet, dass alle Elemente nie ablaufen. Die Gültigkeitsdauer des einzelnen Elements wird ignoriert.

Wenn " DefaultTimeToLive -1" ist, wird die Gültigkeitsdauer für den Container aktiviert. Standardmäßig laufen alle Elemente nie ab. Das einzelne Element kann einen bestimmten Time-to-Live-Wert erhalten, indem die Gültigkeitsdauer festgelegt wird. Die Gültigkeitsdauer des Elements wird berücksichtigt, und die abgelaufenen Elemente werden im Hintergrund gelöscht.

Wenn eine DefaultTimeToLive ganze Zahl ungleich null positiv ist, wird die Gültigkeitsdauer für den Container aktiviert. Und auf alle Elemente wird eine Standardmäßige Gültigkeitsdauer in Sekunden angewendet. Ein Element ist nach dem angegebenen DefaultTimeToLive Wert in Sekunden seit seiner letzten Schreibzeit abgelaufen.