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-s3-step-funzione
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[Controllo delle versioni semantiche](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** |
| --- | --- |
|  Python | aws\_solutions\_constructs.aws\_s3\_step\_function |
|  TypeScript | @aws-solutions-constructs/aws-s3-step-function |
|  Java | software.amazon.awsconstructs.services.s3stepfunction |
## Overview
Questo AWS Solutions Construct implementa un bucket Amazon S3 collegato a una funzione Step AWS.
**Nota**
Questo costrutto utilizza Amazon EventBridge (Amazon CloudWatch Events) per attivare AWS Step Functions. EventBridge è più flessibile, ma l'attivazione di Step Functions con S3 Event Notifications ha meno latenza ed è più conveniente. Se il costo e/o la latenza sono un problema, è necessario considerare la distribuzione`aws-s3-lambda`e`aws-lambda-stepfunctions`al posto di questo costrutto.
Ecco una definizione di modello distribuibile minima in TypeScript:
```
import { S3ToStepFunction, S3ToStepFunctionProps } from '@aws-solutions-constructs/aws-s3-step-function';
import * as stepfunctions from '@aws-cdk/aws-stepfunctions';
const startState = new stepfunctions.Pass(this, 'StartState');
new S3ToStepFunction(this, 'test-s3-step-function-stack', {
stateMachineProps: {
definition: startState
}
});
```
## Initializer
```
new S3ToStepFunction(scope: Construct, id: string, props: S3ToStepFunctionProps);
```
*Parametri*
+ scope[`Construct`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_core.Construct.html)
+ id`string`
+ props[`S3ToStepFunctionProps`](#pattern-construct-props-22)
## Puntelli di costruzione modelli
| **Nome** | **Tipo** | **Descrizione** |
| --- | --- | --- |
| Esistente BucketObj? | [`s3.IBucket`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.IBucket.html) | Istanza esistente dell'oggetto S3 Bucket. Se questo è fornito, quindi anche fornirebucketPropsè un errore. |
| Bucket Props? | [`s3.BucketProps`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.BucketProps.html) | Proprietà facoltative fornite dall'utente per sovrascrivere le proprietà predefinite per il bucket. Ignorato se unexistingBucketObjviene fornito. |
| StateMachineProps | [`sfn.StateMachineProps`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-stepfunctions.StateMachineProps.html) | L'utente facoltativo ha fornito oggetti di scena per sovrascrivere gli oggetti di scena predefiniti per SFN.StateMachine. |
| EventRuleProps? | [`events.RuleProps`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-events.RuleProps.html) | L'utente facoltativo ha fornito EventRuleProps per sovrascrivere i valori predefiniti. |
| DeployCloudTrail? | boolean | Se distribuire un Trail in AWS CloudTrail per registrare gli eventi API in Amazon S3. L'impostazione predefinita è true. |
| CreateCloudWatchalarms | boolean | Indica se creare allarmi CloudWatch consigliati. |
| LogGroupProps? | [`logs.LogGroupProps`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-logs.LogGroupProps.html) | Elementi di scena facoltativi forniti dall'utente per sovrascrivere gli oggetti di scena predefiniti per il gruppo di log CloudWatch Logs. |
## Proprietà modelli
| **Nome** | **Tipo** | **Descrizione** |
| --- | --- | --- |
| Cloudtrail? | [`cloudtrail.Trail`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-cloudtrail.Trail.html) | Restituisce un'istanza del percorso Cloudtrail creato dal pattern. |
| CloudTrailBucket? | [`s3.Bucket`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.Bucket.html) | Restituisce un'istanza del bucket creato dal pattern per la memorizzazione dei dati di traccia Cloudtrail. |
| CloudTrailloggingBucket? | [`s3.Bucket`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.Bucket.html) | Restituisce un'istanza del bucket di registrazione creato dal pattern per il bucket principale utilizzato dal percorso Cloudtrail. |
| CloudWatchArms? | [`cloudwatch.Alarm[]`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-cloudwatch.Alarm.html) | Restituisce un elenco di uno o più allarmi CloudWatch creati dal pattern. |
| S3Bucket? | [`s3.Bucket`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.Bucket.html) | Restituisce un'istanza del bucket S3 creato dalla serie. |
| S3loggingBucket? | [`s3.Bucket`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.Bucket.html) | Restituisce un'istanza del bucket di registrazione creato dal pattern per il bucket S3. |
| StateMachine | [`sfn.StateMachine`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-stepfunctions.StateMachine.html) | Restituisce un'istanza della macchina a stati creata dal pattern. |
| StateMachineLogGroup | [`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 pattern per la macchina a stati. |
## Impostazioni predefinite
L'implementazione predefinita di questo modello senza sostituzioni imposterà i seguenti valori predefiniti:
### Amazon S3
+ Configurare la registrazione accesso per S3 Bucket
+ Abilita la crittografia lato server per S3 Bucket utilizzando la chiave AWS gestita KMS.
+ Attivare il controllo delle versioni per S3 Bucket.
+ Non consentire l'accesso pubblico per S3 Bucket.
+ Mantenere il bucket S3 quando si elimina lo stack CloudFormation.
+ Applicazione della crittografia dei dati in transito
+ Applica la regola del ciclo di vita per spostare le versioni degli oggetti non correnti nell'archivio Glacier dopo 90 giorni.
### AWS CloudTrail
+ Configurare un percorso in AWS CloudTrail per registrare gli eventi API in Amazon S3 relativi al bucket creato dal Costrutto.
### Amazon CloudWatch Events Regola
+ Concedere le autorizzazioni di privilegi minimi agli eventi CloudWatch per attivare la funzione Lambda.
### AWS Step Funzione
+ Abilitare la registrazione CloudWatch per API Gateway.
+ Distribuisci le best practice CloudWatch Allarmi per la funzione Step.
## Architecture
## GitHub
Per visualizzare il codice per questo modello, creare/visualizzare problemi e richieste pull e altro ancora:
