Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Observação
Este artigo faz parte de uma série de tutoriais sobre como criar e usar conectores personalizados nos Aplicativos Lógicos do Azure, microsoft Power Automate e Microsoft Power Apps e chamar conectores como ferramentas no Microsoft Copilot Studio. Certifique-se de ler a visão geral do conector personalizado para entender o processo.
API e OpenAPI
P: Quais são os limites para conectores e solicitações de API?
A: As tabelas a seguir mostram os limites:
| Aplicativo Lógico do Azure | Limite |
|---|---|
| Número de conectores personalizados que você pode criar | 1.000 por assinatura do Azure |
| Número de solicitações por minuto para cada conexão criada por um conector personalizado | 500 solicitações para cada conexão criada pelo conector |
| Contagem máxima de esquema por corpo permitida em um arquivo do Swagger | 512 |
| Número máximo de operações permitidas em um arquivo do Swagger | 256 |
| Número máximo de esquemas por operação permitidos em um arquivo do Swagger | 16,384 |
| Número máximo de esquemas permitidos em um arquivo do Swagger | Número máximo de operações permitidas em um arquivo Swagger * Número máximo de esquemas por operação permitido em um arquivo do Swagger |
| Comprimento máximo do conteúdo da solicitação que pode ser enviada a um gateway | 3,182,218 |
| Power Automate e Power Apps | Limite |
|---|---|
| Número de conectores personalizados que você pode criar | Plano gratuito: um1 Office 365 e planos do Dynamics 365: um Plano por usuário: 50 |
| Número de solicitações por minuto para cada conexão criada por um conector personalizado | 10000 solicitações para cada conexão criada pelo conector |
| Comprimento máximo do conteúdo da solicitação que pode ser enviada a um gateway | 3,182,218 |
1 O plano gratuito não permite que você compartilhe conexões ou conectores personalizados com outras pessoas da sua empresa. Não há suporte ao dimensionamento dinâmico de conectores em um ambiente de pagamento conforme o uso e, portanto, o número de conectores personalizados que podem ser criados é um.
Se você usar uma definição OpenAPI ou coleção Postman para descrever um conector personalizado, o arquivo deve ter menos de 1 MB.
P: Quais são os limites de tamanho para conectores e operações por meio de um gateway?
A: Os limites podem ser encontrados na documentação do gateway.
P: Minhas APIs usam um host dinâmico. Como implementá-los com o OpenAPI?
A: Os modelos de política podem ser usados para modificar dinamicamente o host no runtime. Para saber mais, acesse a Definir URL do Host.
Certificação
P: Eu não possuo a API e não tenho direitos explícitos para usar a API. Ainda posso criar conectores?
R: Sim, você pode registrar e compartilhar esses conectores para uso interno em sua organização ou pode publicá-los como um conector de editor independente. Para certificar e liberar publicamente um conector como um editor independente, você não precisar ter o serviço subjacente ou apresentar direitos explícitos para usar a API.
P: Quanto tempo demora a certificação?
R: O tempo de certificação depende significativamente da qualidade do envio e da velocidade de seus testes. Impedindo problemas no processo, isso normalmente leva de três a cinco dias úteis. Após a certificação, a implantação em todas as regiões levará mais 7 a 10 dias úteis.
P: Onde posso obter ajuda se eu estiver tendo problemas para entender ou executar as etapas de envio?
R: Entre em contato com seu contato da Microsoft para obter ajuda. Você também é incentivado a fornecer comentários sobre nossa documentação para que possamos melhorá-la.
P: Meu conector pode ser certificado como um conector Standard em vez de Premium?
R: Não. Infelizmente, no momento, só liberamos conectores certificados como Premium. Qualquer usuário com uma licença do Power Automate pode usar conectores Padrão e Premium.
P: A marca Visualizar pode ser removida do meu conector?
A: Seu conector precisa atender a determinados requisitos para que a marca Visualizar possa ser removida. Verifique se o conector apresenta uso significativo e alta confiabilidade antes de entrar em contato com a Microsoft para perguntar isso.
P: As limitações do meu conector podem ser ajustadas?
A: Nós lidamos com ajustes de limitação caso a caso. Converse com o contato da Microsoft com justificativa caso você queira ajustar os limites do conector.
Requisitos
P: Posso criar um conector sem APIs REST?
R: Para o Power Apps e o Power Automate, você deve oferecer suporte a APIs REST de HTTP estáveis para seu serviço. Para Aplicativos Lógicos, você também tem a opção de usar uma API SOAP.
P: Quais ferramentas posso usar para expor uma API?
R: O Azure tem recursos e serviços que você pode usar para expor qualquer serviço como uma API, como o Serviço de Aplicativo do Azure para hospedagem, Gerenciamento de API e muito mais.
P: Quais tipos de autenticação têm suporte?
R: Você pode usar estes padrões de autenticação com suporte:
- O OAuth 2.0 para serviços específicos, incluindo Microsoft Entra ID, Facebook, Dropbox, GitHub e SalesForce
- Genérico OAuth 2.0
- Autenticação básica
- Chave de API (Exceto no gateway de dados local)
P: Quais cabeçalhos podem ser usados pelos conectores em seus serviços de back-end?
R: Você pode usar os quatro cabeçalhos a seguir da Microsoft:
- x-ms-workflow-name
- x-ms-environment-id
- x-ms-workflow-version
- x-ms-workflow-run-id
Estes cabeçalhos estão sujeitos a alterações. Recomendamos que você verifique se há atualizações antes de criar seus conectores.
Observação
O tipo de concessão de credenciais do cliente não tem suporte.
Suporte
P: Tenho uma pergunta técnica sobre o desenvolvimento de conectores. Onde devo pedir ajuda?
R: Adicione sua pergunta no Fórum de Desenvolvimento de Conectores do Power Automate. Nossa equipe ou um membro da comunidade fornece uma resposta. Você também pode pesquisar um problema semelhante. Postar sua pergunta ajuda você a obter respostas de uma comunidade mais ampla e melhora a base de conhecimento do fórum.
P: Vocês oferecem suporte ao Postman Collection V2?
R: Sim, o suporte para Postman Collection v2 está disponível desde outubro de 2021.
P: Há suporte para OpenAPI 3.0?
R: Não, somente o OpenAPI 2.0 tem suporte no momento. O suporte para OpenAPI 3 está na lista de pendências.
P: Um plano de desenvolvedor está disponível para uso em meus esforços de desenvolvimento de conectores?
R: Sim, o Plano da Comunidade do Power Apps está disponível para uso e é gratuito para o Power Apps e o Power Automate.
Gatilhos
P: Posso criar gatilhos sem webhooks?
A: Os conectores personalizados para Aplicativos Lógicos do Azure e do Power Automate dão suporte a gatilhos com base em webhook e de sondagem. Os gatilhos baseados em webhook aguardam a ocorrência de um evento, enquanto os gatilhos de pesquisa chamam seu serviço em uma frequência especificada para verificar novos dados. Se você deseja solicitar outros padrões para implementação, entre em contato com condevhelp@microsoft.com com mais detalhes sobre a sua API.
Informações relacionadas
Visão geral dos conectores
Obter seu conector certificado
Faça comentários
Agradecemos muito os comentários sobre problemas com nossa plataforma de conectores ou novas ideias de recursos. Para fornecer comentários, acesseEnviar problemas ou obter ajuda com conectores e selecione o tipo de comentário.