

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::Serverless::StateMachine

Crea un AWS Step Functions macchina a stati, che puoi usare per orchestrare AWS Lambda Funzioni relative agli eventi e altro AWS risorse per creare flussi di lavoro complessi e solidi.

Per ulteriori informazioni su Step Functions, consulta la [AWS Step Functions Guida per sviluppatori di ](https://docs.aws.amazon.com/step-functions/latest/dg/welcome.html).

Questa risorsa supporta anche `Connectors` risorsa `Attribute`. Per ulteriori informazioni, consulta [Gestione delle autorizzazioni delle risorse con AWS SAM connettori](managing-permissions-connectors.md).

**Nota**  
Quando esegui il deployment su AWS CloudFormation, AWS SAM trasforma il tuo AWS SAM risorse in CloudFormation risorse. Per ulteriori informazioni, consulta [Generato CloudFormation risorse per AWS SAM](sam-specification-generated-resources.md).

## Sintassi
<a name="sam-resource-statemachine-syntax"></a>

Per dichiarare questa entità nel tuo AWS Serverless Application Model (AWS SAM) modello, utilizzare la seguente sintassi.

### YAML
<a name="sam-resource-statemachine-syntax.yaml"></a>

```
Type: AWS::Serverless::StateMachine
Properties:
  AutoPublishAlias: {{String}}
  UseAliasAsEventTarget: {{Boolean}}
  [Definition](#sam-statemachine-definition): {{Map}}
  [DefinitionSubstitutions](#sam-statemachine-definitionsubstitutions): {{Map}}
  [DefinitionUri](#sam-statemachine-definitionuri): {{String | [S3Location](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-definitions3location)}}
  DeploymentPreference: {{[DeploymentPreference](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stepfunctions-statemachinealias-deploymentpreference.html)}}
  [Events](#sam-statemachine-events): {{EventSource}}
  [Logging](#sam-statemachine-logging): {{[LoggingConfiguration](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-loggingconfiguration)}}
  [Name](#sam-statemachine-name): {{String}}
  [PermissionsBoundary](#sam-statemachine-permissionsboundary): {{String}}
  [Policies](#sam-statemachine-policies): {{String | List | Map}}
  PropagateTags: {{Boolean}}
  [RolePath](#sam-statemachine-rolepath): {{String}}
  [Role](#sam-statemachine-role): {{String}}
  [Tags](#sam-statemachine-tags): {{Map}}
  [Tracing](#sam-statemachine-tracing): {{[TracingConfiguration](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-tracingconfiguration)}}
  [Type](#sam-statemachine-type): {{String}}
```

## Properties
<a name="sam-resource-statemachine-properties"></a>

 `AutoPublishAlias`   <a name="sam-statemachine-autopublishalias"></a>
Il nome dell'alias della macchina a stati. Per ulteriori informazioni sull'utilizzo degli alias delle macchine a stati Step Functions, vedete [ Gestisci le distribuzioni continue con versioni e alias](https://docs.aws.amazon.com/step-functions/latest/dg/concepts-cd-aliasing-versioning.html) nel *AWS Step Functions Guida per gli sviluppatori*.  
Uso `DeploymentPreference` per configurare le preferenze di distribuzione per il tuo alias. Se non lo specifichi `DeploymentPreference`, AWS SAM configurerà il traffico per passare contemporaneamente alla versione più recente della macchina a stati.  
AWS SAM imposta la versione `DeletionPolicy` e `UpdateReplacePolicy` a `Retain` per impostazione predefinita. Le versioni precedenti non verranno eliminate automaticamente.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: Questa proprietà viene passata direttamente al ` [ Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachinealias.html#cfn-stepfunctions-statemachinealias-name)` proprietà di un `AWS::StepFunctions::StateMachineAlias` risorsa.

 `UseAliasAsEventTarget`   <a name="sam-statemachine-usealiasaseventtarget"></a>
Indicare se passare o meno l'alias, creato utilizzando `AutoPublishAlias` proprietà, alla destinazione della fonte degli eventi definita con [Eventi](#sam-statemachine-events).  
Specificare `True` per utilizzare l'alias come destinazione degli eventi.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*Default*: `False`  
*CloudFormation compatibilità*: Questa proprietà è unica per AWS SAM e non ha un CloudFormation equivalente.

 `Definition`   <a name="sam-statemachine-definition"></a>
La definizione di macchina a stati è un oggetto, in cui il formato dell'oggetto corrisponde al formato del tuo AWS SAM file modello, ad esempio JSON o YAML. Le definizioni delle macchine a stati aderiscono ad [Amazon States Language](https://docs.aws.amazon.com/step-functions/latest/dg/concepts-amazon-states-language.html).  
Per un esempio di definizione di macchina a stati in linea, vedi [Esempi](#sam-resource-statemachine--examples).  
È necessario fornire un `Definition` o un `DefinitionUri`.  
*Tipo*: Mappa  
*Required*: Conditional  
*CloudFormation compatibilità*: Questa proprietà è unica per AWS SAM e non ha un CloudFormation equivalente.

 `DefinitionSubstitutions`   <a name="sam-statemachine-definitionsubstitutions"></a>
Una mappa da stringa a stringa che specifica le mappature per le variabili segnaposto nella definizione della macchina a stati. Ciò consente di inserire valori ottenuti in fase di esecuzione (ad esempio, da funzioni intrinseche) nella definizione della macchina a stati.  
*Digitare*: Mappa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: Questa proprietà è simile alla `[DefinitionSubstitutions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-definitionsubstitutions)` proprietà di un `AWS::StepFunctions::StateMachine` risorsa. Se una funzione intrinseca è specificata in una definizione di macchina a stati in linea, AWS SAM aggiunge voci a questa proprietà per inserirle nella definizione della macchina a stati.

 `DefinitionUri`   <a name="sam-statemachine-definitionuri"></a>
L'URI di Amazon Simple Storage Service (Amazon S3) o il percorso del file locale della definizione della macchina a stati scritta nel [Amazon States Language](https://docs.aws.amazon.com/step-functions/latest/dg/concepts-amazon-states-language.html).  
Se si fornisce un percorso di file locale, il modello deve passare attraverso il flusso di lavoro che include `sam deploy` o `sam package` comando per trasformare correttamente la definizione. Per fare ciò, è necessario utilizzare la versione 0.52.0 o successiva di AWS SAM CLI.  
È necessario fornire un `Definition` o un `DefinitionUri`.  
*Tipo*: Stringa \| [Posizione S3](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-definitions3location)  
*Required*: Conditional  
*CloudFormation compatibilità*: Questa proprietà viene passata direttamente al `[DefinitionS3Location](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-definitions3location)` proprietà di un `AWS::StepFunctions::StateMachine` risorsa.

 `DeploymentPreference`   <a name="sam-statemachine-deploymentpreference"></a>
Le impostazioni che abilitano e configurano le distribuzioni di macchine a stato graduale. Per saperne di più sulle distribuzioni graduali di Step Functions, consulta [ Gestisci le distribuzioni continue con versioni e alias](https://docs.aws.amazon.com/step-functions/latest/dg/concepts-cd-aliasing-versioning.html) nel *AWS Step Functions Guida per gli sviluppatori*.  
Specificare `AutoPublishAlias` prima di configurare questa proprietà. Il tuo `DeploymentPreference` le impostazioni verranno applicate all'alias specificato con `AutoPublishAlias`.  
Quando si specifica `DeploymentPreference`, AWS SAM genera il `StateMachineVersionArn` valore della sottoproprietà automaticamente.  
*Tipo:* [DeploymentPreference](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stepfunctions-statemachinealias-deploymentpreference.html)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: AWS SAM genera e collega il `StateMachineVersionArn` valore della proprietà a `DeploymentPreference` e passa `DeploymentPreference` al `[DeploymentPreference](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachinealias.html#cfn-stepfunctions-statemachinealias-deploymentpreference)` proprietà di un `AWS::StepFunctions::StateMachineAlias` risorsa. 

 `Events`   <a name="sam-statemachine-events"></a>
Specifica gli eventi che attivano questa macchina a stati. Gli eventi sono costituiti da un tipo e da un insieme di proprietà che dipendono dal tipo.  
*Tipo:* [EventSource](sam-property-statemachine-statemachineeventsource.md)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: Questa proprietà è unica per AWS SAM e non ha un CloudFormation equivalente.

 `Logging`   <a name="sam-statemachine-logging"></a>
Definisce quali eventi della cronologia di esecuzione vengono registrati e dove vengono registrati.  
*Tipo:* [LoggingConfiguration](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-loggingconfiguration)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: Questa proprietà viene passata direttamente al `[LoggingConfiguration](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-loggingconfiguration)` proprietà di un `AWS::StepFunctions::StateMachine` risorsa.

 `Name`   <a name="sam-statemachine-name"></a>
Il nome della macchina a stati.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: Questa proprietà viene passata direttamente al `[StateMachineName](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-statemachinename)` proprietà di un `AWS::StepFunctions::StateMachine` risorsa.

 `PermissionsBoundary`   <a name="sam-statemachine-permissionsboundary"></a>
L'ARN di un limite di autorizzazioni da utilizzare per il ruolo di esecuzione di questa macchina a stati. Questa proprietà funziona solo se il ruolo viene generato automaticamente.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: Questa proprietà viene passata direttamente al `[PermissionsBoundary](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html#cfn-iam-role-permissionsboundary)` proprietà di un `AWS::IAM::Role` risorsa.

 `Policies`   <a name="sam-statemachine-policies"></a>
Politiche di autorizzazione per questa macchina a stati. Le politiche verranno aggiunte alle impostazioni predefinite della macchina a stati AWS Identity and Access Management ruolo di esecuzione (IAM).  
Questa proprietà accetta un singolo valore o un elenco di valori. I valori autorizzati includono:  
+ [AWS SAM modelli di policy](serverless-policy-templates.md).
+ La ARN di un [AWS politica gestita](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies) o [politica gestita dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#customer-managed-policies).
+ Il nome di un AWS politica gestita tra le seguenti [ lista](https://github.com/aws/serverless-application-model/blob/develop/samtranslator/internal/data/aws_managed_policies.json).
+ Un [ politica IAM in linea](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#inline-policies) formattato in YAML come mappa.
Se si imposta il `Role` proprietà, questa proprietà viene ignorata.
*Tipo*: Stringa \| Elenco \| Mappa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: Questa proprietà è unica per AWS SAM e non ha un CloudFormation equivalente.

`PropagateTags`  <a name="sam-statemachine-propagatetags"></a>
Indicare se passare o meno i tag dal `Tags` proprietà al tuo [AWS::Serverless::StateMachine](sam-specification-generated-resources-statemachine.md) risorse generate. Specificare `True` per propagare i tag nelle risorse generate.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*Default*: `False`  
*CloudFormation compatibilità*: Questa proprietà è unica per AWS SAM e non ha un CloudFormation equivalente.

 `Role`   <a name="sam-statemachine-role"></a>
L'ARN di un ruolo IAM da utilizzare come ruolo di esecuzione di questa macchina a stati.  
*Tipo:* stringa  
*Required*: Conditional  
*CloudFormation compatibilità*: Questa proprietà viene passata direttamente al `[ RoleArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-rolearn)` proprietà di un `AWS::StepFunctions::StateMachine` risorsa.

 `RolePath`   <a name="sam-statemachine-rolepath"></a>
Il percorso del ruolo di esecuzione IAM della macchina a stati.  
Usa questa proprietà quando il ruolo viene generato per te. Non utilizzare quando il ruolo è specificato con `Role` proprietà.  
*Tipo:* stringa  
*Required*: Conditional  
*CloudFormation compatibilità*: Questa proprietà viene passata direttamente al `[Path](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html#cfn-iam-role-path)` proprietà di un `AWS::IAM::Role` risorsa.

 `Tags`   <a name="sam-statemachine-tags"></a>
Una mappa da stringa a stringa che specifica i tag aggiunti alla macchina a stati e il ruolo di esecuzione corrispondente. Per informazioni su chiavi e valori validi per i tag, consulta [Tag](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-tags) proprietà di un [AWS::StepFunctions::StateMachine](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html) risorsa.  
*Tipo*: Mappa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: Questa proprietà è simile alla `[Tags](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-tags)` proprietà di un `AWS::StepFunctions::StateMachine` risorsa. AWS SAM aggiunge automaticamente un `stateMachine:createdBy:SAM` tag a questa risorsa e al ruolo predefinito che viene generato per essa.

 `Tracing`   <a name="sam-statemachine-tracing"></a>
Seleziona se o meno AWS X-Ray è abilitato per la macchina a stati. Per ulteriori informazioni sull'uso X-Ray con Step Functions, vedere [AWS X-Ray e Step Functions](https://docs.aws.amazon.com/step-functions/latest/dg/concepts-xray-tracing.html) nel *AWS Step Functions Guida per gli sviluppatori*.  
*Tipo:* [TracingConfiguration](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-tracingconfiguration)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: Questa proprietà viene passata direttamente al `[TracingConfiguration](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-tracingconfiguration)` proprietà di un `AWS::StepFunctions::StateMachine` risorsa.

 `Type`   <a name="sam-statemachine-type"></a>
Il tipo di macchina a stati.  
*Valori validi*: `STANDARD` o `EXPRESS`  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*Default*: `STANDARD`  
*CloudFormation compatibilità*: Questa proprietà viene passata direttamente al `[StateMachineType](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-statemachinetype)` proprietà di un `AWS::StepFunctions::StateMachine` risorsa.

## Valori restituiti
<a name="sam-resource-statemachine-return-values"></a>

### Ref
<a name="sam-resource-statemachine-return-values-ref"></a>

Quando fornisci l'ID logico di questa risorsa alla funzione intrinseca Ref, Ref restituisce l'Amazon Resource Name (ARN) della risorsa sottostante `AWS::StepFunctions::StateMachine` risorsa.

Per ulteriori informazioni sull'uso di `Ref` funzione, vedere [`Ref`](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html) nel *AWS CloudFormation Guida per l'utente*. 

### Ventola::GetAtt
<a name="sam-resource-statemachine-return-values-fn--getatt"></a>

`Fn::GetAtt` restituisce un valore per un attributo specificato di questo tipo. Di seguito sono riportati gli attributi disponibili e i valori restituiti di esempio. 

Per ulteriori informazioni sull'uso `Fn::GetAtt`, vedi [`Fn::GetAtt`](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html) nel *AWS CloudFormation Guida per l'utente*. 

`Name`  <a name="Name-fn::getatt"></a>
Restituisce il nome della macchina a stati, ad esempio `HelloWorld-StateMachine`.

## Esempi
<a name="sam-resource-statemachine--examples"></a>

### File di definizione della macchina a stati
<a name="sam-resource-statemachine--examples--state-machine-definition-file"></a>

Di seguito è riportato un esempio di definizione di macchina a stati in linea che consente a una funzione lambda di richiamare una macchina a stati. Nota che questo esempio prevede il `Role` proprietà per configurare la politica appropriata per consentire l'invocazione. La `my_state_machine.asl.json` il file deve essere scritto in [Amazon States Language](https://docs.aws.amazon.com/step-functions/latest/dg/concepts-amazon-states-language.html).

In questo esempio, `DefinitionSubstitution` le voci consentono alla macchina a stati di includere risorse dichiarate in AWS SAM file modello.

#### YAML
<a name="sam-resource-statemachine--examples--state-machine-definition-file--yaml"></a>

```
MySampleStateMachine:
  Type: AWS::Serverless::StateMachine
  Properties:
    DefinitionUri: statemachine/my_state_machine.asl.json
    Role: arn:aws:iam::123456123456:role/service-role/my-sample-role
    Tracing:
      Enabled: true
    DefinitionSubstitutions:
      MyFunctionArn: !GetAtt MyFunction.Arn
      MyDDBTable: !Ref TransactionTable
```

### Definizione di macchina a stati in linea
<a name="sam-resource-statemachine--examples--inline-state-machine-definition"></a>

Di seguito è riportato un esempio di definizione di macchina a stati in linea.

In questo esempio, AWS SAM il file modello è scritto in YAML, quindi anche la definizione della macchina a stati è in YAML. Per dichiarare una definizione di macchina a stati in linea in JSON, scrivi il tuo AWS SAM file modello in JSON.

#### YAML
<a name="sam-resource-statemachine--examples--inline-state-machine-definition--yaml"></a>

```
MySampleStateMachine:
  Type: AWS::Serverless::StateMachine
  Properties:
    Definition:
      StartAt: MyLambdaState
      States:
        MyLambdaState:
          Type: Task
          Resource: arn:aws:lambda:us-east-1:123456123456:function:my-sample-lambda-app
          End: true
    Role: arn:aws:iam::123456123456:role/service-role/my-sample-role
    Tracing:
      Enabled: true
```