Partilhar via

FAQ do conector personalizado para o Azure Logic Apps, Power Automate e o Power Apps

  • Artigo

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.

API e OpenAPI

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.

Certificaçã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.

Requisitos

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:

Nota

O tipo de concessão de credenciais de cliente não é suportado.

Suporte

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.

Acionadores

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

Enviar comentários

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.