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

# aws-apigateway-kinesisstream
<a name="aws-apigateway-kinesisstreams"></a>

![](https://docs.aws.amazon.com/it_it/solutions/latest/constructs/images/experimental.png)


 Tutte le classi sono in fase di sviluppo attivo e soggette a modifiche o rimozione non compatibili con le versioni precedenti in qualsiasi versione futura. Questi non sono soggetti alla[Semantic Versioning](https://semver.org/)Modello. Ciò significa che, mentre è possibile utilizzarli, potrebbe essere necessario aggiornare il codice sorgente quando si esegue l'aggiornamento a una versione più recente di questo pacchetto. 

**Nota:** Per garantire la corretta funzionalità, i pacchetti AWS Solutions Constructs e i pacchetti AWS CDK nel progetto devono essere della stessa versione. 


|  **Linguaggio**  |  **Pacchetto**  | 
| --- | --- | 
|  ![](https://docs.aws.amazon.com/it_it/solutions/latest/constructs/images/python.png) Python  |  aws\_solutions\_constructs.aws\_apigateway\_kinesisstreams  | 
|  ![](https://docs.aws.amazon.com/it_it/solutions/latest/constructs/images/typescript.png) TypeScript  |  @aws-solutions-constructs/aws-apigateway-kinesisstreams  | 
|  ![](https://docs.aws.amazon.com/it_it/solutions/latest/constructs/images/java.png) Java  |  software.amazon.awsconstructs.services.apigatewaykinesisstreams  | 

## Overview
<a name="overview-29"></a>

 Questo modello implementa un'Amazon API Gateway API connessa a un flusso di dati Amazon Kinesis. 

 Ecco una definizione di modello distribuibile minima in TypeScript: 

```
import { ApiGatewayToKinesisStreams, ApiGatewayToKinesisStreamsProps } from '@aws-solutions-constructs/aws-apigateway-kinesisstreams';

new ApiGatewayToKinesisStreams(this, 'test-apigw-kinesis', {});
```

## Initializer
<a name="initializer-29"></a>

```
new ApiGatewayToKinesisStreams(scope: Construct, id: string, props: ApiGatewayToKinesisStreamsProps);
```

 *Parametri* 
+  scope[`Construct`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_core.Construct.html) 
+  id`string` 
+  props[`ApiGatewayToKinesisStreamsProps`](#pattern-construct-props-29) 

## Puntelli di costruzione modelli
<a name="pattern-construct-props-29"></a>


|  **Nome**  |  **Tipo**  |  **Descrizione**  | 
| --- | --- | --- | 
|  ApiGatewayProps?  |  [`api.RestApiProps`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-apigateway.RestApiProps.html)  |  Accessori di scena facoltativi forniti dall'utente per sovrascrivere gli oggetti di scena predefiniti per l'API REST del gateway API.  | 
|  PutRecordRequestTemplate?  |  string  |  Modello di richiesta API Gateway per l'azione PutRecord. Se non viene fornito, verrà utilizzato uno predefinito.  | 
|  PutRecordRequestModel?  |  [`api.ModelOptions`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-apigateway.ModelOptions.html)  |  Modello di richiesta API Gateway per l'azione PutRecord. Se non viene fornito, ne verrà creato uno predefinito.  | 
|  PutRecordsRequestTemplate?  |  string  |  Modello di richiesta API Gateway per l'azione PutRecords. Se non viene fornito, verrà utilizzato uno predefinito.  | 
|  PutRecordRequestModel?  |  [`api.ModelOptions`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-apigateway.ModelOptions.html)  |  Modello di richiesta API Gateway per l'azione PutRecords. Se non viene fornito, ne verrà creato uno predefinito.  | 
|  StreamObj esistente?  |  [`kinesis.Stream`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kinesis.Stream.html)  |  Istanza esistente di Kinesis Stream, fornendo sia questo chekinesisStreamPropsIn caso contrario, si verifica un errore  | 
|  KinesisStreamProps?  |  [`kinesis.StreamProps`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kinesis.StreamProps.html)  |  Puntelli opzionali forniti dall'utente per sovrascrivere gli oggetti di scena predefiniti per il flusso Kinesis.  | 
|  LogGroupProps?  |  [`logs.LogGroupProps`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-logs.LogGroupProps.html)  |  Opzionali forniti dall'utente per sovrascrivere gli oggetti di scena predefiniti per il gruppo di log CloudWatch Logs.  | 

## Proprietà modelli
<a name="pattern-properties-29"></a>


|  **Nome**  |  **Tipo**  |  **Descrizione**  | 
| --- | --- | --- | 
|  ApiGateway  |  [`api.RestApi`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-apigateway.RestApi.html)  |  Restituisce un'istanza dell'API REST del gateway API creata dal modello.  | 
|  ApiGatewayRole  |  [`iam.Role`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-iam.Role.html)  |  Restituisce un'istanza del ruolo IAM creato dal pattern per l'API REST del gateway API.  | 
|  APigatewayCloudWatchRole  |  [`iam.Role`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-iam.Role.html)  |  Restituisce un'istanza del ruolo IAM creato dal pattern che abilita la registrazione degli accessi dall'API REST del gateway API a CloudWatch.  | 
|  ApiGatewayLogGroup  |  [`logs.LogGroup`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-logs.LogGroup.html)  |  Restituisce un'istanza del gruppo di log creato dal modello a cui vengono inviati i log di accesso API REST del API Gateway API.  | 
|  KinesisStream  |  [`kinesis.Stream`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kinesis.Stream.html)  |  Restituisce un'istanza del flusso Kinesis creato dal pattern.  | 

## Uso dell'API di esempio
<a name="sample-api-usage"></a>


|  **Metodo**  |  **Percorso della richiesta**  |  **Corpo della richiesta**  |  **Azione coda**  |  **Descrizione**  | 
| --- | --- | --- | --- | --- | 
|  POST  |  /record  |  <pre>{ <br />  "data": "Hello World!", <br />  "partitionKey": "pk001"<br />}</pre>  |  kinesis:PutRecord  |  Scrive un singolo record di dati nel flusso.  | 
|  POST  |  /records  |  <pre>{ <br />    "records": [<br />      { "data": "abc", <br />        "partitionKey": "pk001" <br />      }, <br />      { "data": "xyz", <br />        "partitionKey": "pk001" <br />      }<br />     ] <br />}</pre>  |  kinesis:PutRecords  |  Scrive più record di dati nel flusso in una singola chiamata.  | 

## Impostazioni predefinite
<a name="default-settings-29"></a>

 L'implementazione predefinita di questo modello senza sostituzioni imposterà i seguenti valori predefiniti:

### Amazon API Gateway
<a name="amazon-api-gateway-29"></a>
+  Distribuzione di un endpoint API ottimizzato per gli edge. 
+  Abilitare la registrazione CloudWatch per API Gateway. 
+  Configurare il ruolo IAM di accesso ai privilegi minimi per il API Gateway. 
+  Impostare l'AuthorizationType predefinito per tutti i metodi API su IAM. 
+  Abilitare il tracciamento X-Ray. 
+  Convalidare il corpo della richiesta prima di passare i dati a Kinesis. 

### Amazon Kinesis Data Stream
<a name="amazon-sqs-queue"></a>
+  Configurare il ruolo IAM di accesso ai privilegi minimi per il flusso Kinesis. 
+  Abilita la crittografia lato server per Kinesis Stream utilizzando AWS Managed KMS Key. 

## Architecture
<a name="architecture-29"></a>

![](https://docs.aws.amazon.com/it_it/solutions/latest/constructs/images/aws-apigateway-kinesisstreams.png)


## GitHub
<a name="github-29"></a>


<table>
<thead>
  <tr><th colspan="2"> <b>Per visualizzare il codice per questo modello, creare/visualizzare problemi e richieste pull e altro ancora:</b> </th></tr>
</thead>
<tbody>
  <tr><td> <img src="https://docs.aws.amazon.com/it_it/solutions/latest/constructs/images/GitHub-Mark-32px.png" alt="" /> </td><td> <a href="https://github.com/awslabs/aws-solutions-constructs/tree/master/source/patterns/%40aws-solutions-constructs/aws-apigateway-kinesisstreams">@aws -solutions-constructs/aws-apigateway-kinesisstream</a> </td></tr>
</tbody>
</table>