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

Imparare a utilizzare SDK le integrazioni AWS di servizi in Step Functions

AWS Step Functions si integra con Servizi AWS, in modo da poter richiamare API le azioni del servizio dai flussi di lavoro. Puoi utilizzare AWS SDKle integrazioni di Step Functions per richiamare quasi tutte Servizio AWS API le azioni dalla tua macchina a stati. Puoi anche utilizzare le integrazioni ottimizzate di Step Functions, ognuna delle quali è stata personalizzata per fornire funzionalità speciali per il tuo flusso di lavoro.

Alcuni servizi SDKs potrebbero non essere disponibili come AWS SDK integrazioni, temporaneamente o permanentemente. I servizi rilasciati di recente potrebbero non avere SDK interazioni disponibili fino a un aggiornamento successivo. Alcuni servizi richiedono una configurazione personalizzata, ad esempio la specifica di un endpoint specifico del cliente, che potrebbe essere più adatto per un'integrazione ottimizzata. Altri non SDKs sono adatti all'uso in un flusso di lavoro, come quelli per lo streaming di audio o video. Infine, alcuni servizi potrebbero essere sospesi fino a quando non superano determinate convalide interne eseguite da Step Functions.

Utilizzo delle integrazioni di servizi AWS SDK

Per utilizzare AWS SDK le integrazioni, è necessario specificare il nome e la API chiamata del servizio e, facoltativamente, un modello di integrazione del servizio.

Puoi chiamare AWS SDK i servizi direttamente da Amazon States Language nel Resource campo dello stato di un'attività. Per fare ciò, usa la seguente sintassi:

arn:aws:states:::aws-sdk:serviceName:apiAction.[serviceIntegrationPattern]

Ad esempio, per AmazonEC2, potresti usarearn:aws:states:::aws-sdk:ec2:describeInstances. Ciò restituirebbe l'output definito per la EC2 describeInstances API chiamata Amazon.

Se un' AWS SDKintegrazione rileva un errore, il campo Error risultante sarà composto dal nome del servizio e dal nome dell'errore, separati da un punto:. ServiceName.ErrorName Sia il nome del servizio che il nome dell'errore sono in formato Pascal. È inoltre possibile visualizzare il nome del servizio nel campo Risorsa dello stato dell'attività in lettere minuscole. La documentazione di API riferimento del servizio di destinazione elenca i nomi dei potenziali errori.

Consideriamo un esempio in cui è possibile utilizzare l' AWS SDKintegrazionearn:aws:states:::aws-sdk:acmpca:deleteCertificateAuthority. Il AWS Private Certificate Authority APIriferimento indica che l'DeleteCertificateAuthorityAPIazione può causare un errore denominatoResourceNotFoundException. Per gestire questo errore, è necessario specificare l'errore AcmPca.ResourceNotFoundException nei Retrier o Catcher dello stato dell'operazione.

Considerate un altro nome di errore, questa volta l'CreateBucketazione. L'Amazon Simple Storage Service API Reference elenca l'erroreBucketAlreadyExists. Tieni presente che non ha il suffisso Exception. Per gestire questo errore in Step Functions, chiamaloS3.BucketAlreadyExistsException. La convenzione di denominazione degli errori del servizio S3 è diversa dagli errori nel riferimento menzionato in precedenza.AWS Private Certificate Authority API Indipendentemente da ciò, in entrambi i casi è necessario includere il suffisso Exception per potenziali errori nell'integrazione Step Functions.

Per ulteriori informazioni sulla gestione degli errori con Step Functions, vedereGestione degli errori nei flussi di lavoro di Step Functions.

Step Functions non può generare automaticamente le IAM policy per le integrazioni. AWS SDK Dopo aver creato la macchina a stati, dovrai accedere alla IAM console e configurare le politiche relative ai ruoli. Per ulteriori informazioni, consulta In che modo Step Functions genera IAM politiche per servizi integrati.

Guarda il Raccogli informazioni sui bucket Amazon S3 utilizzando AWS Integrazioni dei servizi SDK tutorial per un esempio di come usare AWS SDK le integrazioni.

Integrazioni di AWS SDK servizi supportate

La tabella seguente elenca le integrazioni AWS SDK di servizi supportate da Step Functions. La colonna delle risorse di Task stato elenca la sintassi per richiamare un'APIazione specifica quando si utilizza l'integrazione per il servizio specificata nella colonna Service name a sinistra. La colonna Data supportata fornisce informazioni sulle date in cui è stata supportata l'integrazione del servizio. Inoltre, la colonna del prefisso Exception sulla destra elenca i prefissi di eccezione per ogni integrazione di servizio. Questi prefissi di eccezione sono presenti nelle eccezioni generate quando si esegue erroneamente un'integrazione AWS SDK del servizio con Step Functions.

APIAzioni non supportate per i servizi supportati

La tabella seguente elenca le azioni non supportate per API AWS SDK le integrazioni di servizi. La colonna di destra contiene le API azioni che attualmente non sono supportate per il servizio elencato nella colonna di sinistra.

Integrazioni di servizi obsolete AWS SDK

Le seguenti integrazioni di AWS SDK servizi sono ora obsolete: