HTTP ステータス コード

管理 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 host: <virtual host name> および url: <path> のプロキシを識別できませんもご覧ください。
405 許可されていないメソッド。サポートされていないメソッドが指定されています。たとえば、POST 動詞を使用しなければならない API 呼び出しに GET 動詞を使用した場合などです。
409 リクエストのタイムアウト。既存のエンティティと競合していることを意味します。たとえば、すでに存在する名前でキャッシュを作成しようとした場合などです。
415 サポートされないメディアタイプ。このエラーは通常、POST または PUT リクエストで Content-type HTTP ヘッダーが間違った値に設定されている場合に発生します。たとえば、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 ゲートウェイ タイムアウトをご覧ください。