/*
* Copyright 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.
*/
/*
* Do not modify this file. This file is generated from the kinesis-2013-12-02.normal.json service model.
*/
using System;
using System.Collections.Generic;
using System.Xml.Serialization;
using System.Text;
using System.IO;
using System.Net;
using Amazon.Runtime;
using Amazon.Runtime.Internal;
namespace Amazon.Kinesis.Model
{
///
/// Container for the parameters to the StartStreamEncryption operation.
/// Enables or updates server-side encryption using an Amazon Web Services KMS key for
/// a specified stream.
///
///
///
/// Starting encryption is an asynchronous operation. Upon receiving the request, Kinesis
/// Data Streams returns immediately and sets the status of the stream to UPDATING
.
/// After the update is complete, Kinesis Data Streams sets the status of the stream back
/// to ACTIVE
. Updating or applying encryption normally takes a few seconds
/// to complete, but it can take minutes. You can continue to read and write data to your
/// stream while its status is UPDATING
. Once the status of the stream is
/// ACTIVE
, encryption begins for records written to the stream.
///
///
///
/// API Limits: You can successfully apply a new Amazon Web Services KMS key for server-side
/// encryption 25 times in a rolling 24-hour period.
///
///
///
/// Note: It can take up to 5 seconds after the stream is in an ACTIVE
status
/// before all records written to the stream are encrypted. After you enable encryption,
/// you can verify that encryption is applied by inspecting the API response from PutRecord
/// or PutRecords
.
///
///
///
/// When invoking this API, it is recommended you use the StreamARN
input
/// parameter rather than the StreamName
input parameter.
///
///
///
public partial class StartStreamEncryptionRequest : AmazonKinesisRequest
{
private EncryptionType _encryptionType;
private string _keyId;
private string _streamARN;
private string _streamName;
///
/// Gets and sets the property EncryptionType.
///
/// The encryption type to use. The only valid value is KMS
.
///
///
[AWSProperty(Required=true)]
public EncryptionType EncryptionType
{
get { return this._encryptionType; }
set { this._encryptionType = value; }
}
// Check to see if EncryptionType property is set
internal bool IsSetEncryptionType()
{
return this._encryptionType != null;
}
///
/// Gets and sets the property KeyId.
///
/// The GUID for the customer-managed Amazon Web Services KMS key to use for encryption.
/// This value can be a globally unique identifier, a fully specified Amazon Resource
/// Name (ARN) to either an alias or a key, or an alias name prefixed by "alias/".You
/// can also use a master key owned by Kinesis Data Streams by specifying the alias aws/kinesis
.
///
/// -
///
/// Key ARN example:
arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012
///
///
/// -
///
/// Alias ARN example:
arn:aws:kms:us-east-1:123456789012:alias/MyAliasName
///
///
/// -
///
/// Globally unique key ID example:
12345678-1234-1234-1234-123456789012
///
///
/// -
///
/// Alias name example:
alias/MyAliasName
///
/// -
///
/// Master key owned by Kinesis Data Streams:
alias/aws/kinesis
///
///
///
[AWSProperty(Required=true, Min=1, Max=2048)]
public string KeyId
{
get { return this._keyId; }
set { this._keyId = value; }
}
// Check to see if KeyId property is set
internal bool IsSetKeyId()
{
return this._keyId != null;
}
///
/// Gets and sets the property StreamARN.
///
/// The ARN of the stream.
///
///
[AWSProperty(Min=1, Max=2048)]
public string StreamARN
{
get { return this._streamARN; }
set { this._streamARN = value; }
}
// Check to see if StreamARN property is set
internal bool IsSetStreamARN()
{
return this._streamARN != null;
}
///
/// Gets and sets the property StreamName.
///
/// The name of the stream for which to start encrypting records.
///
///
[AWSProperty(Min=1, Max=128)]
public string StreamName
{
get { return this._streamName; }
set { this._streamName = value; }
}
// Check to see if StreamName property is set
internal bool IsSetStreamName()
{
return this._streamName != null;
}
}
}