참고
이 문서는 Azure Logic Apps, Microsoft Power Automate 및 Microsoft Power Apps에서 사용자 지정 커넥터를 만들고 사용하고 Microsoft Copilot Studio에서 커넥터를 도구로 호출하는 방법에 대한 자습서 시리즈의 일부입니다. 프로세스를 이해하려면 사용자 지정 커넥터 개요를 읽으십시오.
API 및 OpenAPI
Q: 커넥터 및 API 요청에 대한 제한은 어떻게 됩니까?
A: 다음 표는 제한을 보여줍니다.
| Azure 논리 앱 | 제한 |
|---|---|
| 작성할 수 있는 사용자 지정 커넥터 수 | Azure 구독당 1,000개 |
| 사용자 지정 커넥터로 작성된 각 연결에 대한 분당 요청 수 | 커넥터가 작성한 각 연결에 대해 500개의 요청 |
| Swagger 파일에서 허용되는 본문당 최대 스키마 수 | 512 |
| Swagger 파일에서 허용되는 작업의 최대 수 | 256 |
| Swagger 파일에서 허용되는 작업당 최대 스키마 수 | 16,384 |
| Swagger 파일에서 허용되는 최대 스키마 수 | Swagger 파일에서 허용되는 최대 작업 수 * Swagger 파일에서 허용되는 작업당 최대 스키마 수 |
| 게이트웨이로 보낼 수 있는 최대 요청 콘텐츠 길이 | 3,182,218 |
| Power Automate 및 Power Apps | 제한 |
|---|---|
| 작성할 수 있는 사용자 지정 커넥터 수 | 무료 요금제: 한 개의 1 Office 365 및 Dynamics 365 플랜: 하나의 사용자 기준 요금제: 50 |
| 사용자 지정 커넥터로 작성된 각 연결에 대한 분당 요청 수 | 커넥터가 작성한 각 연결에 대해 10000개의 요청 |
| 게이트웨이로 보낼 수 있는 최대 요청 콘텐츠 길이 | 3,182,218 |
1 무료 계획을 사용하면 회사의 다른 사람들과 연결 또는 사용자 지정 커넥터를 공유할 수 없습니다. 종량제 환경에서는 커넥터의 동적 크기 조정이 지원되지 않으므로 생성할 수 있는 사용자 지정 커넥터 수는 1개입니다.
OpenAPI정의 또는 Postman 컬렉션을 사용하여 사용자 지정 커넥터를 설명하는 경우 파일은 1MB 미만이어야 합니다.
Q: 게이트웨이를 통한 커넥터 및 작업의 크기 제한은 어떻게 됩니까?
A: 제한은 게이트웨이 설명서에서 확인할 수 있습니다.
Q: 내 API는 동적 호스트를 사용합니다. OpenAPI에서 구현하려면 어떻게 할까요?
A: 정책 템플릿을 사용하여 런타임에 호스트를 동적으로 수정할 수 있습니다. 자세히 알아보려면 호스트 URL 설정을 참조하세요.
자격증
Q: 나는 API를 소유하지 않으며 API를 사용할 수 있는 명시적인 권한이 없습니다. 여전히 커넥터를 만들 수 있습니까?
A: 네, 조직 내에서 내부 사용을 위해 이러한 커넥터를 등록 및 공유하거나 독립 판매자 커넥터로 게시할 수 있습니다. 커넥터를 독립 판매자로 인증하고 공개적으로 릴리스하기 위해 기본 서비스를 소유하거나 API를 사용할 명시적 권한을 제시할 필요가 없습니다.
Q: 인증은 얼마나 걸립니까?
A: 인증 시간은 제출 품질과 테스트 속도에 따라 크게 달라집니다. 프로세스에 문제가 있는 경우를 제외하고 일반적으로 영업일 기준 3~5일이 소요됩니다. 인증 후 모든 지역에 배포하는 데 영업일 기준 7~10일이 추가로 소요됩니다.
Q: 제출 단계를 이해하거나 실행하는 데 문제가 있는 경우 어디서 도움을 받을 수 있나요?
A: 도움이 필요하면 Microsoft 담당자에게 문의하세요. 또한 설명서를 개선할 수 있도록 이에 대한 피드백을 제공하는 것이 좋습니다.
Q: 내 커넥터를 프리미엄 대신 표준 커넥터로 인증할 수 있나요?
A: 아니요. 현재는 인증된 커넥터만 프리미엄으로 릴리스하고 있습니다. Power Automate 라이선스가 있는 모든 사용자는 표준 및 프리미엄 커넥터를 모두 사용할 수 있습니다.
Q: 커넥터에서 미리 보기 태그를 제거할 수 있습니까?
A: 커넥터가 특정 요구 사항을 충족해야 미리 보기 태그를 제거할 수 있습니다. Microsoft 담당자에게 문의하기 전에 커넥터의 사용량이 많고 안정성이 높은지 확인하십시오.
Q: 커넥터에 대한 제한 한도를 조정할 수 있습니까?
A: 제한 한도 조정은 사례별로 처리합니다. 커넥터의 한도를 조정하려는 경우 Microsoft 담당자에게 정당화를 통해 연락하십시오.
요구 사항
Q: REST API 없이 커넥터를 구축할 수 있습니까?
A: Power Apps와 Power Automate의 경우, 서비스에 대해 안정적인 HTTP REST API를 지원해야 합니다. Logic Apps의 경우 SOAP API를 사용하는 옵션도 있습니다.
Q: API를 노출하는 데 사용할 수 있는 도구는 무엇인가요?
A: Azure에는 호스팅용 Azure App Service, API Management 등 모든 서비스를 API로 노출하는 데 사용할 수 있는 기능 및 서비스가 있습니다.
Q: 어떤 인증 유형이 지원됩니까?
A: 다음과 같은 지원되는 인증 표준을 사용할 수 있습니다.
- Microsoft Entra ID, Facebook, Dropbox, GitHub 및 SalesForce를 포함한 특정 서비스에 대한 OAuth 2.0
- 일반 OAuth 2.0
- 인증 유형
- API 키(온-프레미스 데이터 게이트웨이 제외)
Q: 백엔드 서비스의 커넥터에서 사용할 수 있는 헤더는 무엇인가요?
A: Microsoft에서 다음 4개의 헤더를 사용할 수 있습니다.
- x-ms-workflow-name
- x-ms-environment-id
- x-ms-workflow-version
- x-ms-workflow-run-id
이러한 헤더는 변경될 수 있습니다. 커넥터를 만들기 전에 업데이트를 확인하는 것이 좋습니다.
참고
클라이언트 자격 증명 권한 부여 유형은 지원되지 않습니다.
지원
Q: 커넥터 개발에 대한 기술적인 질문이 있습니다. 어디에 도움을 요청해야 하나요?
A:Power Automate 포럼 커넥터 개발 포럼에 질문을 추가하세요. 팀 또는 커뮤니티 회원이 답변을 드릴 것입니다. 유사한 문제를 검색할 수도 있습니다. 질문을 게시하면 더 넓은 커뮤니티에서 답변을 얻고 포럼의 지식 기반을 개선하는 데 도움이 됩니다.
Q: Postman Collection V2를 지원합니까?
A: 예, Postman Collection v2에 대한 지원은 2021년 10월부터 사용할 수 있습니다.
Q: OpenAPI 3.0을 지원하나요?
A: 아니요, 현재 OpenAPI 2.0만 지원됩니다. OpenAPI 3에 대한 지원은 백로그에 있습니다.
Q: 커넥터 개발 작업에 개발자 플랜을 사용할 수 있습니까?
A: 예, Power Apps 커뮤니티 플랜은 사용 가능하며 Power Apps 및 Power Automate에서는 무료로 제공됩니다.
트리거
Q: 웹후크 없이 트리거를 빌드할 수 있나요?
A: Azure Logic Apps 및 Power Automate용 사용자 지정 커넥터는 웹후크 기반 및 폴링 트리거를 지원합니다. 웹 후크 기반 트리거는 이벤트가 발생할 때까지 대기하는 반면, 폴링 트리거는 지정된 빈도로 서비스를 호출하여 새 데이터를 확인합니다. 구현에 대한 다른 패턴을 요청하려는 경우 API에 대한 자세한 정보를 사용하여 condevhelp@microsoft.com에 문의하세요.
관련 정보
피드백 제공
커넥터 플랫폼 문제 또는 새로운 기능 아이디어에 대한 피드백에 감사 드립니다. 피드백을 제공하려면 문제 제출 또는 커넥터 관련 도움말 보기로 이동하여 피드백 유형을 선택하십시오.