/* * Copyright 2010-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). * You may not use this file except in compliance with the License. * A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either * express or implied. See the License for the specific language governing * permissions and limitations under the License. */ package com.amazonaws.services.kinesisvideo.model; import java.io.Serializable; import com.amazonaws.AmazonWebServiceRequest; /** *
* Updates stream metadata, such as the device name and media type. *
** You must provide the stream name or the Amazon Resource Name (ARN) of the * stream. *
*
* To make sure that you have the latest version of the stream before updating
* it, you can specify the stream version. Kinesis Video Streams assigns a
* version to each stream. When you update a stream, Kinesis Video Streams
* assigns a new version number. To get the latest stream version, use the
* DescribeStream
API.
*
* UpdateStream
is an asynchronous operation, and takes time to
* complete.
*
* The name of the stream whose metadata you want to update. *
** The stream name is an identifier for the stream, and must be unique for * each account and region. *
*
* Constraints:
* Length: 1 - 256
* Pattern: [a-zA-Z0-9_.-]+
*/
private String streamName;
/**
*
* The ARN of the stream whose metadata you want to update. *
*
* Constraints:
* Length: 1 - 1024
* Pattern:
* arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-
* Z0-9_.-]+/[0-9]+
*/
private String streamARN;
/**
*
* The version of the stream whose metadata you want to update. *
*
* Constraints:
* Length: 1 - 64
* Pattern: [a-zA-Z0-9]+
*/
private String currentVersion;
/**
*
* The name of the device that is writing to the stream. *
** In the current implementation, Kinesis Video Streams does not use this * name. *
*
* Constraints:
* Length: 1 - 128
* Pattern: [a-zA-Z0-9_.-]+
*/
private String deviceName;
/**
*
* The stream's media type. Use MediaType
to specify the type
* of content that the stream contains to the consumers of the stream. For
* more information about media types, see Media Types. If you choose to specify the MediaType
,
* see Naming
* Requirements.
*
* To play video on the console, you must specify the correct video type.
* For example, if the video in the stream is H.264, specify
* video/h264
as the MediaType
.
*
* Constraints:
* Length: 1 - 128
* Pattern: [\w\-\.\+]+/[\w\-\.\+]+(,[\w\-\.\+]+/[\w\-\.\+]+)*
*/
private String mediaType;
/**
*
* The name of the stream whose metadata you want to update. *
** The stream name is an identifier for the stream, and must be unique for * each account and region. *
*
* Constraints:
* Length: 1 - 256
* Pattern: [a-zA-Z0-9_.-]+
*
* @return
* The name of the stream whose metadata you want to update. *
** The stream name is an identifier for the stream, and must be * unique for each account and region. *
*/ public String getStreamName() { return streamName; } /** ** The name of the stream whose metadata you want to update. *
** The stream name is an identifier for the stream, and must be unique for * each account and region. *
*
* Constraints:
* Length: 1 - 256
* Pattern: [a-zA-Z0-9_.-]+
*
* @param streamName
* The name of the stream whose metadata you want to update. *
** The stream name is an identifier for the stream, and must be * unique for each account and region. *
*/ public void setStreamName(String streamName) { this.streamName = streamName; } /** ** The name of the stream whose metadata you want to update. *
** The stream name is an identifier for the stream, and must be unique for * each account and region. *
** Returns a reference to this object so that method calls can be chained * together. *
* Constraints:
* Length: 1 - 256
* Pattern: [a-zA-Z0-9_.-]+
*
* @param streamName
* The name of the stream whose metadata you want to update. *
** The stream name is an identifier for the stream, and must be * unique for each account and region. *
* @return A reference to this updated object so that method calls can be * chained together. */ public UpdateStreamRequest withStreamName(String streamName) { this.streamName = streamName; return this; } /** ** The ARN of the stream whose metadata you want to update. *
*
* Constraints:
* Length: 1 - 1024
* Pattern:
* arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-
* Z0-9_.-]+/[0-9]+
*
* @return
* The ARN of the stream whose metadata you want to update. *
*/ public String getStreamARN() { return streamARN; } /** ** The ARN of the stream whose metadata you want to update. *
*
* Constraints:
* Length: 1 - 1024
* Pattern:
* arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-
* Z0-9_.-]+/[0-9]+
*
* @param streamARN
* The ARN of the stream whose metadata you want to update. *
*/ public void setStreamARN(String streamARN) { this.streamARN = streamARN; } /** ** The ARN of the stream whose metadata you want to update. *
** Returns a reference to this object so that method calls can be chained * together. *
* Constraints:
* Length: 1 - 1024
* Pattern:
* arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-
* Z0-9_.-]+/[0-9]+
*
* @param streamARN
* The ARN of the stream whose metadata you want to update. *
* @return A reference to this updated object so that method calls can be * chained together. */ public UpdateStreamRequest withStreamARN(String streamARN) { this.streamARN = streamARN; return this; } /** ** The version of the stream whose metadata you want to update. *
*
* Constraints:
* Length: 1 - 64
* Pattern: [a-zA-Z0-9]+
*
* @return
* The version of the stream whose metadata you want to update. *
*/ public String getCurrentVersion() { return currentVersion; } /** ** The version of the stream whose metadata you want to update. *
*
* Constraints:
* Length: 1 - 64
* Pattern: [a-zA-Z0-9]+
*
* @param currentVersion
* The version of the stream whose metadata you want to update. *
*/ public void setCurrentVersion(String currentVersion) { this.currentVersion = currentVersion; } /** ** The version of the stream whose metadata you want to update. *
** Returns a reference to this object so that method calls can be chained * together. *
* Constraints:
* Length: 1 - 64
* Pattern: [a-zA-Z0-9]+
*
* @param currentVersion
* The version of the stream whose metadata you want to update. *
* @return A reference to this updated object so that method calls can be * chained together. */ public UpdateStreamRequest withCurrentVersion(String currentVersion) { this.currentVersion = currentVersion; return this; } /** ** The name of the device that is writing to the stream. *
** In the current implementation, Kinesis Video Streams does not use this * name. *
*
* Constraints:
* Length: 1 - 128
* Pattern: [a-zA-Z0-9_.-]+
*
* @return
* The name of the device that is writing to the stream. *
** In the current implementation, Kinesis Video Streams does not use * this name. *
** The name of the device that is writing to the stream. *
** In the current implementation, Kinesis Video Streams does not use this * name. *
*
* Constraints:
* Length: 1 - 128
* Pattern: [a-zA-Z0-9_.-]+
*
* @param deviceName
* The name of the device that is writing to the stream. *
** In the current implementation, Kinesis Video Streams does not * use this name. *
** The name of the device that is writing to the stream. *
** In the current implementation, Kinesis Video Streams does not use this * name. *
** Returns a reference to this object so that method calls can be chained * together. *
* Constraints:
* Length: 1 - 128
* Pattern: [a-zA-Z0-9_.-]+
*
* @param deviceName
* The name of the device that is writing to the stream. *
** In the current implementation, Kinesis Video Streams does not * use this name. *
*
* The stream's media type. Use MediaType
to specify the type
* of content that the stream contains to the consumers of the stream. For
* more information about media types, see Media Types. If you choose to specify the MediaType
,
* see Naming
* Requirements.
*
* To play video on the console, you must specify the correct video type.
* For example, if the video in the stream is H.264, specify
* video/h264
as the MediaType
.
*
* Constraints:
* Length: 1 - 128
* Pattern: [\w\-\.\+]+/[\w\-\.\+]+(,[\w\-\.\+]+/[\w\-\.\+]+)*
*
* @return
* The stream's media type. Use MediaType
to specify
* the type of content that the stream contains to the consumers of
* the stream. For more information about media types, see Media Types. If you choose to specify the
* MediaType
, see Naming
* Requirements.
*
* To play video on the console, you must specify the correct video
* type. For example, if the video in the stream is H.264, specify
* video/h264
as the MediaType
.
*
* The stream's media type. Use MediaType
to specify the type
* of content that the stream contains to the consumers of the stream. For
* more information about media types, see Media Types. If you choose to specify the MediaType
,
* see Naming
* Requirements.
*
* To play video on the console, you must specify the correct video type.
* For example, if the video in the stream is H.264, specify
* video/h264
as the MediaType
.
*
* Constraints:
* Length: 1 - 128
* Pattern: [\w\-\.\+]+/[\w\-\.\+]+(,[\w\-\.\+]+/[\w\-\.\+]+)*
*
* @param mediaType
* The stream's media type. Use MediaType
to specify
* the type of content that the stream contains to the consumers
* of the stream. For more information about media types, see Media Types. If you choose to specify the
* MediaType
, see Naming
* Requirements.
*
* To play video on the console, you must specify the correct
* video type. For example, if the video in the stream is H.264,
* specify video/h264
as the MediaType
.
*
* The stream's media type. Use MediaType
to specify the type
* of content that the stream contains to the consumers of the stream. For
* more information about media types, see Media Types. If you choose to specify the MediaType
,
* see Naming
* Requirements.
*
* To play video on the console, you must specify the correct video type.
* For example, if the video in the stream is H.264, specify
* video/h264
as the MediaType
.
*
* Returns a reference to this object so that method calls can be chained * together. *
* Constraints:
* Length: 1 - 128
* Pattern: [\w\-\.\+]+/[\w\-\.\+]+(,[\w\-\.\+]+/[\w\-\.\+]+)*
*
* @param mediaType
* The stream's media type. Use MediaType
to specify
* the type of content that the stream contains to the consumers
* of the stream. For more information about media types, see Media Types. If you choose to specify the
* MediaType
, see Naming
* Requirements.
*
* To play video on the console, you must specify the correct
* video type. For example, if the video in the stream is H.264,
* specify video/h264
as the MediaType
.
*