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

Cloud Control API:トラブルシューティング

最終更新日:Feb 23, 2025

Cloud Control API の API 操作を呼び出すときにエラーが発生する場合があります。この場合、エラーコードに基づいてエラーのトラブルシューティングを行うことができます。このトピックでは、一般的なエラーコードの解決策について説明します。

返されるエラーコード

Alibaba Cloud サービスで例外が発生すると、エラーコードが返されます。

例外が発生した場合、次の 2 つのエラーコードが返される可能性があります。トラブルシューティングのためにエラーメッセージを表示できます。次の表は、エラーメッセージ内のパラメーターについて説明しています。

パラメーター

タイプ

説明

requestId

String

リクエストの ID です。

errorCode

String

エラーコードです。

errorMsg

String

エラーメッセージです。

OperationFailure.OperationFailed

原因: ダウンストリームの Alibaba Cloud サービスでエラーが発生し、関連サービスのすべての API 操作が失敗します。

解決策: エラーコードとメッセージに基づいてエラーの原因を特定します。

{
     "requestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
     "Code": "OperationFailure.OperationFailed",
     "Message": "{
          "requestId":"432654B9-BB7F-3AE6-76CF-A5DC0DE9****",
          "errorCode": "MissingName",
          "errorMsg": "Name is mandatory for this action."
     }"
}

OperationFailure.PartialOperationFailed

原因: ダウンストリームの Alibaba Cloud サービスでエラーが発生し、関連サービスの一部の API 操作が失敗します。

解決策: エラーコードとメッセージに基づいてエラーの原因を特定します。

この場合、GetResource 操作を呼び出してリソースの最新のステータスを表示できます。必要に応じて、UpdateResource または DeleteResource 操作を呼び出して、障害を手動で補正できます。

{
     "requestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
     "Code": "OperationFailure.PartialOperationFailed",
     "Message": "{
          "requestId":"432654B9-BB7F-3AE6-76CF-A5DC0DE9****",
          "errorCode": "InvalidRamUser.NoPermission",
          "errorMsg": "Ram user is not authorized to perform the operation."
     }"
}

返されるエラーコード

Cloud Control API で例外が発生すると、エラーコードが返されます。

InvalidRamUser.NoPermission

原因: Cloud Control API の権限が RAM ユーザーに付与されていません。

解決策: システム権限ポリシーをアタッチするか、対応する API に権限を付与することにより、RAM ユーザーが Cloud Control API の API 操作を呼び出すことを承認します。

InvalidRamRole.NoPermission

原因: Cloud Control API の RAM 権限が RAM ロールに付与されていません。

解決策: システム権限ポリシーをアタッチするか、対応する API に権限を付与することにより、RAM ロールが Cloud Control API の API 操作を呼び出すことを承認します。

InvalidResourceType.NotFound

原因: 指定されたリソースタイプが存在しないか、無効です。

解決策: リソースタイプのスペルミスがないか、サポートされているかどうかを確認します。

InvalidOperation.NotSupported

原因: リソースに対する操作は許可されていません。たとえば、一部のリソースは更新または削除できません。

解決策: この操作を実行しないでください。

InvalidParameter.RequiredNotExisted

原因: リソース属性の必須パラメーターが指定されていません。

解決策: 必要なすべてのパラメーターを指定し、API 操作を再度呼び出します。

InvalidParameter.EnumCheckFailure

原因: パラメーターの値が有効な値の中にありません。

解決策: パラメーターを有効な値に設定します。

InvalidOperation.InvalidTaskStatus

原因: タスクのステータスが Pending または Running ではありません。タスクをキャンセルすることはできません。

解決策: タスクをキャンセルしないでください。

InvalidOperation.TaskNotCompleted

原因: リソースに関連する非同期タスクが完了していません。リソースを管理することはできません。

解決策: 非同期タスクが完了するまで待ちます。タスクがタイムアウトした場合は、キャンセルして操作を実行します。

InvalidRegion.NotFound

原因: 指定されたリージョンが無効です。

解決策: リージョン パラメーターを有効な値に設定します。

Throttling、Throttling.API、および Throttling.User

原因: この期間のトラフィックが上限に達しています。

解決策: ビジネス要件が満たされていない場合は、チケットを送信してください。

InternalError

原因: Cloud Control API で内部エラーが発生しました。

解決策: 後でもう一度試してください。エラーコードが繰り返し返される場合は、テクニカルサポートに連絡するか、チケットを送信してください。

ServiceUnavailable

原因: Cloud Control API は使用できません。

解決策: 後でもう一度試してください。エラーコードが繰り返し返される場合は、テクニカルサポートに連絡するか、チケットを送信してください。