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à.

# StreamJournalToKinesis
<a name="API_StreamJournalToKinesis"></a>

Crea uno stream di journal per un determinato registro Amazon QLDB. Il flusso acquisisce ogni revisione del documento di cui viene eseguito il commit al journal del libro mastro e invia i dati a una specifica risorsa Amazon Kinesis Data Streams.

## Sintassi della richiesta
<a name="API_StreamJournalToKinesis_RequestSyntax"></a>

```
POST /ledgers/name/journal-kinesis-streams HTTP/1.1
Content-type: application/json

{
   "ExclusiveEndTime": number,
   "InclusiveStartTime": number,
   "KinesisConfiguration": { 
      "AggregationEnabled": boolean,
      "StreamArn": "string"
   },
   "RoleArn": "string",
   "StreamName": "string",
   "Tags": { 
      "string" : "string" 
   }
}
```

## Parametri della richiesta URI
<a name="API_StreamJournalToKinesis_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-uri-LedgerName"></a>
Il nome del libro mastro.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.  
Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Campo obbligatorio: sì

## Corpo della richiesta
<a name="API_StreamJournalToKinesis_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [ExclusiveEndTime](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-ExclusiveEndTime"></a>
Data e ora esclusive che specificano quando termina il flusso. Se non si definisce questo parametro, il flusso viene eseguito a tempo indeterminato fino a quando non lo si annulla.  
`ExclusiveEndTime` deve essere in formato data e ora `ISO 8601` e in Universal Coordinated Time (UTC). Ad esempio: `2019-06-13T21:36:34Z`.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** [InclusiveStartTime](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-InclusiveStartTime"></a>
Data e ora di inizio inclusive da cui iniziare lo streaming dei dati del journal. Questo parametro deve essere in formato data e ora `ISO 8601` e in Universal Coordinated Time (UTC). Ad esempio: `2019-06-13T21:36:34Z`.  
`InclusiveStartTime` non può essere in futuro e deve essere precedente a `ExclusiveEndTime`.  
Se si fornisce un `InclusiveStartTime` che è precedente a `CreationDateTime` del libro mastro, QLDB viene effettivamente impostato in modo predefinito su `CreationDateTime` del libro mastro.  
Tipo: Timestamp  
Campo obbligatorio: sì

 ** [KinesisConfiguration](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-KinesisConfiguration"></a>
Le impostazioni di configurazione della destinazione Kinesis Data Streams per la richiesta di flusso.  
Tipo: oggetto [KinesisConfiguration](API_KinesisConfiguration.md)  
Campo obbligatorio: sì

 ** [RoleArn](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-RoleArn"></a>
L'Amazon Resource Name (ARN) del ruolo IAM che concede autorizzazioni QLDB per un flusso di journal per scrivere record di dati in una risorsa Kinesis Data Streams.  
Per passare un ruolo a QLDB quando si richiede un flusso journal, è necessario disporre delle autorizzazioni per eseguire l'operazione `iam:PassRole` sulla risorsa del ruolo IAM. Questa operazione è necessaria per tutte le richieste di flusso journal.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 1600 caratteri.  
Campo obbligatorio: sì

 ** [StreamName](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-StreamName"></a>
Il nome che si desidera assegnare al flusso del journal QLDB. I nomi definiti dall'utente possono aiutare a identificare e indicare lo scopo di un flusso.  
Il nome del flusso deve essere univoco tra gli altri flussi *attivi* per un determinato libro mastro. I nomi dei flussi hanno gli stessi vincoli per la denominazione dei nomi dei libri mastri, come definito nell'argomento relativo alle [quote in Amazon QLDB](https://docs.aws.amazon.com/qldb/latest/developerguide/limits.html#limits.naming) in *Amazon QLDB Developer Guide*.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.  
Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Campo obbligatorio: sì

 ** [Tags](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-Tags"></a>
Le coppie chiave-valore da aggiungere come tag allo stream che desideri creare. Le chiavi dei tag prevedono una distinzione tra lettere maiuscole e minuscole. I valori dei tag fanno distinzione tra maiuscole e minuscole e possono essere nulli.  
Tipo: mappatura stringa a stringa  
Voci sulla mappa: numero minimo di 0 elementi. Numero massimo di 200 elementi.  
Limitazioni di lunghezza della chiave: la lunghezza minima è 1. La lunghezza massima è 128 caratteri.  
Limiti di lunghezza del valore: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Campo obbligatorio: no

## Sintassi della risposta
<a name="API_StreamJournalToKinesis_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "StreamId": "string"
}
```

## Elementi di risposta
<a name="API_StreamJournalToKinesis_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [StreamId](#API_StreamJournalToKinesis_ResponseSyntax) **   <a name="qldb-StreamJournalToKinesis-response-StreamId"></a>
L'UUID (rappresentato nel testo con codifica Base62) che QLDB assegna a ogni flusso di journal QLDB.  
Tipo: stringa  
Vincoli di lunghezza: lunghezza fissa di 22.  
Modello: `^[A-Za-z-0-9]+$` 

## Errori
<a name="API_StreamJournalToKinesis_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InvalidParameterException **   
Uno o più parametri nella richiesta non sono validi.  
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

 ** ResourcePreconditionNotMetException **   
L'operazione non è riuscita perché una condizione non era soddisfatta in anticipo.  
Codice di stato HTTP: 412

## Vedi anche
<a name="API_StreamJournalToKinesis_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK per.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/StreamJournalToKinesis)