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 Integrazioni di servizi SDK

AWS Step Functions si integra con Servizi AWS, consentendoti di richiamare le azioni API di ciascun servizio dal tuo flusso di lavoro. Puoi utilizzare le integrazioni AWS SDK di Step Functions per richiamare quasi tutte Servizio AWS le azioni API 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 o SDK potrebbero non essere disponibili come integrazioni AWS SDK, temporaneamente o permanentemente. I servizi rilasciati di recente potrebbero non avere interazioni SDK 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 SDK non 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 dei servizi SDK AWS

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

Puoi chiamare i servizi AWS SDK 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 Amazon EC2, potresti usare. arn:aws:states:::aws-sdk:ec2:describeInstances Ciò restituirebbe l'output definito per la chiamata API DescribeInstances di Amazon EC2.

Se un'integrazione AWS SDK 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, in lettere minuscole, nel campo Risorsa dello stato dell'attività. Puoi trovare i nomi dei potenziali errori nella documentazione di riferimento dell'API del servizio di destinazione.

Ad esempio, potresti utilizzare l'integrazione arn:aws:states:::aws-sdk:acmpca:deleteCertificateAuthority AWS SDK. L'AWS Private Certificate Authority API Reference indica che l'azione DeleteCertificateAuthority API può generare, ad esempioResourceNotFoundException, un. Per gestire questo errore, dovreste quindi specificare l'errore AcmPca.ResourceNotFoundException nei Retrier o Catcher dello stato dell'operazione. Per ulteriori informazioni sulla gestione degli errori in Step Functions, vedereGestione degli errori in Step Functions.

Step Functions non è in grado di generare automaticamente le policy IAM per le integrazioni SDK AWS . Dopo aver creato la macchina a stati, dovrai accedere alla console IAM e configurare le policy relative ai ruoli. Per ulteriori informazioni, consulta Politiche IAM per servizi integrati.

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

Integrazioni di servizi AWS SDK supportate

La tabella seguente elenca le integrazioni dei servizi AWS SDK supportate da Step Functions. La colonna TaskState Resource elenca la sintassi per richiamare un'azione API specifica quando si utilizza l'integrazione per il servizio specificato 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 del AWS servizio SDK con Step Functions.

Azioni API non supportate per i servizi supportati

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

Integrazioni di servizi SDK obsolete AWS

Le seguenti integrazioni di servizi AWS SDK sono ora obsolete: