Cloud Control API の一般的なエラーコードの原因とソリューションについて説明します。
クラウド製品の実行時エラーコード
クラウド製品 API は、ランタイムにこれらのエラーコードを返します。
次の 2 つのエラーコードは、クラウド製品の実行時エラーです。詳細なエラー情報については、Message フィールドを解析してください。Message の構造は次のとおりです。
|
名前 |
タイプ |
説明 |
|
requestId |
String |
エラーを返したクラウド製品 API のリクエスト ID。 |
|
errorCode |
String |
クラウド製品のエラーコード。 |
|
errorMsg |
String |
クラウド製品のエラーメッセージ。 |
OperationFailure.OperationFailed
原因: ダウンストリームのクラウド製品がエラーを返し、操作は完全に失敗しました。
ソリューション: エラーメッセージを解析し、クラウド製品のエラーコードを使用して根本原因を特定します。
{
"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
原因: ダウンストリームのクラウド製品がエラーを返し、操作は部分的に失敗しました。
ソリューション: エラーメッセージを解析し、クラウド製品のエラーコードを使用して根本原因を特定します。
部分的に失敗した場合は、GetResource API を呼び出して最新のリソースステータスを確認します。必要に応じて、UpdateResource API または DeleteResource API を呼び出して問題を修正します。
{
"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 のエラーコード
Cloud Control API サービスがこれらのエラーコードを返します。
InvalidRamUser.NoPermission
原因: RAM ユーザーに、Cloud Control API に対する RAM 認可が付与されていません。
ソリューション: システムポリシーを割り当てるか、特定の API を認可することで、RAM ユーザーに Cloud Control API の権限を付与します。
InvalidRamRole.NoPermission
原因: RAM ロールに、Cloud Control API に対する RAM 認可が付与されていません。
ソリューション: システムポリシーを割り当てるか、特定の API を認可することで、RAM ロールに Cloud Control API の権限を付与します。
InvalidResourceType.NotFound
原因: 入力したリソースタイプが存在しないか、サポートされていません。
ソリューション: リソースタイプのスペルが正しいか、またサポートされているタイプであるかを確認してください。
InvalidOperation.NotSupported
原因: リソースがこの操作をサポートしていません。たとえば、一部のリソースは更新操作や削除操作をサポートしていません。
ソリューション: この操作を実行しないでください。
InvalidParameter.RequiredNotExisted
原因: リソースプロパティに必須パラメーターが含まれていません。
ソリューション: エラーメッセージに基づいて不足しているプロパティを追加し、再度 API を呼び出します。
InvalidParameter.EnumCheckFailure
原因: パラメーターの値が、指定された列挙値の範囲外です。
ソリューション: エラーメッセージに基づいて、プロパティ値を許可された値に調整します。
InvalidOperation.InvalidTaskStatus
原因: タスクのステータスが Pending または Running ではないため、キャンセルできません。
ソリューション: このタスクをキャンセルする必要はありません。
InvalidOperation.TaskNotCompleted
原因: 未完了の非同期タスクがリソース上で実行されています。
ソリューション: 実行中の非同期タスクが終了するまで待機します。タイムアウトした場合は、まずタスクをキャンセルしてから、次のリソース操作を実行します。
InvalidRegion.NotFound
原因: 指定されたリージョンは、クラウド製品でサポートされていません。
ソリューション: サポートされているリージョンを指定して、再度 API を呼び出します。
Throttling、Throttling.Api、および Throttling.User
原因: この期間のトラフィックが制限を超えました。
ソリューション: 現在の制限がビジネス要件を満たしていない場合は、チケットを起票して制限の引き上げをリクエストしてください。
InternalError
原因: Cloud Control API サービスで内部エラーが発生しました。
ソリューション: 操作を再試行します。複数回再試行してもエラーが解決しない場合は、チケットを起票してください。
ServiceUnavailable
原因: Cloud Control API サービスは利用できません。
ソリューション: 操作を再試行します。複数回再試行してもエラーが解決しない場合は、チケットを起票してください。