Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Aprender a usar AWS SDKintegraciones de servicios en Step Functions

AWS Step Functions se integra con Servicios de AWS, para que pueda denominar API las acciones del servicio desde sus flujos de trabajo. Puedes usar Step Functions' AWS SDKintegraciones para llamar a casi cualquier Servicio de AWS las API acciones de tu máquina de estados. También puede utilizar las integraciones optimizadas de Step Functions, cada una de las cuales se ha personalizado para proporcionar una funcionalidad especial para el flujo de trabajo.

Algunos servicios SDKs pueden o no estar disponibles como AWS SDKintegraciones, ya sea de forma temporal o permanente. Es posible que SDK las interacciones de los servicios lanzados recientemente no estén disponibles hasta una actualización posterior. Algunos servicios requieren una configuración personalizada, como especificar un punto de conexión específico para el cliente, lo que puede ser más adecuado para una integración optimizada. Otros no SDKs son adecuados para su uso en un flujo de trabajo, como los de transmisión de audio o vídeo. Por último, algunos servicios pueden retenerse hasta que superen determinadas validaciones internas realizadas por Step Functions.

Utilización AWS SDKintegraciones de servicios

Para utilizar AWS SDKen las integraciones, se especifica el nombre y la API llamada del servicio y, si lo desea, un patrón de integración de servicios.

Puede llamar AWS SDKservicios directamente desde el idioma de los estados de Amazon en el Resource campo de un estado de tarea. Para ello, utilice la siguiente sintaxis:

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

Por ejemplo, para AmazonEC2, puedes usararn:aws:states:::aws-sdk:ec2:describeInstances. Esto devolvería el resultado definido para la EC2 describeInstances API llamada de Amazon.

Si un AWS SDKla integración encuentra un error, el campo Error resultante estará compuesto por el nombre del servicio y el nombre del error, separados por un punto:ServiceName.ErrorName. Tanto el nombre del servicio como el nombre del error están en Pascal case. También puede ver el nombre del servicio, en minúsculas, en el campo Resource del estado Task. Puede encontrar los nombres de los posibles errores en la documentación de API referencia del servicio de destino.

Por ejemplo, puede utilizar el arn:aws:states:::aws-sdk:acmpca:deleteCertificateAuthority AWS SDKintegración. Con la AWS Private Certificate Authority APILa referencia indica que la DeleteCertificateAuthority API acción puede resultar enResourceNotFoundException, por ejemplo, una. Para gestionar este error, debe especificar el valor de AcmPca.ResourceNotFoundException del Error en los “reintentadores” o detectores del estado de la tarea. Para obtener más información sobre la gestión de errores en Step Functions, consulte Gestión de errores en los flujos de trabajo de Step Functions.

Step Functions no puede generar automáticamente IAM políticas para AWS SDKintegraciones. Tras crear la máquina de estados, tendrá que ir a la IAM consola y configurar las políticas de sus funciones. Para obtener más información, consulte Cómo Step Functions genera IAM políticas para servicios integrados.

Consulte el Recopile información sobre el bucket de Amazon S3 mediante AWS SDKintegraciones de servicios tutorial para ver un ejemplo de cómo usar AWS SDKintegraciones.

Compatible AWS SDKintegraciones de servicios

En la siguiente tabla se enumeran las AWS SDKintegraciones de servicios compatibles con Step Functions. La columna de recursos Task estatales muestra la sintaxis para invocar una API acción específica cuando se utiliza la integración para el servicio especificado en la columna de nombre de servicio de la izquierda. La columna Fecha de admisión proporciona información sobre las fechas en las que se permitió la integración del servicio. Además, la columna Prefijo de excepción de la derecha muestra los prefijos de excepción para cada integración de servicios. Estos prefijos de excepción están presentes en las excepciones que se generan cuando se realiza una AWS SDKintegración de servicios con Step Functions.

APIAcciones no compatibles para los servicios compatibles

En la siguiente tabla se enumeran las acciones no compatibles API para AWS SDKintegraciones de servicios. La columna de la derecha contiene las API acciones que actualmente no se admiten en el servicio que aparece en la columna de la izquierda.

Obsoleto AWS SDKintegraciones de servicios

Los siguientes ejemplos de AWS SDKlas integraciones de servicios ahora están en desuso: