翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # 無効なエフェメリスのトラブルシューティング エフェメリスデータを にアップロードすると AWS Ground Station、非同期検証ワークフローが実行されます。検証が失敗すると、エフェメリスステータスは に変わります`INVALID`。[DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html) レスポンスのエラーメッセージには、問題の特定と解決に役立つ詳細情報が表示されます。 ## エフェメリス検証エラーについて エフェメリスが検証に失敗すると、[DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html) API レスポンスには、問題の診断に役立つ 2 つのフィールドが含まれます。 errorCode 特定の検証エラーを識別する機械読み取り可能なコード。これは、プログラムによるエラー処理に使用できます。 errorMessage 問題の詳細と修正方法に関するガイダンスを含む、人間が読める検証エラーの説明。 無効なエフェメリスに対する [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html) レスポンスの例: ``` { "ephemerisId": "abc12345-6789-def0-1234-567890abcdef", "name": "My Invalid Ephemeris", "status": "INVALID", "creationTime": 1620254718.765, "invalidReason": "METADATA_INVALID", "errorCode": "OBJECT_NAME_MISSING", "errorMessage": "Metadata field missing: OBJECT_NAME", "suppliedData": { "tle": { "ephemerisData": "[...]" } } } ``` ## TLE エフェメリスの一般的な検証エラー TLE エフェメリスのアップロード時に発生する一般的な検証エラーを次に示します。 一致しない衛星のカタログ番号 *エラー:* 「エフェメリスに存在する衛星カタログ番号が、関連付けられた衛星の衛星カタログ番号と一致しません」 *解決策:* TLE 行の NORAD ID/衛星カタログ番号が衛星の衛星カタログ番号と一致していることを確認します。カタログ番号が割り当てられていない衛星`00000`に を使用します。 無効な平均モーション *エラー:*「提供されたエフェメリスの平均モーションが最新のリファレンスエフェメリスと大きく異なる」 *解決策:* TLE データが正しく、有効な軌道を表していることを確認します。Ground Station は、検証中に Space-Track エフェメリスをリファレンスとして使用します。 ## OEM エフェメリスの一般的な検証エラー OEM エフェメリスのアップロード時に発生する一般的な検証エラーを次に示します。 無効な参照フレーム *エラー:*「REF\$1FRAME はサポートされていません」 *解決策:* サポートされているリファレンスフレームの 1 つを使用するように OEM ファイルを更新します: EME2000 または ITRF2000。 必須フィールドがありません *エラー:*「メタデータフィールドがありません: INTERPOLATION」 *解決策:* INTERPOLATION フィールドと INTERPOLATION\$1DEGREE フィールドを OEM メタデータセクションに追加します。これらは、 が正確なアンテナポイント角度を生成する AWS Ground Station ために必要です。 サポートされていない時間システム *エラー:*「TIME\$1SYSTEM はサポートされていません」 *解決策:* OEM ファイルがタイムシステムとして UTC を使用していることを確認します。 サポートされていない OEM バージョン *エラー:*「CCSDS\$1OEM\$1VERS はサポートされていません」 *解決策:* OEM ファイルが CCSDS OEM バージョン 2.0 を使用していることを確認します。 ## 方位高度エフェメリスの一般的な検証エラー 以下は、方位高度エフェメリスをアップロードするときに発生する一般的な検証エラーです。 方位/上昇データの欠落 *エラー:*「少なくとも 1 つの AzElSegment に TimeAzEl フィールドが存在しませんでした AzElSegment 」 *解決策:* 方位標高データ内の各セグメントに、少なくとも 1 つの時間タグ付けされた方位/標高ペアが含まれていることを確認します。 無効な方位角度範囲 (度) *エラー:*AzEl az は -180 以上、360 度以下である必要があります」 *解決策:* 方位角が [-180, 360] 度以内であることを確認します。 無効な上昇角度範囲 (度) *エラー:*AzEl el は -90 以上、90 度以下である必要があります」 *解決策:* 上昇角度が [-90, 90] 度以内であることを確認します。 無効な方位角範囲 (ラジアン) *エラー:*AzEl az は -pi 以上、2pi ラジアン以下である必要があります」 *解決策:* 方位角が [-π, 2π] ラジアン以内であることを確認します。 無効な標高角度範囲 (ラジアン) *エラー:*AzEl el は -pi/2 以上、pi/2 ラジアン以下である必要があります」 *解決策:* 標高角度が [-π/2, π/2] ラジアン以内であることを確認します。 非単調時間値 *エラー:* 「AzElSegment 内の TimeAzEl AzElSegment 項目は一時的な順序である必要があります」 *解決策:* 各セグメントの時間値が厳密に増加していることを確認します。 セグメントの順序が間違っている *エラー:* "AzElSegments must be temporally in order" *解決策:* セグメントが時系列順に配置されていることを確認します。 セグメントの重複 *エラー:* 「少なくとも 1 つのセグメントの時間範囲が他のセグメントの時間範囲と重複しています」 *解決策:* 各セグメントに重複しない一意の時間範囲があることを確認します。1 つのセグメント`endTime`の は、次のセグメント`startTime`の を超えることはできません。 ## トラブルシューティングのステップ エフェメリスが検証に失敗した場合は、以下の手順に従って問題を解決します。 1. エフェメリス ID を使用して [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html) を呼び出し、 `errorCode`と を取得します`errorMessage`。 1. 失敗した検証チェックに関する具体的な詳細については、エラーメッセージを確認してください。 1. エフェメリスデータで特定された問題を修正します。 1. [CreateEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateEphemeris.html) を使用して、修正されたデータを含む新しいエフェメリスをアップロードします。 1. 新しいエフェメリスのステータスが `ENABLED` 状態になるまでモニタリングします。 1. 不要になった場合は、[DeleteEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DeleteEphemeris.html) を使用して無効なエフェメリスを削除します。 ## 完全なエラーコードリファレンス 以下のセクションでは、エフェメリス検証が失敗した場合に返される可能性のあるすべての`errorCode`値を高レベル`invalidReason`カテゴリ別に包括的にマッピングします。 ### 無効な理由: `METADATA_INVALID` これらのエラーは、必須メタデータフィールドが欠落しているか、形式が正しくないか、エフェメリスデータにサポートされていない値が含まれている場合に発生します。 | エラーコード | エラーメッセージ | | --- | --- | | MISMATCHED\$1SATCAT\$1ID | TLE エフェメリスに存在する衛星カタログ番号が、関連付けられた衛星の衛星カタログ番号と一致しません | | OEM\$1VERSION\$1UNSUPPORTED | OEM エフェメリスCCSDS\$1OEM\$1VERSの はサポートされていません。サポートされている値: [2.0] | | ORIGINATOR\$1MISSING | ORIGINATOR ヘッダーフィールドが OEM エフェメリスにありません | | CREATION\$1DATE\$1MISSING | CREATION\$1DATE ヘッダーフィールドが OEM エフェメリスにありません | | OBJECT\$1NAME\$1MISSING | OEM エフェメリスにOBJECT\$1NAMEメタデータフィールドがありません | | オブジェクト ID 欠落 | OEM エフェメリスにOBJECT\$1IDメタデータフィールドがありません | | REF\$1FRAME\$1UNSUPPORTED | OEM エフェメリスREF\$1FRAMEの はサポートされていません。サポートされている値: [EME2000, ITRF2000] | | REF\$1FRAME\$1EPOCH\$1UNSUPPORTED | OEM エフェメリスのREF\$1FRAME\$1EPOCHメタデータフィールドはサポートされていません。このフィールドをエフェメリスから削除してください | | TIME\$1SYSTEM\$1UNSUPPORTED | OEM エフェメリスTIME\$1SYSTEMの はサポートされていません。サポートされている値: [UTC] | | CENTER\$1BODY\$1UNSUPPORTED | OEM エフェメリスCENTER\$1BODYの はサポートされていません。サポートされている値: [Earth] | | INTERPOLATION\$1MISSING | OEM エフェメリスにINTERPOLATIONメタデータフィールドがありません | | INTERPOLATION\$1DEGREE\$1INVALID | 補間方法の場合、OEM エフェメリスの補間度は 0 より大きい必要があります | | AZ\$1EL\$1SEGMENT\$1LIST\$1MISSING | [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegments.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegments.html) フィールドがありません | | INSUFFICIENT\$1TIME\$1AZ\$1EL | 少なくとも 1 つの に[https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html)フィールドが存在しませんでした [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegments.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegments.html) | ### 無効な理由: `TIME_RANGE_INVALID` これらのエラーは、開始/終了時刻の問題、セグメントの順序付け、セグメントの重複、一時的な不整合など、エフェメリスに無効な時間範囲が含まれている場合に発生します。 | エラーコード | エラーメッセージ | | --- | --- | | START\$1TIME\$1IN\$1FUTURE | エフェメリスの開始時刻は将来のものですが、過去のものである必要があります | | END\$1TIME\$1IN\$1PAST | エフェメリスの終了時刻は過去のものですが、将来のものである必要があります | | EXPIRATION\$1TIME\$1TOO\$1EARLY | 指定された有効期限がエフェメリス終了時間より前です | | START\$1TIME\$1METADATA\$1TOO\$1EARLY | START\$1TIME メタデータ値が OEM エフェメリスデータに存在する最も早い時刻より前である | | STOP\$1TIME\$1METADATA\$1TOO\$1LATE | STOP\$1TIME メタデータ値が OEM エフェメリスデータに存在する最新の時刻より後である | | AZ\$1EL\$1SEGMENT\$1END\$1TIME\$1BEFORE\$1START\$1TIME | 少なくとも 1 つのデータセグメント[https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ISO8601TimeRange.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ISO8601TimeRange.html)の は、セグメントの [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ISO8601TimeRange.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ISO8601TimeRange.html) | | AZ\$1EL\$1SEGMENT\$1TIMES\$1OVERLAP | 少なくとも 1 つのセグメントの時間範囲が他のセグメントの時間範囲と重複している | | AZ\$1EL\$1SEGMENTS\$1OUT\$1OF\$1ORDER | セグメントが一時的に順序付けられていない | | TIME\$1AZ\$1EL\$1ITEMS\$1OUT\$1OF\$1ORDER | 内の[https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html)項目は、一時的な順序に[https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegment.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegment.html)する必要があります | | AZ\$1EL\$1SEGMENT\$1REFERENCE\$1EPOCH\$1INVALID | セグメントのリファレンスエポックが無効または形式が正しくない | | AZ\$1EL\$1SEGMENT\$1START\$1TIME\$1INVALID | セグメントの有効な時間範囲の開始時刻が最初のセグメントの後に開始されない | | AZ\$1EL\$1SEGMENT\$1END\$1TIME\$1INVALID | セグメントの有効な時間範囲の終了時刻が最後のセグメントより後に終了しない | | AZ\$1EL\$1SEGMENT\$1VALID\$1TIME\$1RANGE\$1INVALID | セグメントの有効な時間範囲が無効です | | AZ\$1EL\$1SEGMENT\$1END\$1TIME\$1TOO\$1LATE | セグメントの終了時刻が参照エポックの最大許容期間を超えています | | AZ\$1EL\$1TOTAL\$1DURATION\$1EXCEEDED | すべてのセグメントの合計時間が、許容される最大ポイント角度期間を超えています | ### 無効な理由: `TRAJECTORY_INVALID` これらのエラーは、エフェメリスに、軌道パラメータ、角度範囲、単位の問題など、無効な軌道データが含まれている場合に発生します。 | エラーコード | エラーメッセージ | | --- | --- | | MEAN\$1MOTION\$1INVALID | 提供された TLE エフェメリスの平均モーションは、最新のリファレンスエフェメリスと大きく異なります。注: Ground Station は、検証中にスペーストラックエフェメリスをリファレンスとして使用します | | TIME\$1AZ\$1EL\$1AZ\$1RADIAN\$1RANGE\$1INVALID | AzEl は -π 以上、2π ラジアン以下[https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html)である必要があります | | TIME\$1AZ\$1EL\$1EL\$1RADIAN\$1RANGE\$1INVALID | AzEl は -π/2 以上、π/2 ラジアン以下[https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html)である必要があります | | TIME\$1AZ\$1EL\$1AZ\$1DEGREE\$1RANGE\$1INVALID | AzEl は -180 以上、360 度以下[https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html)である必要があります | | TIME\$1AZ\$1EL\$1EL\$1DEGREE\$1RANGE\$1INVALID | AzEl は -90 度以上、90 度以下[https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html)である必要があります | | TIME\$1AZ\$1EL\$1ANGLE\$1UNITS\$1INVALID | 無効な AzEl 角度単位 | ### 無効な理由: `KMS_KEY_INVALID` これらのエラーは、エフェメリスデータの暗号化に使用される AWS Key Management Service (KMS) キーに問題がある場合に発生します。 | エラーコード | エラーメッセージ | | --- | --- | | INSUFFICIENT\$1KMS\$1PERMISSIONS | Ground Station には、このエフェメリスの KMS キーにアクセスするための十分なアクセス許可がありません | ### 無効な理由: `VALIDATION_ERROR` これらのエラーは、エフェメリスデータに他の特定のカテゴリに該当しない一般的な検証の問題がある場合に発生します。 | エラーコード | エラーメッセージ | | --- | --- | | INTERNAL\$1ERROR | エフェメリスの検証中に内部エラーが発生しました | | FILE\$1FORMAT\$1INVALID | エフェメリスファイル形式が無効または破損しています。ファイルがエフェメリスタイプの想定形式に準拠していることを確認します。 |