HTTP 상태 코드

Apigee Edge 문서입니다.
Go to the Apigee X 문서로 이동합니다. info

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 너무 많은 요청: 할당량 또는 급증 저지 정책의 비율 제한을 초과했습니다. 현재 비율 제한을 초과하는 기본 상태 코드는 500이지만 향후 기본값이 429로 변경될 수 있습니다. 500을 429로 변경하는 방법은 급증 저지 정책 및 할당량 정책을 참조하세요.
500 500 내부 서버 오류를 참조하세요.
502 502 잘못된 게이트웨이를 참조하세요.
503 503 서비스를 사용할 수 없음을 참조하세요.
504 504 게이트웨이 시간 초과를 참조하세요.