반환 태스크를 사용하면 통합 실행 실패 시 반환되는 HTTP 응답 코드에 해당하는 오류 메시지를 맞춤설정할 수 있습니다.
다음 HTTP 응답 코드에 대한 오류 메시지를 수정하거나 맞춤설정할 수 있습니다.HTTP 코드 | 표준 코드 |
---|---|
400 | INVALID_ARGUMENT |
400 | OUT_OF_RANGE |
401 | UNAUTHENTICATED |
403 | PERMISSION_DENIED |
404 | NOT_FOUND |
409 | ALREADY_EXISTS |
429 | RESOURCE_EXHAUSTED |
499 | CANCELLED |
반환 태스크 구성
반환 태스크를 구성하려면 다음 안내를 따르세요.
- Apigee UI에서 Apigee 조직을 선택합니다.
- 개발 > 통합을 클릭합니다.
- 기존 통합을 선택하거나 통합 만들기를 클릭하여 새 통합을 만듭니다.
새 통합을 만드는 경우:
- 통합 만들기 대화상자에 이름과 설명을 입력합니다.
- 지원되는 리전 목록에서 통합에 대한 리전을 선택합니다.
- 만들기를 클릭합니다.
통합 디자이너 페이지에서 통합이 열립니다.
- 통합 설계자 탐색 메뉴에서 +태스크/트리거 추가 > 태스크를 클릭하여 사용 가능한 태스크 목록을 봅니다.
- 반환 태스크 요소를 클릭하고 통합 편집기에 배치합니다.
- 디자이너에서 반환 태스크 요소를 클릭하여 반환 태스크 구성 창을 엽니다.
- 다음 표의 설명대로 태스크의 구성 속성을 사용하여 표시된 필드를 구성합니다.
모든 변경사항은 자동으로 저장됩니다.
구성 속성
다음 표에서는 반환 태스크의 구성 속성을 설명합니다.
속성 | 데이터 유형 | 설명 |
---|---|---|
HTTP code
|
정수 | 오류 메시지를 맞춤설정하려는 4XX HTTP 코드입니다.
|
Customized return message
|
문자열 | 지정된 HTTP 코드의 커스텀 오류 메시지입니다. |
오류 처리 전략
태스크의 오류 처리 전략은 일시적인 오류로 인해 태스크가 실패할 경우 수행할 태스크를 지정합니다. 오류 처리 전략을 사용하는 방법과 다양한 유형의 오류 처리 전략에 대한 자세한 내용은 오류 처리 전략을 참조하세요.