無効なエフェメリスのトラブルシューティング - AWS Ground Station
エフェメリス検証エラーについてTLE エフェメリスの一般的な検証エラーOEM エフェメリスの一般的な検証エラー方位高度エフェメリスの一般的な検証エラートラブルシューティングのステップ完全なエラーコードリファレンス

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

無効なエフェメリスのトラブルシューティング

エフェメリスデータを にアップロードすると AWS Ground Station、非同期検証ワークフローが実行されます。検証が失敗すると、エフェメリスステータスは に変わりますINVALID。DescribeEphemeris レスポンスのエラーメッセージは、問題の特定と解決に役立つ詳細情報を提供します。

エフェメリス検証エラーについて

エフェメリスが検証に失敗すると、DescribeEphemeris API レスポンスには、問題の診断に役立つ 2 つのフィールドが含まれます。

errorCode

特定の検証エラーを識別する機械読み取り可能なコード。これはプログラムによるエラー処理に使用できます。

errorMessage

問題の詳細と修正方法に関するガイダンスを含む、人間が読める検証エラーの説明。

無効なエフェメリスに対する DescribeEphemeris レスポンスの例: 

{
    "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_FRAME はサポートされていません」

解決策: サポートされているリファレンスフレームの 1 つを使用するように OEM ファイルを更新します: EME2000 または ITRF2000。

必須フィールドがありません

エラー:「メタデータフィールドがありません: INTERPOLATION」

解決策: INTERPOLATION フィールドと INTERPOLATION_DEGREE フィールドを OEM メタデータセクションに追加します。これらは、 が正確なアンテナポイント角度を生成する AWS Ground Station ために必要です。

サポートされていない時間システム

エラー:「TIME_SYSTEM はサポートされていません」

解決策: OEM ファイルがタイムシステムとして UTC を使用していることを確認します。

サポートされていない OEM バージョン

エラー:「CCSDS_OEM_VERS はサポートされていません」

解決策: 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 を呼び出し、 errorCodeと を取得しますerrorMessage。

  2. 失敗した検証チェックに関する具体的な詳細については、エラーメッセージを確認してください。

  3. エフェメリスデータで特定された問題を修正します。

  4. CreateEphemeris を使用して、修正されたデータを含む新しいエフェメリスをアップロードします。

  5. 新しいエフェメリスのステータスが ENABLED 状態になるまでモニタリングします。

  6. 不要になった場合は、DeleteEphemeris を使用して無効なエフェメリスを削除します。

完全なエラーコードリファレンス

以下のセクションでは、エフェメリス検証が失敗した場合に返される可能性のあるすべてのerrorCode値を、高レベルinvalidReasonカテゴリ別に包括的にマッピングします。

無効な理由: METADATA_INVALID

これらのエラーは、必須メタデータフィールドが欠落しているか、形式が正しくないか、エフェメリスデータにサポートされていない値が含まれている場合に発生します。

エラーコード エラーメッセージ
MISMATCHED_SATCAT_ID TLE エフェメリスに存在する衛星カタログ番号が、関連付けられた衛星の衛星カタログ番号と一致しません
OEM_VERSION_UNSUPPORTED OEM エフェメリスCCSDS_OEM_VERSの はサポートされていません。サポートされている値: [2.0]
ORIGINATOR_MISSING ORIGINATOR ヘッダーフィールドが OEM エフェメリスにありません
CREATION_DATE_MISSING CREATION_DATE ヘッダーフィールドが OEM エフェメリスにありません
オブジェクト名がありません OEM エフェメリスにOBJECT_NAMEメタデータフィールドがありません
OBJECT_ID_MISSING OEM エフェメリスにOBJECT_IDメタデータフィールドがありません
REF_FRAME_UNSUPPORTED OEM エフェメリスREF_FRAMEの はサポートされていません。サポートされている値: [EME2000, ITRF2000]
REF_FRAME_EPOCH_UNSUPPORTED OEM エフェメリスのREF_FRAME_EPOCHメタデータフィールドはサポートされていません。このフィールドをエフェメリスから削除してください
TIME_SYSTEM_UNSUPPORTED OEM エフェメリスTIME_SYSTEMの はサポートされていません。サポートされている値: [UTC]
CENTER_BODY_UNSUPPORTED OEM エフェメリスCENTER_BODYの はサポートされていません。サポートされている値: [Earth]
INTERPOLATION_MISSING OEM エフェメリスにINTERPOLATIONメタデータフィールドがありません
INTERPOLATION_DEGREE_INVALID 補間方法の場合、OEM エフェメリスの補間度は 0 より大きい必要があります
AZ_EL_SEGMENT_LIST_MISSING azElSegmentList フィールドがありません
INSUFFICIENT_TIME_AZ_EL 少なくとも 1 つの にTimeAzElフィールドが存在しませんでした azElSegmentList

無効な理由: TIME_RANGE_INVALID

これらのエラーは、開始/終了時刻の問題、セグメントの順序付け、セグメントの重複、一時的な不整合など、エフェメリスに無効な時間範囲が含まれている場合に発生します。

エラーコード エラーメッセージ
START_TIME_IN_FUTURE エフェメリスの開始時刻は将来のものですが、過去のものである必要があります
END_TIME_IN_PAST エフェメリスの終了時刻は過去のものですが、将来のものである必要があります
EXPIRATION_TIME_TOO_EARLY 指定された有効期限がエフェメリス終了時間より前です
START_TIME_METADATA_TOO_EARLY START_TIME メタデータ値が OEM エフェメリスデータに存在する最も早い時刻より前である
STOP_TIME_METADATA_TOO_LATE STOP_TIME メタデータ値が OEM エフェメリスデータに存在する最新の時刻より後である
AZ_EL_SEGMENT_END_TIME_BEFORE_START_TIME 少なくとも 1 つのデータセグメントendTimeの は、セグメントの startTime
AZ_EL_SEGMENT_TIMES_OVERLAP 少なくとも 1 つのセグメントの時間範囲が他のセグメントの時間範囲と重複している
AZ_EL_SEGMENTS_OUT_OF_ORDER セグメントが一時的に順序付けられていない
TIME_AZ_EL_ITEMS_OUT_OF_ORDER 内のTimeAzEl項目は、AzElSegment一時的な順序である必要があります
AZ_EL_SEGMENT_REFERENCE_EPOCH_INVALID セグメントのリファレンスエポックが無効であるか、形式が正しくありません
AZ_EL_SEGMENT_START_TIME_INVALID セグメントの有効な時間範囲の開始時刻が最初のセグメントの後に開始されない
AZ_EL_SEGMENT_END_TIME_INVALID セグメントの有効な時間範囲の終了時刻が最後のセグメントより後に終了しない
AZ_EL_SEGMENT_VALID_TIME_RANGE_INVALID セグメントの有効な時間範囲が無効です
AZ_EL_SEGMENT_END_TIME_TOO_LATE セグメントの終了時刻が参照エポックの最大許容期間を超えています
AZ_EL_TOTAL_DURATION_EXCEEDED すべてのセグメントの合計時間が、許容される最大ポインティング角度期間を超えています

無効な理由: TRAJECTORY_INVALID

これらのエラーは、エフェメリスに、軌道パラメータ、角度範囲、単位の問題など、無効な軌道データが含まれている場合に発生します。

エラーコード エラーメッセージ
MEAN_MOTION_INVALID 提供された TLE エフェメリスの平均モーションは、最新のリファレンスエフェメリスと大きく異なります。注: Ground Station は、検証中にスペーストラックエフェメリスをリファレンスとして使用します
TIME_AZ_EL_AZ_RADIAN_RANGE_INVALID AzEl は -π 以上、2π ラジアン以下azである必要があります
TIME_AZ_EL_EL_RADIAN_RANGE_INVALID AzEl は -π/2 以上、π/2 ラジアン以下elである必要があります
TIME_AZ_EL_AZ_DEGREE_RANGE_INVALID AzEl は -180 以上、360 度以下azである必要があります
TIME_AZ_EL_EL_DEGREE_RANGE_INVALID AzEl は -90 度以上、90 度以下elである必要があります
TIME_AZ_EL_ANGLE_UNITS_INVALID 無効な AzEl 角度単位

無効な理由: KMS_KEY_INVALID

これらのエラーは、エフェメリスデータの暗号化に使用される AWS Key Management Service (KMS) キーに問題がある場合に発生します。

エラーコード エラーメッセージ
INSUFFICIENT_KMS_PERMISSIONS Ground Station には、このエフェメリスの KMS キーにアクセスするための十分なアクセス許可がありません

無効な理由: VALIDATION_ERROR

これらのエラーは、エフェメリスデータに他の特定のカテゴリに該当しない一般的な検証の問題がある場合に発生します。

エラーコード エラーメッセージ
INTERNAL_ERROR エフェメリスの検証中に内部エラーが発生しました
FILE_FORMAT_INVALID エフェメリスファイル形式が無効または破損しています。ファイルがエフェメリスタイプの想定形式に準拠していることを確認します。