public class UpdateDataRetentionRequest extends AmazonWebServiceRequest implements java.io.Serializable
Increases or decreases the stream's data retention period by the value that
you specify. To indicate whether you want to increase or decrease the data
retention period, specify the Operation
parameter in the request
body. In the request, you must specify either the StreamName
or
the StreamARN
.
The retention period that you specify replaces the current value.
This operation requires permission for the
KinesisVideo:UpdateDataRetention
action.
Changing the data retention period affects the data in the stream as follows:
If the data retention period is increased, existing data is retained for the new retention period. For example, if the data retention period is increased from one hour to seven hours, all existing data is retained for seven hours.
If the data retention period is decreased, existing data is retained for the new retention period. For example, if the data retention period is decreased from seven hours to one hour, all existing data is retained for one hour, and any data older than one hour is deleted immediately.
Constructor and Description |
---|
UpdateDataRetentionRequest() |
Modifier and Type | Method and Description |
---|---|
boolean |
equals(java.lang.Object obj) |
java.lang.String |
getCurrentVersion()
The version of the stream whose retention period you want to change.
|
java.lang.Integer |
getDataRetentionChangeInHours()
The retention period, in hours.
|
java.lang.String |
getOperation()
Indicates whether you want to increase or decrease the retention period.
|
java.lang.String |
getStreamARN()
The Amazon Resource Name (ARN) of the stream whose retention period you
want to change.
|
java.lang.String |
getStreamName()
The name of the stream whose retention period you want to change.
|
int |
hashCode() |
void |
setCurrentVersion(java.lang.String currentVersion)
The version of the stream whose retention period you want to change.
|
void |
setDataRetentionChangeInHours(java.lang.Integer dataRetentionChangeInHours)
The retention period, in hours.
|
void |
setOperation(java.lang.String operation)
Indicates whether you want to increase or decrease the retention period.
|
void |
setOperation(UpdateDataRetentionOperation operation)
Indicates whether you want to increase or decrease the retention period.
|
void |
setStreamARN(java.lang.String streamARN)
The Amazon Resource Name (ARN) of the stream whose retention period you
want to change.
|
void |
setStreamName(java.lang.String streamName)
The name of the stream whose retention period you want to change.
|
java.lang.String |
toString()
Returns a string representation of this object; useful for testing and
debugging.
|
UpdateDataRetentionRequest |
withCurrentVersion(java.lang.String currentVersion)
The version of the stream whose retention period you want to change.
|
UpdateDataRetentionRequest |
withDataRetentionChangeInHours(java.lang.Integer dataRetentionChangeInHours)
The retention period, in hours.
|
UpdateDataRetentionRequest |
withOperation(java.lang.String operation)
Indicates whether you want to increase or decrease the retention period.
|
UpdateDataRetentionRequest |
withOperation(UpdateDataRetentionOperation operation)
Indicates whether you want to increase or decrease the retention period.
|
UpdateDataRetentionRequest |
withStreamARN(java.lang.String streamARN)
The Amazon Resource Name (ARN) of the stream whose retention period you
want to change.
|
UpdateDataRetentionRequest |
withStreamName(java.lang.String streamName)
The name of the stream whose retention period you want to change.
|
clone, getCloneRoot, getCloneSource, getGeneralProgressListener, getRequestClientOptions, getRequestCredentials, getRequestMetricCollector, setGeneralProgressListener, setRequestCredentials, setRequestMetricCollector, withGeneralProgressListener, withRequestMetricCollector
public java.lang.String getStreamName()
The name of the stream whose retention period you want to change.
Constraints:
Length: 1 - 256
Pattern: [a-zA-Z0-9_.-]+
The name of the stream whose retention period you want to change.
public void setStreamName(java.lang.String streamName)
The name of the stream whose retention period you want to change.
Constraints:
Length: 1 - 256
Pattern: [a-zA-Z0-9_.-]+
streamName
- The name of the stream whose retention period you want to change.
public UpdateDataRetentionRequest withStreamName(java.lang.String streamName)
The name of the stream whose retention period you want to change.
Returns a reference to this object so that method calls can be chained together.
Constraints:
Length: 1 - 256
Pattern: [a-zA-Z0-9_.-]+
streamName
- The name of the stream whose retention period you want to change.
public java.lang.String getStreamARN()
The Amazon Resource Name (ARN) of the stream whose retention period you want to change.
Constraints:
Length: 1 - 1024
Pattern:
arn:aws:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+
The Amazon Resource Name (ARN) of the stream whose retention period you want to change.
public void setStreamARN(java.lang.String streamARN)
The Amazon Resource Name (ARN) of the stream whose retention period you want to change.
Constraints:
Length: 1 - 1024
Pattern:
arn:aws:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+
streamARN
- The Amazon Resource Name (ARN) of the stream whose retention period you want to change.
public UpdateDataRetentionRequest withStreamARN(java.lang.String streamARN)
The Amazon Resource Name (ARN) of the stream whose retention period you want to change.
Returns a reference to this object so that method calls can be chained together.
Constraints:
Length: 1 - 1024
Pattern:
arn:aws:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+
streamARN
- The Amazon Resource Name (ARN) of the stream whose retention period you want to change.
public java.lang.String getCurrentVersion()
The version of the stream whose retention period you want to change. To
get the version, call either the DescribeStream
or the
ListStreams
API.
Constraints:
Length: 1 - 64
Pattern: [a-zA-Z0-9]+
The version of the stream whose retention period you want to
change. To get the version, call either the
DescribeStream
or the ListStreams
API.
public void setCurrentVersion(java.lang.String currentVersion)
The version of the stream whose retention period you want to change. To
get the version, call either the DescribeStream
or the
ListStreams
API.
Constraints:
Length: 1 - 64
Pattern: [a-zA-Z0-9]+
currentVersion
-
The version of the stream whose retention period you want to
change. To get the version, call either the
DescribeStream
or the ListStreams
API.
public UpdateDataRetentionRequest withCurrentVersion(java.lang.String currentVersion)
The version of the stream whose retention period you want to change. To
get the version, call either the DescribeStream
or the
ListStreams
API.
Returns a reference to this object so that method calls can be chained together.
Constraints:
Length: 1 - 64
Pattern: [a-zA-Z0-9]+
currentVersion
-
The version of the stream whose retention period you want to
change. To get the version, call either the
DescribeStream
or the ListStreams
API.
public java.lang.String getOperation()
Indicates whether you want to increase or decrease the retention period.
Constraints:
Allowed Values: INCREASE_DATA_RETENTION, DECREASE_DATA_RETENTION
Indicates whether you want to increase or decrease the retention period.
UpdateDataRetentionOperation
public void setOperation(java.lang.String operation)
Indicates whether you want to increase or decrease the retention period.
Constraints:
Allowed Values: INCREASE_DATA_RETENTION, DECREASE_DATA_RETENTION
operation
- Indicates whether you want to increase or decrease the retention period.
UpdateDataRetentionOperation
public UpdateDataRetentionRequest withOperation(java.lang.String operation)
Indicates whether you want to increase or decrease the retention period.
Returns a reference to this object so that method calls can be chained together.
Constraints:
Allowed Values: INCREASE_DATA_RETENTION, DECREASE_DATA_RETENTION
operation
- Indicates whether you want to increase or decrease the retention period.
UpdateDataRetentionOperation
public void setOperation(UpdateDataRetentionOperation operation)
Indicates whether you want to increase or decrease the retention period.
Constraints:
Allowed Values: INCREASE_DATA_RETENTION, DECREASE_DATA_RETENTION
operation
- Indicates whether you want to increase or decrease the retention period.
UpdateDataRetentionOperation
public UpdateDataRetentionRequest withOperation(UpdateDataRetentionOperation operation)
Indicates whether you want to increase or decrease the retention period.
Returns a reference to this object so that method calls can be chained together.
Constraints:
Allowed Values: INCREASE_DATA_RETENTION, DECREASE_DATA_RETENTION
operation
- Indicates whether you want to increase or decrease the retention period.
UpdateDataRetentionOperation
public java.lang.Integer getDataRetentionChangeInHours()
The retention period, in hours. The value you specify replaces the current value. The maximum value for this parameter is 87600 (ten years).
Constraints:
Range: 1 -
The retention period, in hours. The value you specify replaces the current value. The maximum value for this parameter is 87600 (ten years).
public void setDataRetentionChangeInHours(java.lang.Integer dataRetentionChangeInHours)
The retention period, in hours. The value you specify replaces the current value. The maximum value for this parameter is 87600 (ten years).
Constraints:
Range: 1 -
dataRetentionChangeInHours
- The retention period, in hours. The value you specify replaces the current value. The maximum value for this parameter is 87600 (ten years).
public UpdateDataRetentionRequest withDataRetentionChangeInHours(java.lang.Integer dataRetentionChangeInHours)
The retention period, in hours. The value you specify replaces the current value. The maximum value for this parameter is 87600 (ten years).
Returns a reference to this object so that method calls can be chained together.
Constraints:
Range: 1 -
dataRetentionChangeInHours
- The retention period, in hours. The value you specify replaces the current value. The maximum value for this parameter is 87600 (ten years).
public java.lang.String toString()
toString
in class java.lang.Object
Object.toString()
public int hashCode()
hashCode
in class java.lang.Object
public boolean equals(java.lang.Object obj)
equals
in class java.lang.Object
Copyright © 2018 Amazon Web Services, Inc. All Rights Reserved.