HTTP 상태 코드

Apigee Edge 문서를 보고 있습니다.
Apigee X 문서로 이동하세요.
정보

Edge API 응답 오류 메시지에는 HTTP 상태 코드와 오류 메시지가 포함됩니다.

예를 들어 기존 캐시와 동일한 이름으로 캐시 항목을 만들려고 하면 응답은 다음과 같습니다.

HTTP/1.1 409 Conflict
{ "code": "messaging.config.beans.CacheAlreadyExists", "message": "Cache duplicate_cache already exists in environment test", "contexts": [] }

다음 표에는 가장 일반적인 HTTP 상태 코드와 Apigee Edge에서 그 의미가 요약되어 있습니다.

HTTP 상태 코드 설명
2xx 작업이 정상적으로 완료되었습니다. API 호출이 완료되었습니다. HTTP 204는 일반적으로 DELETE 작업이 성공했기 때문에 응답이 콘텐츠 없이 제출되었음을 나타냅니다.
401 승인되지 않았습니다. 요청을 만드는 데 사용하는 사용자 인증 정보에 작업을 수행하는 데 필요한 적절한 권한이 없습니다. 사용 중인 계정의 역할을 확인하세요.
403 금지되었습니다. 사용 중인 사용자 이름과 비밀번호 조합이 지정한 조직에 유효하지 않습니다. 사용자 인증 정보를 테스트하려면 login.apigee.com/login에 로그인하세요. 계정이 필요하면 가입하세요.

조직에 올바른 사용자 인증 정보를 사용하고 있는지 확인하고 맞춤법을 다시 확인합니다.

404 찾을 수 없습니다. 요청 URL의 철자가 올바르고 액세스하려는 API가 있는지 확인하세요. 예를 들어 잘못된 버전의 API에 액세스하려고 하지 않도록 합니다. 404 호스트의 프록시를 식별할 수 없음: <가상 호스트 이름> 및 URL: <경로>도 참조하세요.
405 허용할 수 없는 방식입니다. 지원되지 않는 방법을 지정했습니다. 예를 들어 POST 동사가 필요한 API 호출에 GET 동사를 사용했습니다.
409 분쟁 기존 항목과의 충돌을 나타냅니다. 예를 들어 이미 존재하는 이름을 사용하여 캐시를 만들려고 했을 수 있습니다.
415 지원되지 않는 미디어 유형입니다. 일반적으로 이 오류는 Content-type HTTP 헤더가 잘못된 값으로 설정된 경우 POST 또는 PUT 요청에서 발생합니다. 예를 들어 JSON만 지원하는 API에 다음을 POST하면 HTTP 415 오류가 반환됩니다.
$ curl https://api.company.com/v1/json_service
  -X POST
  -H "Content-type:text/xml"
  -d '<SomeXML>'

GET 요청의 경우 Content-type 헤더 대신 Accept 헤더를 사용합니다.

429 요청이 너무 많습니다. 할당량 또는 Spike Arrest 정책에서 비율 제한을 초과했습니다. 비율 제한을 초과하는 현재 기본 상태 코드는 500이지만 향후 기본값은 429로 변경될 수 있습니다. 500을 429로 변경하는 방법에 관한 자세한 내용은 Spike Arrest 정책할당량 정책을 참고하세요.
500 500 내부 서버 오류를 참조하세요.
502 502 잘못된 게이트웨이를 참조하세요.
503 503 서비스를 사용할 수 없음을 참고하세요.
504 504 게이트웨이 시간 초과를 참조하세요.