FAQ do conector personalizado para o Azure Logic Apps, Power Automate e o Power Apps
Este tópico faz parte de uma série de tutoriais sobre a criação e a utilização de conectores personalizados no Azure Logic Apps, Power Automate e Power Apps.
Nota
Certifique-se de que leu a Descrição geral do conector personalizado para compreender o processo.
P: Quais são os limites para os conectores e os pedidos de API?
R: As tabelas seguintes mostram os limites:
Azure Logic Apps | Limite |
---|---|
Número de conectores personalizados que pode criar | 1000 por subscrição do Azure |
Número de pedidos por minuto para cada ligação criada por um conector personalizado | 500 pedidos por cada ligação criada pelo conector |
Contagem máxima de esquema por corpo permitido num ficheiro Swagger | 512 |
Número máximo de operações permitidas num ficheiro Swagger | 256 |
Número máximo de esquemas por operação permitidos num ficheiro Swagger | 16,384 |
Número máximo de esquemas permitidos num ficheiro Swagger | Número máximo de operações permitidas num ficheiro Swagger * Número máximo de esquemas por operação permitidos num ficheiro Swagger |
Comprimento máximo do conteúdo de pedidos que pode ser enviado para um gateway | 3,182,218 |
Power Automate e Power Apps | Limite |
---|---|
Número de conectores personalizados que pode criar | Plano gratuito: um1 Planos do Office 365 e do Dynamics 365: um Plano por utilizador: 50 |
Número de pedidos por minuto para cada ligação criada por um conector personalizado | 500 pedidos por cada ligação criada pelo conector |
Comprimento máximo do conteúdo de pedidos que pode ser enviado para um gateway | 3,182,218 |
1 O plano gratuito não permite partilhar ligações ou conectores personalizados com outras pessoas na sua empresa. O dimensionamento dinâmico de conectores não é suportado num ambiente pay as you go e, portanto, o número de conectores personalizados que podem ser criados é um.
Se utilizar uma definição de OpenAPI ou coleções do Postman para descrever um conector personalizado, o ficheiro tem de ser inferior a 1 MB.
P: Quais são os limites de tamanho para os conectores e as operações através de um gateway?
R: Os limites estão disponíveis na documentação do gateway.
P: As minhas APIs utilizam um anfitrião dinâmico. Como implementá-las com o OpenAPI?
R: Os modelos de Política podem ser usados para modificar dinamicamente o anfitrião em runtime. Para obter mais informações, aceda a Definir URL do Anfitrião.
P: Não sou proprietário da API e não tenho direitos explícitos para utilizar a API. Posso criar conectores na mesma?
R: Sim, pode registar-se e partilhar estes conectores para uso interno dentro da sua organização ou pode publicá-los como um conector de editor independente. Para certificar e lançar publicamente um conector enquanto editor independente não precisa de deter o serviço subjacente ou de apresentar direitos explícitos para utilizar a API.
P: Quanto tempo demora a certificação?
R: O tempo de certificação depende significativamente da qualidade da submissão e da velocidade dos testes. Excluindo problemas com o processo, normalmente demora três a cinco dias úteis. Após a certificação, a implementação em todas as regiões demorará outros 7 a 10 dias úteis.
P: Onde posso obter ajuda se não conseguir compreender ou executar os passos de submissão?
R: Contacte o seu contacto da Microsoft para obter assistência. Também é recomendado fornecer comentários sobre a nossa documentação para que possamos melhorar.
P: O meu conector pode ser certificado como Standard em vez de "Premium?
R: Não. Infelizmente, de momento apenas lançamos conectores certificados como Premium. Qualquer utilizador com uma licença do Power Automate pode utilizar conectores Standard e Premium.
P: A etiqueta "Pré-visualização" pode ser removida do meu conector?
R: O seu conector tem de cumprir determinados requisitos antes de a etiqueta Pré-visualização poder ser removida. Certifique-se de que o conector tem uma utilização significativa e alta fiabilidade antes de contactar o seu contacto da Microsoft para lhe perguntar.
P: A limitação do meu conector pode ser ajustada?
R: Lidamos com os ajustes de limitação caso a caso. Contacte o seu contacto da Microsoft com justificação se quiser que os limites do seu conector sejam ajustados.
P: O meu conector tem de estar concluído para ser registado para certificação?
R: (O registo não se aplica a editores independentes.) Não, deve registar-se para certificação assim que souber que pretende certificar-se. Assim que se registar, será contactado por um contacto da Microsoft que, se necessário, oferecerá assistência ao longo do desenvolvimento.
P: Posso adicionar mais proprietários de conector à minha submissão para ajudar a gerir o conector no separador Certificação do conector no ISV Studio?
R: (O IVS Studio não se aplica a editoras independentes.) Sim, são permitidos vários proprietários. Fale com o seu contacto da Microsoft para obter assistência para adicionar proprietários.
P: Se o meu segredo do cliente da Aplicação de ID do Microsoft Entra estiver a expirar, como devo notificar a Equipa de Certificação da Microsoft?
R: Este passo não se aplica a editores independentes. Notifique a equipa de Certificação da Microsoft com, pelo menos, 1 (um) mês de antecedência através do ISV Studio. A Microsoft atualizará o seu conector com um novo segredo e o voltará a implementá-lo. Isto impede que o conector seja bloqueado depois de o segredo expirar. A pós-atualização do segredo do cliente demora cerca de um (1) mês para que o conector reflita o novo segredo após a nova implementação.
Para obter mais informações, aceda a Certifique o seu conector.
P: Posso criar um conector sem APIs REST?
R: Para o Power Apps e o Power Automate, tem de suportar APIs REST HTTP estáveis para o seu serviço. Para o Logic Apps, também pode utilizar uma API SOAP.
P: Que ferramentas posso utilizar para expor uma API?
R: O Azure tem capacidades e serviços que pode utilizar para expor qualquer serviço como uma API, como o Serviço de Aplicações do Azure para alojamento, a Gestão de API e muito mais.
P: Que tipos de autenticação são suportados?
R: Pode utilizar estes padrões de autenticação suportados:
- OAuth 2.0 para serviços específicos, incluindo o Microsoft Entra ID, Facebook, Dropbox, GitHub e SalesForce
- OAuth 2.0 genérico
- Autenticação básica
- Chave de API (Exceto gateway de dados no local)
Nota
O tipo de concessão de credenciais de cliente não é suportado.
P: Tenho uma questão técnica sobre o desenvolvimento do conector. Onde devo pedir ajuda?
R: Adicione a sua pergunta no Fórum de Programação de Conectores do Power Automate. A nossa equipa ou um membro da comunidade fornecerá uma resposta. Também pode procurar um problema semelhante. Publicar a sua pergunta irá ajudá-lo a obter respostas de uma comunidade mais vasta e irá melhorar a base de conhecimento do fórum.
P: A Coleção do Postman V2 é suportada?
R: Sim, o suporte para Postman Collection v2 está disponível desde outubro de 2021.
P: Suporta o OpenAPI 3.0?
R: Não, apenas o OpenAPI 2.0 é suportado atualmente. O suporte para OpenAPI 3 está nas tarefas pendentes.
P: Está disponível um plano de programação para os meus esforços de programação do conector?
R: Sim, o Plano da Comunidade do Power Apps está disponível para utilização e é gratuito para o Power Apps e o Power Automate.
P: Posso criar acionadores sem webhooks?
R: Os conectores personalizados para o Azure Logic Apps e o Power Automate suportam acionadores baseados em webhooks e acionadores de consultas. Os acionadores baseados no Webhook esperam que um evento ocorra, enquanto os acionadores de consultas chamam o serviço com uma frequência específica para procurarem novos dados. Se pretender pedir outros padrões de implementação, contacte condevhelp@microsoft.com com mais detalhes sobre a sua API.
Descrição geral dos conectores
Certificar o seu conector
Apreciamos os comentários sobre problemas com a nossa plataforma de conectores ou novas ideias de funcionalidades. Para enviar comentários, aceda a Submeter problemas ou obter ajuda com conectores e selecione o tipo de comentários.