すべてのプロダクト
Search
ドキュメントセンター

OpenAPI Explorer:OpenAPI エラー診断

最終更新日:Sep 11, 2026

OpenAPI の呼び出し時にエラーが発生した場合は、エラーメッセージを OpenAPI トラブルシューティングページにコピーすることで、自動的に解決策を取得できます。

エラーメッセージの取得

API オンラインデバッグページ

image

SDK 呼び出し

image

CLI 呼び出し

image

Terraform 呼び出し

image

Alibaba Cloud Developer Toolkit

image

OpenAPI の問題の診断

重要

Alibaba Cloud アカウント間、または同一アカウント配下の異なる RAM ユーザー間でエラーメッセージを照会するには、まず権限付与を完了してから、再度お試しください。

エラーメッセージを取得した後、JSON コンテンツ全体、または RequestId、Code、または Message フィールドのみを []ページにコピーすることで、自動的に解決策を取得できます。

例えば、Elastic Compute Service (ECS) の RunInstances API を呼び出してエラーが発生した場合、エラーメッセージは次のようになります。

{
  "RequestId": "6BE56E05-XXXX-XXXX-XXXX-FD90C4FFD581",
  "HostId": "ecs.ap-southeast-3.aliyuncs.com",
  "Code": "InvalidImageId.NotFound",
  "Message": "The specified ImageId does not exist.",
  "Recommend": "https://api.alibabacloud.com/troubleshoot?intl_lang=EN_US&q=InvalidImageId.NotFound&product=Ecs&requestId=6BE56E05-XXXX-XXXX-XXXX-FD90C4FFD581"
}

各パラメーターの意味は次のとおりです。

  • RequestId:リクエストの一意の識別子です。この値を [[[]]]ページにコピーすることで、自動的に解決策を取得できます。

  • HostId:API リクエストのサービスエンドポイントです。

  • Code:エラーコードです。

  • Message:詳細なエラー情報です。これを使用してリクエストパラメーターを確認します。この例では、ImageId に無効なイメージ ID が指定されたためエラーが発生しています。有効なイメージ ID を使用して問題を修正してください。

  • Recommend:エラー診断ページへの直接リンクです。このフィールドをコピーすることで、解決策に直接アクセスできます。

image

SDK を使用する場合など、実際のシナリオでは、完全な JSON エラーレスポンスを受け取れない場合があります。その場合は、RequestId、Code、または Message のみを []ページにコピーして解決策を取得してください。RequestId を使用すると、最も正確な結果が得られます。

RequestId を使用して取得した解決策は、次のように表示されます。

image

診断解決策の確認

上記のように、ページの下部には [診断解決策] と [ログ情報] の 2 つのタブが表示されます。[診断解決策] タブには、一致した解決策が表示されます。例えば、エラーメッセージが The specified ImageId does not exist. の場合、提供される解決策は次のとおりです。

The specified image does not exist under this account. Check whether the image ID is correct.

解決策の指示に従って、ImageId パラメーターの値が正しいことを確認してください。

リクエストパラメーターの確認

実際のシナリオでは、エラー発生時に元のリクエスト本文を保存していない場合があります。その場合でも、[OpenAPI トラブルシューティング]を使用して、リクエストパラメーター、レスポンス、その他の詳細を取得できます。

[RequestId] が 6BE56E05-XXXX-XXXX-XXXX-FD90C4FFD581 であるエラーを例に説明します。「ログ情報」タブをクリックします。以下に示すように、コールチェーンの視覚的分析、完全なエラーメッセージ、および元のリクエスト内容を表示できます。これらのログを使用して、問題をより正確に特定して解決できます。

image