Na integração normal, o CloudFlow chama operações de API de outros serviços da Alibaba Cloud diretamente pelo OpenAPI. As solicitações e respostas da API trafegam sem modificações, tornando a integração normal compatível com a maioria dos serviços da Alibaba Cloud nas categorias de computação elástica, armazenamento, bancos de dados, contêineres, big data, observabilidade e middleware.
Como funciona
O CloudFlow envia uma solicitação de API ao serviço de destino pelo OpenAPI.
O serviço de destino processa a solicitação e retorna uma resposta.
O CloudFlow captura a resposta e avança para o próximo estado no fluxo de trabalho.
Especifique cada chamada de API com o campo Action no formato {ServiceName}:{APIOperation}. Por exemplo, ECS:DescribeInstances chama a operação DescribeInstances do Elastic Compute Service (ECS).
Modos de integração
O parâmetro TaskMode controla como o CloudFlow lida com a resposta da API. A tabela a seguir descreve os modos disponíveis.
|
Modo |
Comportamento |
Caso de uso |
|
|
Aguarda a resposta da API antes de avançar para o próximo estado. |
Chamadas de API síncronas padrão (mais comum). |
Para conhecer outros modos e suas diferenças, consulte a seção "Integration modes" em Visão geral da integração.
Pré-requisitos
Antes de começar, verifique se você tem:
Uma conta Alibaba Cloud com o CloudFlow ativado
-
Uma função de execução do Resource Access Management (RAM) com permissões para as APIs do serviço de destino. Por exemplo, chamar
ECS:DescribeInstancesexige a permissãoAliyunECSReadOnlyAccessSe já possui uma função RAM, selecione-a ao configurar o fluxo de trabalho
Para criar uma, consulte a seção "Create an execution role" em Criar funções de execução
Criar um fluxo de trabalho de integração normal
Este exemplo chama a operação de API DescribeInstances do ECS para consultar informações de instâncias.
Etapa 1: Criar um fluxo de trabalho
Faça login no console do CloudFlow. Na barra de navegação superior, selecione uma região.
Na página Workflows, clique em Create Workflow.
-
Na caixa de diálogo Create Workflow:
Selecione Use Blank Canvas.
Na seção Workflow mode, selecione um modo de fluxo de trabalho.
Defina o Workflow Name e a Workflow description.
Clique em Create.
Etapa 2: Configurar a função de execução e o tempo limite
Na interface gráfica do Workflow Studio:
Clique na aba CloudFlow Studio e defina o Timeout Period.
Clique na aba Configure Workflow e defina a Execution Role.
Etapa 3: Adicionar uma ação de API
Adicione uma ação de API com o editor visual ou o editor YAML.
Opção A: Editor visual
Na aba Actions do painel de visualização de estados, pesquise
DescribeInstances.Arraste a operação de API
DescribeInstancespara o fluxograma.No painel de configuração à direita, defina os parâmetros de Basic Settings, Input Settings, Output Settings e Troubleshooting.
Para obter detalhes sobre os parâmetros, consulte a seção "Procedure" em Criar um fluxo de trabalho com base em um canvas em branco.
Opção B: Editor YAML
Clique em YAML no canto superior direito e defina a operação de API diretamente. O exemplo a seguir consulta instâncias do ECS em uma VPC e um 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: trueA tabela a seguir descreve os principais parâmetros.
|
Parâmetro |
Descrição |
|
|
Operação de API a ser chamada, no formato |
|
|
Modo de integração. |
|
|
Parâmetros de entrada passados para a API de destino. Variam conforme o serviço e a operação de API. Neste exemplo, |
Etapa 4: Executar o fluxo de trabalho
Clique em Execute no canto superior direito.
No painel Execute Workflow, defina o Execution Name e a Input of Execution e clique em OK.
Após a execução do fluxo de trabalho, visualize os resultados na página Execution Details.
Serviços compatíveis
A integração normal é compatível com a maioria dos serviços da Alibaba Cloud. A tabela a seguir lista os serviços compatíveis por categoria.
|
Categoria |
Serviços |
|
Computação 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 |
|
Armazenamento e 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 |
|
Monitoramento e gerenciamento |
ActionTrail, Cloud Governance Center, Key Management Service, Service Catalog, Operations Incident Center, Quota Center |
|
Serviços de aplicação |
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 |
|
Banco de dados |
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 |
|
Extensão |
HTTP, Terraform |
|
Cloud Gaming |
Graphic Computing Service |
|
Comunicações em nuvem |
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 |
|
Domínios e sites |
Enterprise Services |
|
Pesquisa e análise de big data |
Simple Log Service |
|
Computação analítica |
MaxCompute |
|
Big data |
Data Lake Analytics, Elasticsearch, Quick BI, Hologres, Data Lake Formation |
|
Serviços de armazenamento |
Photo and Drive Service |
|
Segurança |
Anti-DDoS, Anti-DDoS Resource Plan, Cloud Firewall, Bastionhost, Threat Intelligence, Anti-DDoS Pro, Captcha |
|
Plataforma de desenvolvimento |
Cloud Architect Design Tools |
|
Suporte técnico |
Cloud Control API, Support Plan, Tag Service, CloudSSO, Alibaba Cloud Tickets |
|
Rede |
Virtual Private Cloud, Cloud Enterprise Network, Anycast Elastic IP Address, Global Accelerator, Application Load Balancer, PrivateLink, Network Load Balancer, Network Intelligence Service |
|
Serviços de vídeo |
Apsara Video PaaS, ApsaraVideo Media Processing, Visual Edge Computing Service, Visual Compute Service, ApsaraVideo VOD |
Tópicos relacionados
Visão geral da interface -- Referência da interface gráfica do Workflow Studio.
Modo padrão e modo expresso -- Diferenças entre os dois modos de fluxo de trabalho.