SDK、BaaS-REST ゲートウェイ、または MYTF がエラーを返した場合、以下の表を参照して原因を特定し、対応を行ってください。各表はスタックの異なるレイヤーに対応しています。
SDK エラーコード — BaaS-REST との通信前または通信中にクライアント SDK で発生するエラー
BaaS-REST エラーコード — MYTF へのリクエスト転送中に BaaS-REST ゲートウェイから返されるエラー
MYTF エラーコード — リクエスト処理中に MYTF から返されるエラー
各表には 4 つのカラムがあります。
| カラム | 内容 |
|---|---|
| エラーコード | コード内で参照する記号定数(例: SDK_NULL_ERROR) |
| エラーコード値 | 実行時に返される数値(16 進数または 10 進数) |
| エラーメッセージ | エラー応答に含まれる文字列 |
| 説明 | 根本原因と推奨される対応策 |
SDK エラーコード
SDK は、ローカル環境で実行中、または BaaS-REST ゲートウェイとの通信中にこれらのエラーを発生させます。
| エラーコード | エラーコード値 | エラーメッセージ | 説明 |
|---|---|---|---|
SUCCESS | 0 | Success | 正常終了しました。 |
SDK_NULL_ERROR | 0x5000 | The return value is null error | 必須パラメーターが空です。エラーメッセージを確認し、該当するフィールドをチェックしてください。 |
SDK_CONFIG_ERROR | 0x5001 | Failed to reading configuration file | 構成ファイルが存在しないか、無効な値が含まれています。ファイルパスおよび構文を確認してください。 |
SDK_READ_FILE_ERROR | 0x5002 | Failed to get file input stream | ローカルファイルを開けませんでした。ファイルパスが正しいことと、ファイルが存在することを確認してください。 |
SDK_ENCODING_FAILED | 0x5003 | Encoding error | エンコーディングに失敗しました。管理者に連絡してください。 |
SDK_DECODING_FAILED | 0x5004 | Decoding error | デコーディングに失敗しました。管理者に連絡してください。 |
SDK_PARSE_ERROR | 0x5005 | Failed to parsing data | データの解析に失敗しました。データ形式が期待されるスキーマと一致しているか確認してください。 |
SDK_AUTH_DATA_ERROR | 0x5010 | authorize data is invalid | 権限付与データが正しくありません。認証情報および権限付与ペイロードを確認してください。 |
SDK_INVALID_KEYPAIR | 0x5100 | The keypair is invalid | キーペアのフォーマットが無効です。キーペアが正しいアルゴリズムおよびフォーマットで生成されたことを確認してください。 |
SDK_GENERATE_KEY_ERROR | 0x5101 | Key generation error | ローカルでのキージェネレーションに失敗しました。ローカル SDK の構成を確認してください。 |
SDK_BUILD_ENVELOPE_ERROR | 0x5102 | Envelope seal error | エンベロープ暗号化に失敗しました。キーペアが正しく生成されたことを確認してください。 |
SDK_DECRYPT_ENVELOPE_ERROR | 0x5103 | Envelope open error | エンベロープ復号に失敗しました。キーペアが正しく生成されたことを確認してください。 |
SDK_ENCRYPT_ERROR | 0x5104 | Encryption error | 暗号化に失敗しました。キーペアが正しく生成されたことを確認してください。 |
SDK_DECRYPT_ERROR | 0x5105 | Decryption error | 復号に失敗しました。キーペアが正しく生成されたことを確認してください。 |
SDK_SIGN_MESSAGE_FAILED | 0x5106 | Failed to sign a message | メッセージ署名に失敗しました。キーペアが正しく生成されたことを確認してください。 |
SDK_VERIFY_SIGNATURE_FAILED | 0x5107 | The signature is invalid | 署名検証に失敗しました。getMYTFInfo および getTAPPInfo を再度呼び出して最新の MYTFInfo および TAPPInfo を取得し、ローカルの MYTF および TAPP 署名用公開鍵を更新してください。 |
SDK_VERIFY_TRUSTROOT_FAILED | 0x5108 | Failed to verify trust root | 信頼ルート検証に失敗しました。信頼ルート情報が正しいか確認してください。 |
SDK_VERIFY_HASH_FAILED | 0x5109 | The hash is not equal to the expected hash | ハッシュ検証に失敗しました。管理者に連絡してください。 |
SDK_INVALID_CURVE | 0x510A | curve type not supported | 指定された楕円曲線は、このアルゴリズムではサポートされていません。 |
SDK_INVALID_REQ_PARAMETER | 0x5200 | Request parameters are invalid | リクエストパラメーターが無効です。各パラメーター値を API リファレンスと照合してください。 |
SDK_UNSUPPORT_ENGINE_TYPE_FAILED | 0x5201 | Unsupported execution engine type | 実行エンジンのタイプがサポートされていません。エンジンタイプが WASM に設定されているか確認してください。 |
SDK_BAAS_REST_HANDSHAKING_FAILED | 0x5202 | Failed to Handshake with BaaS's REST API | BaaS-REST ゲートウェイとのハンドシェイクに失敗しました。BaaS-REST エンドポイントおよび構成を確認してください。 |
SDK_BAAS_REST_MYTFCALL_FAILED | 0x5203 | Failed to Call MYTF through BaaS's REST API | BaaS-REST を介した MYTF 呼び出しに失敗しました。管理者に連絡してください。 |
BaaS-REST エラーコード
BaaS-REST ゲートウェイは、ご利用のリクエストを MYTF に転送中にこれらのエラーを返します。
| エラーコード | エラーコード値 | エラーメッセージ | 説明 |
|---|---|---|---|
BAAS_REST_SUCCESS | 200 | Success | 正常終了しました。 |
BAAS_REST_INVALID_ACCESS_TOKEN | 202 | Access token is null or expired | アクセストークンが正しくないか、期限切れです。クライアントを再起動して新しいアクセストークンを取得してください。 |
BAAS_REST_INVALID_REQUEST | 400 | Access Deny | ユーザーが MYTF リソースへのアクセス権限を持っていません。ドメインおよびリージョンの構成を確認してください。 |
BAAS_REST_DOMAIN_REGION_ERROR | 404 | Cannot find MYTF for this domain or region | C3S のドメインまたはリージョンが見つかりません。構成内のドメインおよびリージョンの値が正しいか確認してください。 |
BAAS_REST_THROW_EXCEPTION_ERROR | 500 | Unknown Error | 不明なエラーが発生しました。サービスがタイムアウトまたはアップデート中のため、一時的に利用できない可能性があります。リクエストを再試行してください。 |
MYTF エラーコード
MYTF は、ご利用のリクエストを処理中にこれらのエラーを返します。
| エラーコード | エラーコード値 | エラーメッセージ | 説明 |
|---|---|---|---|
MYTF_SUCCESS | 0x0000 | success | 正常終了しました。 |
TAPP_REQ_EXCEED_LIMIT | 0x2002 | tapp request exceed limit | リクエストボディが TAPP のサイズ制限を超えています。ペイロードサイズを縮小して再試行してください。 |
TAPP_REQ_HEADER_NOT_MATCH | 0x2003 | tapp request header and body not match | TAPP のリクエストヘッダーとボディが不一致です。管理者に連絡してください。 |
TAPP_RES_EXCEED_LIMIT | 0x2004 | tapp response exceed limit | TAPP の応答がサイズ制限を超えています。コントラクトのロジック内で応答ペイロードを縮小してください。 |
TAPP_INVALID_ENC_PK_ERROR | 0x2006 | invalid user pk | 暗号化用公開鍵が無効です。公開鍵のフォーマットを確認してください。 |
TAPP_NON_EXIST_ERROR | 0x2007 | tapp does not exist | TAPP が見つかりません。TAPP のインストールが正常に完了し、TAPP ID が正しいか確認してください。 |
TAPP_EXISTED_ERROR | 0x2008 | tapp already existed | この ID の TAPP は既に存在しており、再インストールできません。別の TAPP ID を使用してください。 |
TAPP_INVALID_ID | 0x2009 | invalid id format | TAPP ID が無効です。ID の長さおよび文字セットを確認してください。 |
TAPP_INVALID_VERSION | 0x200A | invalid tapp version | TAPP のバージョンが低すぎます。サポートされているバージョンにアップグレードしてください。 |
TAPP_INVALID_BYTECODE | 0x200B | invalid tapp bytecode | TAPP コントラクトのバイトコードが無効です。コンパイラのバージョンを確認し、バイトコードサイズが制限内であるか検証してください。 |
TAPP_INVALID_PROPERTY | 0x200C | invalid tapp properties | TAPP 拡張プロパティが無効です。拡張プロパティのサイズが制限を超えていないか確認してください。 |
TAPP_INVALID_DESCRIPTION | 0x200D | invalid tapp description | TAPP の説明が無効です。説明のサイズが制限を超えていないか確認してください。 |
TAPP_INVALID_ENGINE | 0x200E | invalid tapp exec engine | TAPP 実行エンジンがサポートされていません。指定されたエンジンタイプを確認してください。 |
TAPP_INVALID_METHOD | 0x200F | invalid tapp method | 実行メソッドが無効です。コントラクトにこのメソッドが含まれているか確認してください。 |
TAPP_INVALID_ARGS | 0x2010 | invalid tapp args | TAPP の実行時パラメーターが無効です。入力パラメーターがコントラクトで期待される型および値と一致しているか確認してください。 |
TAPP_EXCEED_LIMIT | 0x2011 | tapp number exceed max limit | サーバー側の TAPP 数が上限に達しています。上限を引き上げるために管理者に連絡してください。 |
TAPP_VM_CREATE_FAILED | 0x2100 | create exe engine failed | 実行エンジンの初期化に失敗しました。管理者に連絡してください。 |
TAPP_WASM_INIT_FAILED | 0x2101 | init wasm failed | WebAssembly (Wasm) 仮想マシンの初期化に失敗しました。コンパイラのバージョンを確認してください。 |
TAPP_WASM_EXEC_FAILED | 0x2102 | no wasm function | TAPP の実行に失敗しました。管理者に連絡してください。 |
TAPP_WASM_EXEC_INTERRUPTED | 0x2103 | execute wasm interrupted | TAPP の実行が例外によって中断されました。管理者に連絡してください。 |
EXT_INVALID_TYPE_ERROR | 0x2200 | invalid ext service type | 外部サービスのタイプが認識されません。サポートされているサービスタイプを指定しているか確認してください。 |
EXT_NON_EXIST_ERROR | 0x2201 | ext service does not exist | 外部サービスが見つかりません。サービスが登録済みであることと、識別子が正しいか確認してください。 |
EXT_CONNECTION_ERROR | 0x2202 | not able to connect to ext service | 外部サービスへの接続に失敗しました。サービスが到達可能であることと、接続構成が正しいか確認してください。 |
OS_UNKNOWN_ERROR | 0x4000 | Oracle service unknown error | Oracle サービスで不明なエラーが発生しました。管理者に連絡してください。 |
OS_DOMAIN_REGION_DOES_NOT_EXIST | 0x4001 | Domain or region does not exist | 構成内のドメイン名またはリージョン名が存在しません。ドメインおよびリージョンの値を確認してください。 |
OS_GRPC_REQ_TIMEOUT | 0x4002 | grpc request timeout | gRPC リクエストがタイムアウトしました。計算に時間がかかりすぎたためです。リクエストを簡略化するか、問題が継続する場合は管理者に連絡してください。 |
OS_IDENTITY_DATA_ERROR | 0x4003 | invalid authorize data | 権限付与に失敗しました。権限付与データおよび認証情報を確認してください。 |
OS_PERMISSION_DENY | 0x4004 | user does not have access privileges | アクセス権限が拒否されました。ユーザー アカウントがこの操作に必要なアクセス権限を持っているか確認してください。 |
OS_TAPP_MAX_LIMIT | 0x4005 | user installed tapp exceeds max limit | このユーザーがインストールした TAPP 数が上限に達しています。上限を引き上げるために管理者に連絡してください。 |
OS_TAPP_DELETED_ERROR | 0x4006 | same tapp already deleted | この TAPP は既に削除されています。 |