Todos los productos
Search
Centro de documentos

CloudFlow:Normal integration

Última actualización: Sep 05, 2026

Con la integración normal, CloudFlow invoca directamente las operaciones de API de otros servicios de Alibaba Cloud a través de OpenAPI. Las solicitudes y respuestas de API se transmiten sin modificaciones, lo que hace que la integración normal sea compatible con la mayoría de los servicios de Alibaba Cloud en las categorías de computación elástica, almacenamiento, bases de datos, contenedores, big data, observability y middleware.

Funcionamiento

  1. CloudFlow envía una solicitud de API al servicio destino a través de OpenAPI.

  2. El servicio destino procesa la solicitud y devuelve una respuesta.

  3. CloudFlow captura la respuesta y avanza al siguiente estado del flujo de trabajo.

Especifique cada llamada de API mediante el campo Action con el formato {ServiceName}:{APIOperation}. Por ejemplo, ECS:DescribeInstances invoca la operación DescribeInstances de Elastic Compute Service (ECS).

Modos de integración

El parámetro TaskMode controla cómo gestiona CloudFlow la respuesta de la API. La siguiente tabla describe los modos disponibles.

Modo

Comportamiento

Caso de uso

RequestComplete

Espera la respuesta de la API antes de avanzar al siguiente estado.

Llamadas de API síncronas estándar (el más común).

Para conocer otros modos y sus diferencias, consulte la sección "Integration modes" de Descripción general de la integración.

Requisitos previos

Antes de empezar, asegúrese de contar con lo siguiente:

  • Una cuenta de Alibaba Cloud con CloudFlow activado

  • Un rol de ejecución de Resource Access Management (RAM) con permisos para las API del servicio destino. Por ejemplo, llamar a ECS:DescribeInstances requiere el permiso AliyunECSReadOnlyAccess

    • Si ya cuenta con un rol de RAM, selecciónelo al configurar el flujo de trabajo

    • Para crear uno, consulte la sección "Create an execution role" en Create execution roles

Crear un flujo de trabajo de integración normal

Este ejemplo invoca la operación de API DescribeInstances de ECS para consultar información de instancias.

Paso 1: Crear un flujo de trabajo

  1. Inicie sesión en la consola de CloudFlow. En la barra de navegación superior, seleccione una región.

  2. En la página Workflows, haga clic en Create Workflow.

  3. En el cuadro de diálogo Create Workflow:

    1. Seleccione Use Blank Canvas.

    2. En la sección Workflow mode, seleccione un modo de flujo de trabajo.

    3. Establezca el Workflow Name y la Workflow description.

    4. Haga clic en Create.

Paso 2: Configurar el rol de ejecución y el tiempo de espera

En la interfaz gráfica de Workflow Studio:

  1. Haga clic en la pestaña CloudFlow Studio y establezca el Timeout Period.

  2. Haga clic en la pestaña Configure Workflow y configure el Execution Role.

Paso 3: Agregar una acción de API

Agregue una acción de API mediante el editor visual o el editor YAML.

Opción A: Editor visual

  1. En la pestaña Actions del panel de vista de estados, busque DescribeInstances.

  2. Arrastre la operación de API DescribeInstances al diagrama de flujo.

  3. En el panel de configuración de la derecha, configure los parámetros de Basic Settings, Input Settings, Output Settings y Troubleshooting.

Para obtener detalles sobre los parámetros, consulte la sección "Procedure" de Create a workflow based on a blank canvas.

Opción B: Editor YAML

Haga clic en YAML en la esquina superior derecha y defina la operación de API directamente. El siguiente ejemplo consulta instancias de ECS en una VPC y un vSwitch específicos:

Type: StateMachine
Name: test
SpecVersion: v1
Timeout: 600
StartAt: DescribeInstances
States:
  - Type: Task
    Name: DescribeInstances
    Action: ECS:DescribeInstances
    TaskMode: RequestComplete
    Parameters:
      RegionId: cn-hangzhou
      VpcId: vpc-bp11y195luy47h8****
      VSwitchId: vsw-bp1wb297ekw7xyh****
    End: true

La siguiente tabla describe los parámetros clave.

Parámetro

Descripción

Action

Operación de API que se va a invocar, con el formato {ServiceName}:{APIOperation}. Este ejemplo usa ECS:DescribeInstances para consultar detalles de instancias de ECS. Para invocar esta operación, otorgue el permiso AliyunECSReadOnlyAccess al rol de ejecución.

TaskMode

Modo de integración. RequestComplete espera la respuesta de la API antes de avanzar al siguiente estado. Para otros modos, consulte Descripción general de la integración.

