Sono disponibili altri esempi AWS SDK nel repository [AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples) Examples. GitHub
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Esempi di Kinesis che utilizzano AWS CLI
I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface con Kinesis.
Le *azioni* sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.
Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.
**Topics**
+ [Azioni](#actions)
## Azioni
### `add-tags-to-stream`
Il seguente esempio di codice mostra come utilizzare`add-tags-to-stream`.
**AWS CLI**
**Come aggiungere tag a un flusso di dati**
L’esempio `add-tags-to-stream` seguente assegna un tag con la chiave `samplekey` e il valore `example` al flusso specificato.
```
aws kinesis add-tags-to-stream \
--stream-name samplestream \
--tags samplekey=example
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Tagging dei flussi](https://docs.aws.amazon.com/streams/latest/dev/tagging.html) nella *Guida per gli sviluppatori di Flusso di dati Amazon Kinesis*.
+ Per i dettagli sull'API, consulta [AddTagsToStream AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/add-tags-to-stream.html)*Command Reference*.
### `create-stream`
Il seguente esempio di codice mostra come utilizzare`create-stream`.
**AWS CLI**
**Come creare un flusso di dati**
L’esempio `create-stream` seguente crea un flusso di dati denominato samplestream con 3 shard.
```
aws kinesis create-stream \
--stream-name samplestream \
--shard-count 3
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Creazione di un flusso](https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-create-stream.html) nella *Guida per gli sviluppatori di Flusso di dati Amazon Kinesis*.
+ Per i dettagli sull'API, consulta [CreateStream AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/create-stream.html)*Command Reference*.
### `decrease-stream-retention-period`
Il seguente esempio di codice mostra come utilizzare`decrease-stream-retention-period`.
**AWS CLI**
**Come ridurre il periodo di conservazione del flusso di dati**
L’esempio `decrease-stream-retention-period` seguente riduce il periodo di conservazione (tempo durante il quale i record di dati sono accessibili dopo essere stati aggiunti al flusso) di un flusso denominato samplestream a 48 ore.
```
aws kinesis decrease-stream-retention-period \
--stream-name samplestream \
--retention-period-hours 48
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Modifica del periodo di conservazione dei dati](https://docs.aws.amazon.com/streams/latest/dev/kinesis-extended-retention.html) nella *Guida per gli sviluppatori di Flusso di dati Amazon Kinesis*.
+ Per i dettagli sull'API, consulta [DecreaseStreamRetentionPeriod AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/decrease-stream-retention-period.html)*Command Reference*.
### `delete-stream`
Il seguente esempio di codice mostra come utilizzare`delete-stream`.
**AWS CLI**
**Come eliminare un flusso di dati**
L’esempio `delete-stream` seguente elimina il flusso di dati specificato.
```
aws kinesis delete-stream \
--stream-name samplestream
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Eliminazione di un flusso](https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-delete-stream.html) nella *Guida per gli sviluppatori di Flusso di dati Amazon Kinesis*.
+ Per i dettagli sull'API, consulta [DeleteStream AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/delete-stream.html)*Command Reference*.
### `deregister-stream-consumer`
Il seguente esempio di codice mostra come utilizzare`deregister-stream-consumer`.
**AWS CLI**
**Come annullare la registrazione di un consumer del flusso di dati**
L’esempio `deregister-stream-consumer` seguente annulla la registrazione del consumer specificato dal flusso di dati specificato.
```
aws kinesis deregister-stream-consumer \
--stream-arn arn:aws:kinesis:us-west-2:123456789012:stream/samplestream \
--consumer-name KinesisConsumerApplication
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Sviluppo di applicazioni consumer con fan-out avanzato con l’API di Flusso dati Kinesis](https://docs.aws.amazon.com/streams/latest/dev/building-enhanced-consumers-api.html) nella *Guida per gli sviluppatori di Flusso di dati Amazon Kinesis*.
+ Per i dettagli sull'API, consulta [DeregisterStreamConsumer AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/deregister-stream-consumer.html)*Command Reference*.
### `describe-limits`
Il seguente esempio di codice mostra come utilizzare`describe-limits`.
**AWS CLI**
**Come descrivere i limiti degli shard**
L'`describe-limits`esempio seguente mostra i limiti e l'utilizzo degli shard per l' AWS account corrente.
```
aws kinesis describe-limits
```
Output:
```
{
"ShardLimit": 500,
"OpenShardCount": 29
}
```
Per ulteriori informazioni, consulta [Resharding di un flusso](https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-resharding.html) nella *Guida per gli sviluppatori di Flusso di dati Amazon Kinesis*.
+ Per i dettagli sull'API, consulta [DescribeLimits AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/describe-limits.html)*Command Reference.*
### `describe-stream-consumer`
Il seguente esempio di codice mostra come utilizzare`describe-stream-consumer`.
**AWS CLI**
**Come descrivere un consumer del flusso di dati**
L’esempio `describe-stream-consumer` seguente restituisce la descrizione del consumer specificato, registrato con il flusso di dati specificato.
```
aws kinesis describe-stream-consumer \
--stream-arn arn:aws:kinesis:us-west-2:012345678912:stream/samplestream \
--consumer-name KinesisConsumerApplication
```
Output:
```
{
"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"
}
}
```
Per ulteriori informazioni, consulta [Lettura di dati dal flusso di dati Amazon Kinesis](https://docs.aws.amazon.com/streams/latest/dev/building-consumers.html) nella *Guida per gli sviluppatori di Amazon Kinesis Data Streams*.
+ Per i dettagli sull'API, consulta [DescribeStreamConsumer AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/describe-stream-consumer.html)*Command Reference*.
### `describe-stream-summary`
Il seguente esempio di codice mostra come utilizzare`describe-stream-summary`.
**AWS CLI**
**Come descrivere un riepilogo del flusso di dati**
L’esempio `describe-stream-summary` seguente fornisce un riepilogo della descrizione (senza l’elenco degli shard) del flusso di dati specificato.
```
aws kinesis describe-stream-summary \
--stream-name samplestream
```
Output:
```
{
"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
}
}
```
Per ulteriori informazioni, consulta [Creazione e gestione dei flussi](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html) nella *Guida per gli sviluppatori di Flusso di dati Amazon Kinesis*.
+ Per i dettagli sull'API, consulta [DescribeStreamSummary AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/describe-stream-summary.html)*Command Reference*.
### `describe-stream`
Il seguente esempio di codice mostra come utilizzare`describe-stream`.
**AWS CLI**
**Come descrivere un flusso di dati**
L’esempio `describe-stream` seguente restituisce i dettagli del flusso di dati specificato.
```
aws kinesis describe-stream \
--stream-name samplestream
```
Output:
```
{
"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
}
}
```
Per ulteriori informazioni, consulta [Creazione e gestione dei flussi](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html) nella *Guida per gli sviluppatori di Flusso di dati Amazon Kinesis*.
+ Per i dettagli sull'API, consulta [DescribeStream AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/describe-stream.html)*Command Reference*.
### `disable-enhanced-monitoring`
Il seguente esempio di codice mostra come utilizzare`disable-enhanced-monitoring`.
**AWS CLI**
**Come disabilitare il monitoraggio avanzato delle metriche a livello di shard**
L’esempio `disable-enhanced-monitoring` seguente disabilita il monitoraggio avanzato delle metriche a livello di shard per il flusso di dati Kinesis.
```
aws kinesis disable-enhanced-monitoring \
--stream-name samplestream --shard-level-metrics ALL
```
Output:
```
{
"StreamName": "samplestream",
"CurrentShardLevelMetrics": [
"IncomingBytes",
"OutgoingRecords",
"IteratorAgeMilliseconds",
"IncomingRecords",
"ReadProvisionedThroughputExceeded",
"WriteProvisionedThroughputExceeded",
"OutgoingBytes"
],
"DesiredShardLevelMetrics": []
}
```
Per ulteriori informazioni, consulta [Monitoraggio dei flussi nel flusso di dati Amazon Kinesis](https://docs.aws.amazon.com/streams/latest/dev/monitoring.html) nella *Guida per gli sviluppatori di Flusso di dati Amazon Kinesis*.
+ Per i dettagli sull'API, consulta [DisableEnhancedMonitoring AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/disable-enhanced-monitoring.html)*Command Reference*.
### `enable-enhanced-monitoring`
Il seguente esempio di codice mostra come utilizzare`enable-enhanced-monitoring`.
**AWS CLI**
**Come abilitare il monitoraggio avanzato delle metriche a livello di shard**
L’esempio `enable-enhanced-monitoring` seguente abilita il monitoraggio avanzato delle metriche a livello di shard per il flusso di dati Kinesis.
```
aws kinesis enable-enhanced-monitoring \
--stream-name samplestream \
--shard-level-metrics ALL
```
Output:
```
{
"StreamName": "samplestream",
"CurrentShardLevelMetrics": [],
"DesiredShardLevelMetrics": [
"IncomingBytes",
"OutgoingRecords",
"IteratorAgeMilliseconds",
"IncomingRecords",
"ReadProvisionedThroughputExceeded",
"WriteProvisionedThroughputExceeded",
"OutgoingBytes"
]
}
```
Per ulteriori informazioni, consulta [Monitoraggio dei flussi nel flusso di dati Amazon Kinesis](https://docs.aws.amazon.com/streams/latest/dev/monitoring.html) nella *Guida per gli sviluppatori di Flusso di dati Amazon Kinesis*.
+ Per i dettagli sull'API, consulta [EnableEnhancedMonitoring AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/enable-enhanced-monitoring.html)*Command Reference*.
### `get-records`
Il seguente esempio di codice mostra come utilizzare`get-records`.
**AWS CLI**
**Come ottenere record da uno shard**
L’esempio `get-records` seguente ottiene i record di dati dallo shard di un flusso di dati Kinesis mediante l’iterazione dei shard specificata.
```
aws kinesis get-records \
--shard-iterator AAAAAAAAAAF7/0mWD7IuHj1yGv/TKuNgx2ukD5xipCY4cy4gU96orWwZwcSXh3K9tAmGYeOZyLZrvzzeOFVf9iN99hUPw/w/b0YWYeehfNvnf1DYt5XpDJghLKr3DzgznkTmMymDP3R+3wRKeuEw6/kdxY2yKJH0veaiekaVc4N2VwK/GvaGP2Hh9Fg7N++q0Adg6fIDQPt4p8RpavDbk+A4sL9SWGE1
```
Output:
```
{
"Records": [],
"MillisBehindLatest": 80742000
}
```
Per ulteriori informazioni, consulta [Developing Consumers Using the Kinesis Data Streams API AWS with the SDK for Java](https://docs.aws.amazon.com/streams/latest/dev/developing-consumers-with-sdk.html) nella Amazon *Kinesis Data Streams* Developer Guide.
+ *Per i dettagli sull'API, consulta Command Reference. [GetRecords](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/get-records.html)AWS CLI *
### `get-shard-iterator`
Il seguente esempio di codice mostra come utilizzare`get-shard-iterator`.
**AWS CLI**
**Come ottenere un iteratore di shard**
L’esempio `get-shard-iterator` seguente utilizza il tipo di iteratore dello shard `AT_SEQUENCE_NUMBER` e genera un iteratore dello shard per avviare la lettura dei record di dati esattamente dalla posizione indicata dal numero di sequenza specificato.
```
aws kinesis get-shard-iterator \
--stream-name samplestream \
--shard-id shardId-000000000001 \
--shard-iterator-type LATEST
```
Output:
```
{
"ShardIterator": "AAAAAAAAAAFEvJjIYI+3jw/4aqgH9FifJ+n48XWTh/IFIsbILP6o5eDueD39NXNBfpZ10WL5K6ADXk8w+5H+Qhd9cFA9k268CPXCz/kebq1TGYI7Vy+lUkA9BuN3xvATxMBGxRY3zYK05gqgvaIRn94O8SqeEqwhigwZxNWxID3Ej7YYYcxQi8Q/fIrCjGAy/n2r5Z9G864YpWDfN9upNNQAR/iiOWKs"
}
```
Per ulteriori informazioni, consulta [Developing Consumers Using the Kinesis Data Streams API AWS with the SDK for Java](https://docs.aws.amazon.com/streams/latest/dev/developing-consumers-with-sdk.html) nella Amazon *Kinesis Data Streams* Developer Guide.
+ *Per i dettagli sull'API, consulta Command Reference. [GetShardIterator](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/get-shard-iterator.html)AWS CLI *
### `increase-stream-retention-period`
Il seguente esempio di codice mostra come utilizzare`increase-stream-retention-period`.
**AWS CLI**
**Come aumentare il periodo di conservazione del flusso di dati**
L’esempio `increase-stream-retention-period` seguente aumenta il periodo di conservazione (tempo durante il quale i record di dati sono accessibili dopo essere stati aggiunti al flusso) del flusso specificato a 168 ore.
```
aws kinesis increase-stream-retention-period \
--stream-name samplestream \
--retention-period-hours 168
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Modifica del periodo di conservazione dei dati](https://docs.aws.amazon.com/streams/latest/dev/kinesis-extended-retention.html) nella *Guida per gli sviluppatori di Flusso di dati Amazon Kinesis*.
+ Per i dettagli sull'API, consulta [IncreaseStreamRetentionPeriod AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/increase-stream-retention-period.html)*Command Reference*.
### `list-shards`
Il seguente esempio di codice mostra come utilizzare`list-shards`.
**AWS CLI**
**Come elencare gli shard in un flusso di dati**
L’esempio `list-shards` seguente elenca tutti gli shard nel flusso specificato, a partire dallo shard il cui ID segue immediatamente il parametro `exclusive-start-shard-id` specificato di `shardId-000000000000`.
```
aws kinesis list-shards \
--stream-name samplestream \
--exclusive-start-shard-id shardId-000000000000
```
Output:
```
{
"Shards": [
{
"ShardId": "shardId-000000000001",
"HashKeyRange": {
"StartingHashKey": "113427455640312821154458202477256070485",
"EndingHashKey": "226854911280625642308916404954512140969"
},
"SequenceNumberRange": {
"StartingSequenceNumber": "49600871682979337187563555549332609155523708941634633746"
}
},
{
"ShardId": "shardId-000000000002",
"HashKeyRange": {
"StartingHashKey": "226854911280625642308916404954512140970",
"EndingHashKey": "340282366920938463463374607431768211455"
},
"SequenceNumberRange": {
"StartingSequenceNumber": "49600871683001637932762086172474144873796357303140614178"
}
}
]
}
```
Per ulteriori informazioni, consulta [Elenco degli shard](https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-list-shards.html) nella *Guida per gli sviluppatori di Flusso di dati Amazon Kinesis*.
+ Per i dettagli sull'API, consulta [ListShards AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/list-shards.html)*Command Reference*.
### `list-streams`
Il seguente esempio di codice mostra come utilizzare`list-streams`.
**AWS CLI**
**Come elencare i flussi di dati**
L’esempio `list-streams` seguente elenca tutti i flussi di dati attivi nell’account e nella Regione correnti.
```
aws kinesis list-streams
```
Output:
```
{
"StreamNames": [
"samplestream",
"samplestream1"
]
}
```
Per ulteriori informazioni, consulta [Elenco di flussi](https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-list-streams.html) nella *Guida per gli sviluppatori di Flusso di dati Amazon Kinesis*.
+ Per i dettagli sull'API, consulta [ListStreams AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/list-streams.html)*Command Reference*.
### `list-tags-for-stream`
Il seguente esempio di codice mostra come utilizzare`list-tags-for-stream`.
**AWS CLI**
**Come elencare i tag di un flusso di dati**
L’esempio `list-tags-for-stream` seguente elenca i tag associati al flusso di dati specificato.
```
aws kinesis list-tags-for-stream \
--stream-name samplestream
```
Output:
```
{
"Tags": [
{
"Key": "samplekey",
"Value": "example"
}
],
"HasMoreTags": false
}
```
Per ulteriori informazioni, consulta [Tagging dei flussi](https://docs.aws.amazon.com/streams/latest/dev/tagging.html) nella *Guida per gli sviluppatori di Flusso di dati Amazon Kinesis*.
+ Per i dettagli sull'API, consulta [ListTagsForStream AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/list-tags-for-stream.html)*Command Reference*.
### `merge-shards`
Il seguente esempio di codice mostra come utilizzare`merge-shards`.
**AWS CLI**
**Come unire shard**
L'`merge-shards`esempio seguente unisce due shard adiacenti con IDs shardId-000000000000 e shardId-000000000001 nel flusso di dati specificato e li combina in un unico shard.
```
aws kinesis merge-shards \
--stream-name samplestream \
--shard-to-merge shardId-000000000000 \
--adjacent-shard-to-merge shardId-000000000001
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Unione di due shard](https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-resharding-merge.html) nella *Guida per gli sviluppatori di Flusso di dati Amazon Kinesis*.
+ Per i [MergeShards](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/merge-shards.html)dettagli *AWS CLI sull'*API, consulta Command Reference.
### `put-record`
Il seguente esempio di codice mostra come utilizzare`put-record`.
**AWS CLI**
**Come scrivere un record in un flusso di dati**
L’esempio `put-record` seguente scrive un unico record di dati nel flusso di dati specificato utilizzando la chiave di partizione specificata.
```
aws kinesis put-record \
--stream-name samplestream \
--data sampledatarecord \
--partition-key samplepartitionkey
```
Output:
```
{
"ShardId": "shardId-000000000009",
"SequenceNumber": "49600902273357540915989931256901506243878407835297513618",
"EncryptionType": "KMS"
}
```
Per ulteriori informazioni, consulta [Developing Producers Using the Amazon Kinesis Data Streams API AWS with the SDK for Java](https://docs.aws.amazon.com/streams/latest/dev/developing-producers-with-sdk.html) nella Amazon *Kinesis Data Streams* Developer Guide.
+ *Per i dettagli sull'API, consulta Command Reference. [PutRecord](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/put-record.html)AWS CLI *
### `put-records`
Il seguente esempio di codice mostra come utilizzare`put-records`.
**AWS CLI**
**Come scrivere più record in un flusso di dati**
L’esempio `put-records` seguente scrive un record di dati utilizzando la chiave di partizione specificata e un altro record di dati utilizzando una chiave di partizione diversa in un’unica chiamata.
```
aws kinesis put-records \
--stream-name samplestream \
--records Data=blob1,PartitionKey=partitionkey1 Data=blob2,PartitionKey=partitionkey2
```
Output:
```
{
"FailedRecordCount": 0,
"Records": [
{
"SequenceNumber": "49600883331171471519674795588238531498465399900093808706",
"ShardId": "shardId-000000000004"
},
{
"SequenceNumber": "49600902273357540915989931256902715169698037101720764562",
"ShardId": "shardId-000000000009"
}
],
"EncryptionType": "KMS"
}
```
Per ulteriori informazioni, consulta [Developing Producers Using the Amazon Kinesis Data Streams API AWS with the SDK for Java](https://docs.aws.amazon.com/streams/latest/dev/developing-producers-with-sdk.html) nella Amazon *Kinesis Data Streams* Developer Guide.
+ *Per i dettagli sull'API, consulta Command Reference. [PutRecords](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/put-records.html)AWS CLI *
### `register-stream-consumer`
Il seguente esempio di codice mostra come utilizzare`register-stream-consumer`.
**AWS CLI**
**Come registrare un consumer del flusso di dati**
L’esempio `register-stream-consumer` seguente registra un consumer denominato `KinesisConsumerApplication` con il flusso di dati specificato.
```
aws kinesis register-stream-consumer \
--stream-arn arn:aws:kinesis:us-west-2:012345678912:stream/samplestream \
--consumer-name KinesisConsumerApplication
```
Output:
```
{
"Consumer": {
"ConsumerName": "KinesisConsumerApplication",
"ConsumerARN": "arn:aws:kinesis:us-west-2: 123456789012:stream/samplestream/consumer/KinesisConsumerApplication:1572383852",
"ConsumerStatus": "CREATING",
"ConsumerCreationTimestamp": 1572383852.0
}
}
```
Per ulteriori informazioni, consulta [Sviluppo di applicazioni consumer con fan-out avanzato con l’API di Flusso dati Kinesis](https://docs.aws.amazon.com/streams/latest/dev/building-enhanced-consumers-api.html) nella *Guida per gli sviluppatori di Flusso di dati Amazon Kinesis*.
+ Per i dettagli sull'API, consulta [RegisterStreamConsumer AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/register-stream-consumer.html)*Command Reference*.
### `remove-tags-from-stream`
Il seguente esempio di codice mostra come utilizzare`remove-tags-from-stream`.
**AWS CLI**
**Come rimuovere i tag da un flusso di dati**
L’esempio `remove-tags-from-stream` seguente rimuove il tag con la chiave specificata dal flusso di dati specificato.
```
aws kinesis remove-tags-from-stream \
--stream-name samplestream \
--tag-keys samplekey
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Tagging dei flussi](https://docs.aws.amazon.com/streams/latest/dev/tagging.html) nella *Guida per gli sviluppatori di Flusso di dati Amazon Kinesis*.
+ Per i dettagli sull'API, consulta [RemoveTagsFromStream AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/remove-tags-from-stream.html)*Command Reference*.
### `split-shard`
Il seguente esempio di codice mostra come utilizzare`split-shard`.
**AWS CLI**
**Come dividere gli shard**
L’esempio `split-shard` seguente divide lo shard specificato in due nuovi shard utilizzando una nuova chiave hash iniziale pari a 10.
```
aws kinesis split-shard \
--stream-name samplestream \
--shard-to-split shardId-000000000000 \
--new-starting-hash-key 10
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Suddivisione di uno shard](https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-resharding-split.html) nella *Guida per gli sviluppatori di Flusso di dati Amazon Kinesis*.
+ Per i dettagli sull'API, consulta [SplitShard AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/split-shard.html)*Command Reference*.
### `start-stream-encryption`
Il seguente esempio di codice mostra come utilizzare`start-stream-encryption`.
**AWS CLI**
**Come abilitare la crittografia del flusso di dati**
L'`start-stream-encryption`esempio seguente abilita la crittografia lato server per lo stream specificato, utilizzando la chiave AWS KMS specificata.
```
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
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Protezione dei dati in Flusso di dati Amazon Kinesis](https://docs.aws.amazon.com/streams/latest/dev/server-side-encryption.html) nella *Guida per gli sviluppatori di Flusso di dati Amazon Kinesis*.
+ *Per i dettagli sull'API, vedere [StartStreamEncryption](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/start-stream-encryption.html)in AWS CLI Command Reference.*
### `stop-stream-encryption`
Il seguente esempio di codice mostra come utilizzare`stop-stream-encryption`.
**AWS CLI**
**Come disabilitare la crittografia del flusso di dati**
L'`stop-stream-encryption`esempio seguente disabilita la crittografia lato server per lo stream specificato, utilizzando la chiave KMS specificata AWS .
```
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
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Protezione dei dati in Flusso di dati Amazon Kinesis](https://docs.aws.amazon.com/streams/latest/dev/server-side-encryption.html) nella *Guida per gli sviluppatori di Flusso di dati Amazon Kinesis*.
+ *Per i dettagli sull'API, vedere [StopStreamEncryption](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/stop-stream-encryption.html)in Command Reference.AWS CLI *
### `update-shard-count`
Il seguente esempio di codice mostra come utilizzare`update-shard-count`.
**AWS CLI**
**Come aggiornare il numero di shard in un flusso di dati**
L’esempio `update-shard-count` seguente aggiorna il numero di shard del flusso di dati specificato a 6. Questo esempio utilizza un dimensionamento uniforme, che crea shard di dimensioni uguali.
```
aws kinesis update-shard-count \
--stream-name samplestream \
--scaling-type UNIFORM_SCALING \
--target-shard-count 6
```
Output:
```
{
"StreamName": "samplestream",
"CurrentShardCount": 3,
"TargetShardCount": 6
}
```
Per ulteriori informazioni, consulta [Resharding di un flusso](https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-resharding.html) nella *Guida per gli sviluppatori di Flusso di dati Amazon Kinesis*.
+ Per i dettagli sull'API, consulta [UpdateShardCount AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/update-shard-count.html)*Command Reference*.