本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 的 Kinesis 範例 AWS CLI
下列程式碼範例示範如何使用 AWS Command Line Interface 搭配 Kinesis 執行動作和實作常見案例。
*Actions* 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數，但您可以在其相關情境中查看內容中的動作。
每個範例均包含完整原始碼的連結，您可在連結中找到如何設定和執行內容中程式碼的相關指示。
**Topics**
+ [動作](#actions)
## 動作
### `add-tags-to-stream`
以下程式碼範例顯示如何使用 `add-tags-to-stream`。
**AWS CLI**
**將標籤新增至資料串流**
下列 `add-tags-to-stream` 範例會將具有索引鍵 `samplekey` 和值 `example` 的標籤，指派給指定的串流。
```
aws kinesis add-tags-to-stream \
--stream-name samplestream \
--tags samplekey=example
```
此命令不會產生輸出。
如需詳細資訊，請參閱《*Amazon Kinesis Data Streams 開發人員指南*》中的[標記串流](https://docs.aws.amazon.com/streams/latest/dev/tagging.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [AddTagsToStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/add-tags-to-stream.html)。
### `create-stream`
以下程式碼範例顯示如何使用 `create-stream`。
**AWS CLI**
**建立資料串流**
下列 `create-stream` 範例會建立名為 samplestream 的資料串流，其中包含 3 個碎片。
```
aws kinesis create-stream \
--stream-name samplestream \
--shard-count 3
```
此命令不會產生輸出。
如需詳細資訊，請參閱《*Amazon Kinesis Data Streams 開發人員指南*》中的[建立串流](https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-create-stream.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [CreateStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/create-stream.html)。
### `decrease-stream-retention-period`
以下程式碼範例顯示如何使用 `decrease-stream-retention-period`。
**AWS CLI**
**縮短資料串流保留期間**
下列 `decrease-stream-retention-period` 範例會將名為 samplestream 之串流的保留期間 (資料記錄新增至串流後可存取的時間長度) 縮短為 48 小時。
```
aws kinesis decrease-stream-retention-period \
--stream-name samplestream \
--retention-period-hours 48
```
此命令不會產生輸出。
如需詳細資訊，請參閱《*Amazon Kinesis Data Streams 開發人員指南*》中的[變更資料保留期間](https://docs.aws.amazon.com/streams/latest/dev/kinesis-extended-retention.html)。
+ 如需 API 詳細資訊，請參閱《*AWS CLI 命令參考*》中的 [DecreaseStreamRetentionPeriod](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/decrease-stream-retention-period.html)。
### `delete-stream`
以下程式碼範例顯示如何使用 `delete-stream`。
**AWS CLI**
**刪除資料串流**
以下 `delete-stream` 範例會刪除指定的資料串流。
```
aws kinesis delete-stream \
--stream-name samplestream
```
此命令不會產生輸出。
如需詳細資訊，請參閱《*Amazon Kinesis Data Streams 開發人員指南*》中的[刪除串流](https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-delete-stream.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeleteStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/delete-stream.html)。
### `deregister-stream-consumer`
以下程式碼範例顯示如何使用 `deregister-stream-consumer`。
**AWS CLI**
**取消註冊資料串流取用者**
下列 `deregister-stream-consumer` 範例會從指定的資料串流取消註冊指定的取用者。
```
aws kinesis deregister-stream-consumer \
--stream-arn arn:aws:kinesis:us-west-2:123456789012:stream/samplestream \
--consumer-name KinesisConsumerApplication
```
此命令不會產生輸出。
如需詳細資訊，請參閱《Amazon Kinesis Data Streams 開發人員指南》**中的[使用 Kinesis Data Streams API 開發具有強化廣發功能的取用者](https://docs.aws.amazon.com/streams/latest/dev/building-enhanced-consumers-api.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeregisterStreamConsumer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/deregister-stream-consumer.html)。
### `describe-limits`
以下程式碼範例顯示如何使用 `describe-limits`。
**AWS CLI**
**描述碎片限制**
下列`describe-limits`範例顯示目前 AWS 帳戶的碎片限制和用量。
```
aws kinesis describe-limits
```
輸出：
```
{
"ShardLimit": 500,
"OpenShardCount": 29
}
```
如需詳細資訊，請參閱《*Amazon Kinesis Data Streams 開發人員指南*》中的[重新分片串流](https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-resharding.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DescribeLimits](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/describe-limits.html)。
### `describe-stream-consumer`
以下程式碼範例顯示如何使用 `describe-stream-consumer`。
**AWS CLI**
**描述資料串流取用者**
下列 `describe-stream-consumer` 範例會傳回利用指定資料串流註冊之指定取用者的描述。
```
aws kinesis describe-stream-consumer \
--stream-arn arn:aws:kinesis:us-west-2:012345678912:stream/samplestream \
--consumer-name KinesisConsumerApplication
```
輸出：
```
{
"ConsumerDescription": {
"ConsumerName": "KinesisConsumerApplication",
"ConsumerARN": "arn:aws:kinesis:us-west-2:123456789012:stream/samplestream/consumer/KinesisConsumerApplication:1572383852",
"ConsumerStatus": "ACTIVE",
"ConsumerCreationTimestamp": 1572383852.0,
"StreamARN": "arn:aws:kinesis:us-west-2:123456789012:stream/samplestream"
}
}
```
如需詳細資訊，請參閱《*Amazon Kinesis Data Streams 開發人員指南*》中的[從 Amazon Kinesis Data Streams 讀取資料](https://docs.aws.amazon.com/streams/latest/dev/building-consumers.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DescribeStreamConsumer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/describe-stream-consumer.html)。
### `describe-stream-summary`
以下程式碼範例顯示如何使用 `describe-stream-summary`。
**AWS CLI**
**描述資料串流摘要**
下列 `describe-stream-summary` 範例提供指定之資料串流的摘要說明 (不含分片清單)。
```
aws kinesis describe-stream-summary \
--stream-name samplestream
```
輸出：
```
{
"StreamDescriptionSummary": {
"StreamName": "samplestream",
"StreamARN": "arn:aws:kinesis:us-west-2:123456789012:stream/samplestream",
"StreamStatus": "ACTIVE",
"RetentionPeriodHours": 48,
"StreamCreationTimestamp": 1572297168.0,
"EnhancedMonitoring": [
{
"ShardLevelMetrics": []
}
],
"EncryptionType": "NONE",
"OpenShardCount": 3,
"ConsumerCount": 0
}
}
```
如需詳細資訊，請參閱《*Amazon Kinesis Data Streams 開發人員指南*》中的[建立管理串流](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DescribeStreamSummary](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/describe-stream-summary.html)。
### `describe-stream`
以下程式碼範例顯示如何使用 `describe-stream`。
**AWS CLI**
**描述資料串流**
下列 `describe-stream` 範例會傳回指定資料串流的詳細長度。
```
aws kinesis describe-stream \
--stream-name samplestream
```
輸出：
```
{
"StreamDescription": {
"Shards": [
{
"ShardId": "shardId-000000000000",
"HashKeyRange": {
"StartingHashKey": "0",
"EndingHashKey": "113427455640312821154458202477256070484"
},
"SequenceNumberRange": {
"StartingSequenceNumber": "49600871682957036442365024926191073437251060580128653314"
}
},
{
"ShardId": "shardId-000000000001",
"HashKeyRange": {
"StartingHashKey": "113427455640312821154458202477256070485",
"EndingHashKey": "226854911280625642308916404954512140969"
},
"SequenceNumberRange": {
"StartingSequenceNumber": "49600871682979337187563555549332609155523708941634633746"
}
},
{
"ShardId": "shardId-000000000002",
"HashKeyRange": {
"StartingHashKey": "226854911280625642308916404954512140970",
"EndingHashKey": "340282366920938463463374607431768211455"
},
"SequenceNumberRange": {
"StartingSequenceNumber": "49600871683001637932762086172474144873796357303140614178"
}
}
],
"StreamARN": "arn:aws:kinesis:us-west-2:123456789012:stream/samplestream",
"StreamName": "samplestream",
"StreamStatus": "ACTIVE",
"RetentionPeriodHours": 24,
"EnhancedMonitoring": [
{
"ShardLevelMetrics": []
}
],
"EncryptionType": "NONE",
"KeyId": null,
"StreamCreationTimestamp": 1572297168.0
}
}
```
如需詳細資訊，請參閱《*Amazon Kinesis Data Streams 開發人員指南*》中的[建立管理串流](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DescribeStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/describe-stream.html)。
### `disable-enhanced-monitoring`
以下程式碼範例顯示如何使用 `disable-enhanced-monitoring`。
**AWS CLI**
**停用碎片層級指標的增強型監控**
下列 `disable-enhanced-monitoring` 範例會停用碎片層級指標的增強型 Kinesis 資料串流監控。
```
aws kinesis disable-enhanced-monitoring \
--stream-name samplestream --shard-level-metrics ALL
```
輸出：
```
{
"StreamName": "samplestream",
"CurrentShardLevelMetrics": [
"IncomingBytes",
"OutgoingRecords",
"IteratorAgeMilliseconds",
"IncomingRecords",
"ReadProvisionedThroughputExceeded",
"WriteProvisionedThroughputExceeded",
"OutgoingBytes"
],
"DesiredShardLevelMetrics": []
}
```
如需詳細資訊，請參閱《*Amazon Kinesis Data Streams 開發人員指南*》中的[監控 Amazon Kinesis Data Streams 中的串流](https://docs.aws.amazon.com/streams/latest/dev/monitoring.html)。
+ 如需 API 詳細資訊，請參閱《*AWS CLI 命令參考*》中的 [DisableEnhancedMonitoring](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/disable-enhanced-monitoring.html)。
### `enable-enhanced-monitoring`
以下程式碼範例顯示如何使用 `enable-enhanced-monitoring`。
**AWS CLI**
**啟用碎片層級指標的增強型監控**
下列 `enable-enhanced-monitoring` 範例會啟用碎片層級指標的增強型 Kinesis 資料串流監控。
```
aws kinesis enable-enhanced-monitoring \
--stream-name samplestream \
--shard-level-metrics ALL
```
輸出：
```
{
"StreamName": "samplestream",
"CurrentShardLevelMetrics": [],
"DesiredShardLevelMetrics": [
"IncomingBytes",
"OutgoingRecords",
"IteratorAgeMilliseconds",
"IncomingRecords",
"ReadProvisionedThroughputExceeded",
"WriteProvisionedThroughputExceeded",
"OutgoingBytes"
]
}
```
如需詳細資訊，請參閱《*Amazon Kinesis Data Streams 開發人員指南*》中的[監控 Amazon Kinesis Data Streams 中的串流](https://docs.aws.amazon.com/streams/latest/dev/monitoring.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [EnableEnhancedMonitoring](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/enable-enhanced-monitoring.html)。
### `get-records`
以下程式碼範例顯示如何使用 `get-records`。
**AWS CLI**
**從碎片取得記錄**
下列 `get-records` 範例使用指定的碎片迭代器，從 Kinesis 資料串流的碎片取得資料記錄。
```
aws kinesis get-records \
--shard-iterator AAAAAAAAAAF7/0mWD7IuHj1yGv/TKuNgx2ukD5xipCY4cy4gU96orWwZwcSXh3K9tAmGYeOZyLZrvzzeOFVf9iN99hUPw/w/b0YWYeehfNvnf1DYt5XpDJghLKr3DzgznkTmMymDP3R+3wRKeuEw6/kdxY2yKJH0veaiekaVc4N2VwK/GvaGP2Hh9Fg7N++q0Adg6fIDQPt4p8RpavDbk+A4sL9SWGE1
```
輸出：
```
{
"Records": [],
"MillisBehindLatest": 80742000
}
```
如需詳細資訊，請參閱《*Amazon Kinesis * [Kinesis Data Streams 開發人員指南》中的使用 Kinesis Data Streams API 搭配適用於 Java 的 AWS SDK 開發消費者](https://docs.aws.amazon.com/streams/latest/dev/developing-consumers-with-sdk.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetRecords](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/get-records.html)。
### `get-shard-iterator`
以下程式碼範例顯示如何使用 `get-shard-iterator`。
**AWS CLI**
**取得碎片迭代器**
下列 `get-shard-iterator` 範例使用 `AT_SEQUENCE_NUMBER` 碎片迭代器型，並產生碎片迭代器，開始從以指定序號表示的位置讀取資料記錄。
```
aws kinesis get-shard-iterator \
--stream-name samplestream \
--shard-id shardId-000000000001 \
--shard-iterator-type LATEST
```
輸出：
```
{
"ShardIterator": "AAAAAAAAAAFEvJjIYI+3jw/4aqgH9FifJ+n48XWTh/IFIsbILP6o5eDueD39NXNBfpZ10WL5K6ADXk8w+5H+Qhd9cFA9k268CPXCz/kebq1TGYI7Vy+lUkA9BuN3xvATxMBGxRY3zYK05gqgvaIRn94O8SqeEqwhigwZxNWxID3Ej7YYYcxQi8Q/fIrCjGAy/n2r5Z9G864YpWDfN9upNNQAR/iiOWKs"
}
```
如需詳細資訊，請參閱《*Amazon Kinesis * [Kinesis Data Streams 開發人員指南》中的使用 Kinesis Data Streams API 搭配適用於 Java 的 AWS SDK 開發消費者](https://docs.aws.amazon.com/streams/latest/dev/developing-consumers-with-sdk.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetShardIterator](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/get-shard-iterator.html)。
### `increase-stream-retention-period`
以下程式碼範例顯示如何使用 `increase-stream-retention-period`。
**AWS CLI**
**增加資料串流保留期間**
下列 `increase-stream-retention-period` 範例會將指定串流的保留期間 (資料記錄新增至串流後可存取的時間長度) 增加至 168 小時。
```
aws kinesis increase-stream-retention-period \
--stream-name samplestream \
--retention-period-hours 168
```
此命令不會產生輸出。
如需詳細資訊，請參閱《*Amazon Kinesis Data Streams 開發人員指南*》中的[變更資料保留期間](https://docs.aws.amazon.com/streams/latest/dev/kinesis-extended-retention.html)。
+ 如需 API 詳細資訊，請參閱《*AWS CLI 命令參考*》中的 [IncreaseStreamRetentionPeriod](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/increase-stream-retention-period.html)。
### `list-shards`
以下程式碼範例顯示如何使用 `list-shards`。
**AWS CLI**
**列出資料串流中的碎片**
下列 `list-shards` 範例會列出指定串流中的所有碎片，從其 ID 緊接在指定的 `shardId-000000000000` 中的 `exclusive-start-shard-id` 之後的碎片開始。
```
aws kinesis list-shards \
--stream-name samplestream \
--exclusive-start-shard-id shardId-000000000000
```
輸出：
```
{
"Shards": [
{
"ShardId": "shardId-000000000001",
"HashKeyRange": {
"StartingHashKey": "113427455640312821154458202477256070485",
"EndingHashKey": "226854911280625642308916404954512140969"
},
"SequenceNumberRange": {
"StartingSequenceNumber": "49600871682979337187563555549332609155523708941634633746"
}
},
{
"ShardId": "shardId-000000000002",
"HashKeyRange": {
"StartingHashKey": "226854911280625642308916404954512140970",
"EndingHashKey": "340282366920938463463374607431768211455"
},
"SequenceNumberRange": {
"StartingSequenceNumber": "49600871683001637932762086172474144873796357303140614178"
}
}
]
}
```
如需詳細資訊，請參閱《*Amazon Kinesis Data Streams 開發人員指南*》中的[列出碎片](https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-list-shards.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListShards](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/list-shards.html)。
### `list-streams`
以下程式碼範例顯示如何使用 `list-streams`。
**AWS CLI**
**列出資料串流**
下列 `list-streams` 範例列出目前帳戶和區域中的所有作用中資料串流。
```
aws kinesis list-streams
```
輸出：
```
{
"StreamNames": [
"samplestream",
"samplestream1"
]
}
```
如需詳細資訊，請參閱《*Amazon Kinesis Data Streams 開發人員指南*》中的[列出串流](https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-list-streams.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/list-streams.html)。
### `list-tags-for-stream`
以下程式碼範例顯示如何使用 `list-tags-for-stream`。
**AWS CLI**
**列出資料串流的標籤**
下列 `list-tags-for-stream` 範例列出連接至指定資料串流的標籤。
```
aws kinesis list-tags-for-stream \
--stream-name samplestream
```
輸出：
```
{
"Tags": [
{
"Key": "samplekey",
"Value": "example"
}
],
"HasMoreTags": false
}
```
如需詳細資訊，請參閱《*Amazon Kinesis Data Streams 開發人員指南*》中的[標記串流](https://docs.aws.amazon.com/streams/latest/dev/tagging.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListTagsForStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/list-tags-for-stream.html)。
### `merge-shards`
以下程式碼範例顯示如何使用 `merge-shards`。
**AWS CLI**
**合併碎片**
下列 `merge-shards` 範例會將指定資料串流中 ID 分別為 shardId-000000000000 和 shardId-000000000001 的兩個相鄰碎片，合併為一個碎片。
```
aws kinesis merge-shards \
--stream-name samplestream \
--shard-to-merge shardId-000000000000 \
--adjacent-shard-to-merge shardId-000000000001
```
此命令不會產生輸出。
如需詳細資訊，請參閱《*Amazon Kinesis Data Streams 開發人員指南*》中的[合併兩個碎片](https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-resharding-merge.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [MergeShards](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/merge-shards.html)。
### `put-record`
以下程式碼範例顯示如何使用 `put-record`。
**AWS CLI**
**將記錄寫入資料串流**
下列 `put-record` 範例會使用指定的分割區索引鍵，將單一資料記錄寫入指定的資料串流。
```
aws kinesis put-record \
--stream-name samplestream \
--data sampledatarecord \
--partition-key samplepartitionkey
```
輸出：
```
{
"ShardId": "shardId-000000000009",
"SequenceNumber": "49600902273357540915989931256901506243878407835297513618",
"EncryptionType": "KMS"
}
```
如需詳細資訊，請參閱《[Amazon Kinesis Data Streams 開發人員指南》中的使用 Amazon Kinesis Data Streams API 搭配適用於 Java 的 AWS SDK 開發生產者](https://docs.aws.amazon.com/streams/latest/dev/developing-producers-with-sdk.html)。 *Amazon Kinesis *
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [PutRecord](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/put-record.html)。
### `put-records`
以下程式碼範例顯示如何使用 `put-records`。
**AWS CLI**
**將多筆記錄寫入資料串流**
下列 `put-records` 範例使用指定的分割區索引鍵寫入資料記錄，並在單一呼叫中使用不同的分割區索引鍵寫入另一個資料記錄。
```
aws kinesis put-records \
--stream-name samplestream \
--records Data=blob1,PartitionKey=partitionkey1 Data=blob2,PartitionKey=partitionkey2
```
輸出：
```
{
"FailedRecordCount": 0,
"Records": [
{
"SequenceNumber": "49600883331171471519674795588238531498465399900093808706",
"ShardId": "shardId-000000000004"
},
{
"SequenceNumber": "49600902273357540915989931256902715169698037101720764562",
"ShardId": "shardId-000000000009"
}
],
"EncryptionType": "KMS"
}
```
如需詳細資訊，請參閱《[Amazon Kinesis Data Streams 開發人員指南》中的使用 Amazon Kinesis Data Streams API 搭配適用於 Java 的 AWS SDK 開發生產者](https://docs.aws.amazon.com/streams/latest/dev/developing-producers-with-sdk.html)。 *Amazon Kinesis *
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [PutRecords](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/put-records.html)。
### `register-stream-consumer`
以下程式碼範例顯示如何使用 `register-stream-consumer`。
**AWS CLI**
**註冊資料串流取用者**
下列 `register-stream-consumer` 範例會在指定的資料串流註冊名為 `KinesisConsumerApplication` 的取用者。
```
aws kinesis register-stream-consumer \
--stream-arn arn:aws:kinesis:us-west-2:012345678912:stream/samplestream \
--consumer-name KinesisConsumerApplication
```
輸出：
```
{
"Consumer": {
"ConsumerName": "KinesisConsumerApplication",
"ConsumerARN": "arn:aws:kinesis:us-west-2: 123456789012:stream/samplestream/consumer/KinesisConsumerApplication:1572383852",
"ConsumerStatus": "CREATING",
"ConsumerCreationTimestamp": 1572383852.0
}
}
```
如需詳細資訊，請參閱《Amazon Kinesis Data Streams 開發人員指南》**中的[使用 Kinesis Data Streams API 開發具有強化廣發功能的取用者](https://docs.aws.amazon.com/streams/latest/dev/building-enhanced-consumers-api.html)。
+ 如需 API 詳細資訊，請參閱《*AWS CLI 命令參考*》中的 [RegisterStreamConsumer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/register-stream-consumer.html)。
### `remove-tags-from-stream`
以下程式碼範例顯示如何使用 `remove-tags-from-stream`。
**AWS CLI**
**從資料串流移除標籤**
下列 `remove-tags-from-stream` 範例會從指定的資料串流，移除具有指定索引鍵的標籤。
```
aws kinesis remove-tags-from-stream \
--stream-name samplestream \
--tag-keys samplekey
```
此命令不會產生輸出。
如需詳細資訊，請參閱《*Amazon Kinesis Data Streams 開發人員指南*》中的[標記串流](https://docs.aws.amazon.com/streams/latest/dev/tagging.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [RemoveTagsFromStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/remove-tags-from-stream.html)。
### `split-shard`
以下程式碼範例顯示如何使用 `split-shard`。
**AWS CLI**
**分割碎片**
下列 `split-shard` 範例使用新的起始雜湊索引鍵 10，將指定的碎片分割成兩個新的碎片。
```
aws kinesis split-shard \
--stream-name samplestream \
--shard-to-split shardId-000000000000 \
--new-starting-hash-key 10
```
此命令不會產生輸出。
如需詳細資訊，請參閱《*Amazon Kinesis Data Streams 開發人員指南*》中的[分割碎片](https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-resharding-split.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [SplitShard](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/split-shard.html)。
### `start-stream-encryption`
以下程式碼範例顯示如何使用 `start-stream-encryption`。
**AWS CLI**
**啟用資料串流加密**
下列`start-stream-encryption`範例使用指定的 AWS KMS 金鑰，為指定的串流啟用伺服器端加密。
```
aws kinesis start-stream-encryption \
--encryption-type KMS \
--key-id arn:aws:kms:us-west-2:012345678912:key/a3c4a7cd-728b-45dd-b334-4d3eb496e452 \
--stream-name samplestream
```
此命令不會產生輸出。
如需詳細資訊，請參閱《Amazon Kinesis Data Streams 開發人員指南》**中的 [Amazon Kinesis Data Streams 中的資料保護](https://docs.aws.amazon.com/streams/latest/dev/server-side-encryption.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [StartStreamEncryption](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/start-stream-encryption.html)。
### `stop-stream-encryption`
以下程式碼範例顯示如何使用 `stop-stream-encryption`。
**AWS CLI**
**停用資料串流加密**
下列`stop-stream-encryption`範例使用指定的 AWS KMS 金鑰，停用指定串流的伺服器端加密。
```
aws kinesis start-stream-encryption \
--encryption-type KMS \
--key-id arn:aws:kms:us-west-2:012345678912:key/a3c4a7cd-728b-45dd-b334-4d3eb496e452 \
--stream-name samplestream
```
此命令不會產生輸出。
如需詳細資訊，請參閱《Amazon Kinesis Data Streams 開發人員指南》**中的 [Amazon Kinesis Data Streams 中的資料保護](https://docs.aws.amazon.com/streams/latest/dev/server-side-encryption.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [StopStreamEncryption](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/stop-stream-encryption.html)。
### `update-shard-count`
以下程式碼範例顯示如何使用 `update-shard-count`。
**AWS CLI**
**更新資料串流中的碎片計數**
下列 `update-shard-count` 範例會將指定資料串流的碎片計數更新為 6。此範例使用統一擴展，建立大小相等的碎片。
```
aws kinesis update-shard-count \
--stream-name samplestream \
--scaling-type UNIFORM_SCALING \
--target-shard-count 6
```
輸出：
```
{
"StreamName": "samplestream",
"CurrentShardCount": 3,
"TargetShardCount": 6
}
```
如需詳細資訊，請參閱《*Amazon Kinesis Data Streams 開發人員指南*》中的[重新分片串流](https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-resharding.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [UpdateShardCount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/update-shard-count.html)。