현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보
증상
개발자 포털과 Edge 간의 통신 문제로 인해 다음과 같은 문제가 하나 이상 발생할 수 있습니다.
- 다음 작업을 수행할 수 없습니다.
- SmartDocs 만들기 또는 업데이트
- 개발자 앱 등록
- API 제품을 나열합니다.
- 개발자 포털의 SmartDocs 모델 페이지에 액세스할 때 오류가 반환되었습니다 (개발자 포털 관리 메뉴에서 콘텐츠 > SmartDocs 선택).
- 개발자 앱 애널리틱스를 생성할 수 없습니다.
오류 메시지
- 개발자 포털의 'SmartDocs' 탭에 액세스할 때 다음 오류가 반환됩니다.
The website encountered an unexpected error. Please try again later.
- 개발자 포털에 개발자 앱을 등록할 때 반환되는 오류:
There was an error trying to create the App. Please try again later.
가능한 원인
대부분의 경우 문제는 잘못된 devadmin 사용자 인증 정보가 지정되었거나 devadmin 사용자 역할에 할당된 권한이 부족하기 때문에 발생합니다.
구성 > 개발자 포털로 이동하여 연결 상태 필드에 연결 성공이 표시되는지 확인하여 개발자 포털의 에지 연결 구성을 검증합니다. 그러지 않으면 개발 포털을 에지 관리 서버에 올바르게 연결할 수 없습니다.
진단
- 구성 > 개발자 포털로 이동하고 에지 로깅 임곗값에서 디버그를 선택하여 개발 포털에서 '디버그' 로깅을 사용 설정합니다. 기본적으로 Management API 호출은 로깅되지 않습니다.
- 문제를 재현합니다.
- 보고서 -> 최근 로그 메시지로 이동하여 로그에 액세스합니다.
- 'LogPlugin' 유형의 '메시지'를 열어 실제 오류에 대해 자세히 알아봅니다.
401 권한 없는 오류를 보여주는 샘플 출력
해상도
발생한 오류에 따라 아래 표에 나열된 적절한 단계를 따르세요.
|
오류 |
해결 단계 |
|
401 승인되지 않음 |
개발자 포털에서 올바른 devadmin 사용자 인증 정보를 업데이트하고 연결을 다시 테스트합니다. 사용자 계정 추가 및 관리하기를 참고하세요. |
|
403 금지됨 |
리소스에 필요한 권한을 갖도록 Edge 조직의 devadmin userrole을 업데이트합니다. 사용자 역할 및 권한 설정을 참조하세요. |