Parameters

Parámetros de entrada que se pasan a la API destino. Estos varían según el servicio y la operación de API. En este ejemplo, RegionId, VpcId y VSwitchId filtran las instancias de ECS que se van a consultar. Reemplace estos valores por los suyos.

Paso 4: Ejecutar el flujo de trabajo

  1. Haga clic en Execute en la esquina superior derecha.

  2. En el panel Execute Workflow, establezca el Execution Name y el Input of Execution, y luego haga clic en OK.

Una vez ejecutado el flujo de trabajo, revise los resultados en la página Execution Details.

Servicios compatibles

La integración normal funciona con la mayoría de los servicios de Alibaba Cloud. La siguiente tabla enumera los servicios compatibles por categoría.

Categoría

Servicios

Computación elástica

Function Compute, CloudFlow, Elastic Compute Service, Container Registry, Distributed Cloud Container Platform for Kubernetes, Elastic Container Instance, Serverless App Engine, Web App Service, Elastic Desktop Service, Container Service for Kubernetes, Cloud Phone, Auto Scaling, Elastic Accelerated Computing Instances, Server Migration Center, Resource Orchestration Service, CloudOps Orchestration Service

Middleware

EventBridge, ApsaraMQ for RocketMQ 5.0, SchedulerX, Application High Availability Service, ApsaraMQ for MQTT, Service Mesh, Simple Message Queue (formerly MNS), ApsaraMQ for RabbitMQ

Almacenamiento y CDN

Alibaba Cloud CDN, Object Storage Service, Dynamic Content Delivery Network, Elastic Block Storage, Database File System, Apsara File Storage for HDFS, Apsara File Storage NAS and Cloud Parallel File Storage, Intelligent Media Management, Cloud Backup, Hybrid Disaster Recovery, Edge Node Service

Monitoreo y gestión

ActionTrail, Cloud Governance Center, Key Management Service, Service Catalog, Operations Incident Center, Quota Center

Servicios de aplicaciones

API Gateway, CloudESL, Alibaba Cloud DNS PrivateZone, Security Access Service Edge, Blockchain as a Service, IoV Command Center, Intelligent Dual-Recording System, Smart Conversation Analysis, Voice Navigator, Energy Expert, Scalable Open Financial Architecture

Base de datos

ApsaraDB for MongoDB, RDS Data API, AnalyticDB for PostgreSQL, ApsaraDB for ClickHouse, ApsaraDB for HBase, ApsaraDB for OceanBase, ApsaraDB RDS, Tair (Redis OSS-compatible), ApsaraDB for Cassandra, ApsaraDB for MyBase, AnalyticDB for MySQL, Data Disaster Recovery

Extensión

HTTP, Terraform

Cloud Gaming

Graphic Computing Service

Comunicaciones en la nube

ChatApp Message Service, Cell Phone Number Service, Artificial Intelligence Cloud Call Service, Direct Mail

IA

Automated Machine Learning Platform for NLP, eKYC, Optimization Solver, Image Search, Address Purification, Document Self-learning Platform, Intelligent Visual Production, OpenPlatform for Digitized Virtual Human, Visual Intelligence API - Human Face & Human Body, Visual Intelligence API - Image Matting, Visual Intelligence API - Commodity Understanding, Visual Intelligence API - Image Production, Visual Intelligence API - Image Recognition, Visual Intelligence API - Text Recognition, Visual Intelligence API - Object Detection, Image Search, Alibaba Cloud Model Studio

Dominios y sitios web

Enterprise Services

Búsqueda y análisis de big data

Simple Log Service

Computación analítica

MaxCompute

Big data

Data Lake Analytics, Elasticsearch, Quick BI, Hologres, Data Lake Formation

Servicios de almacenamiento

Photo and Drive Service

Seguridad

Anti-DDoS, Anti-DDoS Resource Plan, Cloud Firewall, Bastionhost, Threat Intelligence, Anti-DDoS Pro, Captcha

Plataforma para desarrolladores

Cloud Architect Design Tools

Soporte técnico

Cloud Control API, Support Plan, Tag Service, CloudSSO, Alibaba Cloud Tickets

Red

Virtual Private Cloud, Cloud Enterprise Network, Anycast Elastic IP Address, Global Accelerator, Application Load Balancer, PrivateLink, Network Load Balancer, Network Intelligence Service

Servicios de video

Apsara Video PaaS, ApsaraVideo Media Processing, Visual Edge Computing Service, Visual Compute Service, ApsaraVideo VOD

Temas relacionados