Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Apprendre à utiliser les SDK intégrations AWS de services dans Step Functions

AWS Step Functions s'intègre à Services AWS, afin que vous puissiez appeler les API actions du service depuis vos flux de travail. Vous pouvez utiliser les AWS SDKintégrations de Step Functions pour appeler presque toutes Service AWS API les actions depuis votre machine à états. Vous pouvez également utiliser les intégrations optimisées de Step Functions, dont chacune a été personnalisée pour fournir des fonctionnalités spéciales pour votre flux de travail.

Certains services SDKs peuvent ne pas être disponibles sous forme d' AWS SDKintégrations, temporairement ou définitivement. Les SDK interactions des services récemment publiés peuvent ne pas être disponibles avant une mise à jour ultérieure. Certains services nécessitent une configuration personnalisée, telle que la spécification d'un point de terminaison spécifique au client, qui peut être plus adapté à une intégration optimisée. D'autres ne SDKs sont pas adaptés à une utilisation dans un flux de travail, tels que ceux destinés au streaming audio ou vidéo. Enfin, certains services peuvent être suspendus jusqu'à ce qu'ils passent certaines validations internes effectuées par Step Functions.

Utilisation des intégrations AWS SDK de services

Pour utiliser AWS SDK les intégrations, vous devez spécifier le nom et l'APIappel du service et, éventuellement, un modèle d'intégration du service.

Vous pouvez appeler AWS SDK des services directement depuis l'Amazon States Language dans le Resource champ de l'état d'une tâche. Pour ce faire, utilisez la syntaxe suivante :

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

Par exemple, pour AmazonEC2, vous pouvez utiliserarn:aws:states:::aws-sdk:ec2:describeInstances. Cela renverrait le résultat tel que défini pour l'EC2describeInstancesAPIappel Amazon.

Si une AWS SDK intégration rencontre une erreur, le champ d'erreur résultant sera composé du nom du service et du nom de l'erreur, séparés par un point :ServiceName.ErrorName. Le nom du service et le nom de l'erreur sont tous deux en cas de Pascal. Vous pouvez également voir le nom du service dans le champ Ressource de l'état de la tâche en minuscules. La documentation de API référence du service cible répertorie les noms des erreurs potentielles.

Prenons un exemple dans lequel vous pourriez utiliser l' AWS SDKintégrationarn:aws:states:::aws-sdk:acmpca:deleteCertificateAuthority. La AWS Private Certificate Authority APIréférence indique que l'DeleteCertificateAuthorityAPIaction peut entraîner une erreur nomméeResourceNotFoundException. Pour gérer cette erreur, vous devez spécifier l'erreur AcmPca.ResourceNotFoundException dans les récupérateurs ou les capteurs de votre état de tâche.

Considérez un autre nom d'erreur, cette fois l'CreateBucketaction. Le Amazon Simple Storage Service API Reference répertorie l'erreurBucketAlreadyExists. Notez qu'il ne possède pas le suffixe Exception. Pour gérer cette erreur dans Step Functions, appelez-laS3.BucketAlreadyExistsException. La convention de dénomination des erreurs du service S3 est différente des erreurs décrites dans la AWS Private Certificate Authority APIréférence mentionnée précédemment. Quoi qu'il en soit, dans les deux cas, vous devez inclure le suffixe Exception pour les erreurs potentielles dans l'intégration de Step Functions.

Pour plus d'informations sur la gestion des erreurs avec Step Functions, consultezGestion des erreurs dans les flux de travail Step Functions.

Step Functions ne peut pas générer automatiquement de IAM politiques pour les AWS SDK intégrations. Après avoir créé votre machine d'état, vous devez accéder à la IAM console et configurer vos politiques de rôle. Pour plus d’informations, consultez Comment Step Functions génère IAM des politiques pour les services intégrés.

Consultez le Collectez des informations sur le compartiment Amazon S3 à l'aide de AWS SDKIntégrations de service didacticiel pour un exemple d'utilisation des AWS SDK intégrations.

Intégrations AWS SDK de services prises en charge

Le tableau suivant répertorie les intégrations de AWS SDK services prises en charge par Step Functions. La colonne des ressources d'Taskétat répertorie la syntaxe permettant d'appeler une API action spécifique lors de l'utilisation de l'intégration pour le service spécifié dans la colonne Nom du service sur la gauche. La colonne Date prise en charge fournit des informations sur les dates auxquelles l'intégration du service a été prise en charge. En outre, la colonne Préfixe d'exception sur la droite répertorie les préfixes d'exception pour chaque intégration de services. Ces préfixes d'exception sont présents dans les exceptions générées lorsque vous effectuez par erreur une intégration de AWS SDK service avec Step Functions.

APIActions non prises en charge pour les services pris en charge

Le tableau suivant répertorie les API actions non prises en charge pour les intégrations AWS SDK de services. La colonne de droite contient les API actions qui ne sont actuellement pas prises en charge pour le service répertorié dans la colonne de gauche.

Intégrations de services obsolètes AWS SDK

Les intégrations AWS SDK de services suivantes sont désormais obsolètes :