本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
故障診斷無效的短暫性事件
當您將暫時性資料上傳至 時 AWS Ground Station,它會經歷非同步驗證工作流程。如果驗證失敗,暫時性狀態會變更為 INVALID。DescribeEphemeris 回應中的錯誤訊息提供詳細資訊,協助您識別和解決問題。
了解暫時性驗證錯誤
當暫時性驗證失敗時,DescribeEphemeris API 回應會包含兩個欄位,以協助診斷問題:
- 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 ephemerides 的常見驗證錯誤
以下是上傳 TLE 暫時性資料時遇到的常見驗證錯誤:
- 不相符的衛星目錄編號
-
錯誤:「ephemeris 中存在的衛星目錄號碼與關聯的衛星目錄號碼不相符」
解決方案:確認 TLE 行中的 NORAD ID/衛星目錄號碼與您衛星的衛星目錄號碼相符。
00000用於沒有指派目錄編號的衛星。 - 無效的平均動作
-
錯誤:「所提供 ephemeris 的平均動作與最新的參考 ephemeris 差異太大」
解決方案:確認您的 TLE 資料正確,並代表有效的軌道。Ground Station 會在驗證期間使用 Space-Track 暫時性資料作為參考。
OEM ephemerides 的常見驗證錯誤
以下是上傳 OEM 暫時性資料時遇到的常見驗證錯誤:
- 無效的參考框架
-
錯誤:「不支援 REF_FRAME」
解決方案:更新您的 OEM 檔案以使用其中一個支援的參考框架:EME2000 或 ITRF2000。
- 缺少必要欄位
-
錯誤:"Metadata 欄位遺失: INTERPOLATION"
解決方案:將 INTERPOLATION 和 INTERPOLATION_DEGREE 欄位新增至 OEM 中繼資料區段。這些是 產生準確天線指向角度的必要 AWS Ground Station 項目。
- 不支援的時間系統
-
錯誤:「不支援 TIME_SYSTEM」
解決方案:確保您的 OEM 檔案使用 UTC 做為時間系統。
- 不支援的 OEM 版本
-
錯誤:「不支援 CCSDS_OEM_VERS」
解決方案:確保您的 OEM 檔案使用 CCSDS OEM 2.0 版。
方位角升高環冪化物的常見驗證錯誤
以下是上傳方位角海拔半合物時遇到的常見驗證錯誤:
- 缺少方位/上升資料
-
錯誤:「至少一個 TimeAzEl AzElSegment 欄位」
解決方案:確保方位提升資料中的每個區段都包含至少一個時間標記方位/提升對。
- 無效的方位角範圍 (度)
-
錯誤:「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 必須暫時依順序排列」
解決方案:確保區段依時間順序排列。
- 重疊區段
-
錯誤:「至少一個區段的時間範圍與其他區段時間範圍重疊」
解決方案:確保每個客群都有唯一的非重疊時間範圍。一個區段
endTime的 不應超過下一個區段startTime的 。
疑難排解步驟
如果您的暫時性驗證失敗,請依照下列步驟解決問題:
-
使用您的 ephemeris ID 呼叫 DescribeEphemeris 以擷取
errorCode和errorMessage。 -
檢閱錯誤訊息,以取得有關哪些驗證檢查失敗的特定詳細資訊。
-
更正 ephemeris 資料中已識別的問題。
-
使用 CreateEphemeris 上傳具有更正資料的新 ephemeris。
-
監控新的暫時性狀態,直到其達到
ENABLED狀態為止。 -
如果不再需要,請使用 DeleteEphemeris 刪除無效的暫時性資料。
完成錯誤碼參考
下列各節提供 ephemeris 驗證失敗時可能傳回的所有errorCode值的完整映射,依高階invalidReason類別組織。
無效原因: METADATA_INVALID
當所需的中繼資料欄位遺失、格式不正確,或在 ephemeris 資料中包含不支援的值時,就會發生這些錯誤。
| 錯誤程式碼 | 錯誤訊息 |
|---|---|
| MISMATCHED_SATCAT_ID | TLE ephemeris 中存在的衛星目錄號碼與關聯的衛星目錄號碼不相符 |
| OEM_VERSION_UNSUPPORTED | 不支援 OEM ephemeris CCSDS_OEM_VERS中的 。支援的值:【2.0】 |
| ORIGINATOR_MISSING | OEM ephemeris 缺少ORIGINATOR標頭欄位 |
| CREATION_DATE_MISSING | OEM ephemeris 缺少CREATION_DATE標頭欄位 |
| OBJECT_NAME_MISSING | OEM ephemeris 缺少OBJECT_NAME中繼資料欄位 |
| OBJECT_ID_MISSING | OEM ephemeris 缺少OBJECT_ID中繼資料欄位 |
| REF_FRAME_UNSUPPORTED | 不支援 OEM ephemeris REF_FRAME中的 。支援的值:【EME2000、ITRF2000】 |
| REF_FRAME_EPOCH_UNSUPPORTED | 不支援 OEM ephemeris 中的REF_FRAME_EPOCH中繼資料欄位。請從 ephemeris 中移除此欄位 |
| TIME_SYSTEM_UNSUPPORTED | 不支援 OEM ephemeris TIME_SYSTEM中的 。支援的值:【UTC】 |
| CENTER_BODY_UNSUPPORTED | 不支援 OEM ephemeris CENTER_BODY中的 。支援的值:【Earth】 |
| INTERPOLATION_MISSING | OEM ephemeris 缺少INTERPOLATION中繼資料欄位 |
| INTERPOLATION_DEGREE_INVALID | OEM ephemeris 中的插補程度必須大於插補方法的 0 |
| AZ_EL_SEGMENT_LIST_MISSING | azElSegmentList 欄位遺失 |
| INSUFFICIENT_TIME_AZ_EL | 至少一個 中沒有TimeAzEl欄位 azElSegmentList |
無效的原因: TIME_RANGE_INVALID
當暫時性事件包含無效的時間範圍,包括開始/結束時間、區段排序、重疊區段或時間不一致的問題時,就會發生這些錯誤。
| 錯誤程式碼 | 錯誤訊息 |
|---|---|
| START_TIME_IN_FUTURE | Ephemeris 開始時間是未來的時間,但必須是過去的時間 |
| END_TIME_IN_PAST | Ephemeris 結束時間是過去的時間,但必須在未來 |
| EXPIRATION_TIME_TOO_EARLY | 提供的過期時間早於 ephemeris 結束時間 |
| START_TIME_METADATA_TOO_EARLY | START_TIME 中繼資料值早於 OEM ephemeris 資料中最早的時間 |
| STOP_TIME_METADATA_TOO_LATE | STOP_TIME 中繼資料值晚於 OEM ephemeris 資料中存在的最新時間 |
| AZ_EL_SEGMENT_END_TIME_BEFORE_START_TIME | 至少一個資料區段endTime的 早於區段的 startTime |
| AZ_EL_SEGMENT_TIMES_OVERLAP | 至少一個區段的時間範圍與其他區段時間範圍重疊 |
| AZ_EL_SEGMENTS_OUT_OF_ORDER | 區段不會暫時排序 |
| TIME_AZ_EL_ITEMS_OUT_OF_ORDER | 內的TimeAzEl項目AzElSegment必須暫時依順序排列 |
| AZ_EL_SEGMENT_REFERENCE_EPOCH_INVALID | 區段的參考 epoch 無效或格式不正確 |
| 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 | 區段的結束時間超過參考 epoch 允許的持續時間上限 |
| AZ_EL_TOTAL_DURATION_EXCEEDED | 所有區段的總持續時間超過允許的指標角度持續時間上限 |
無效原因: TRAJECTORY_INVALID
當暫時性資料包含無效的軌跡資料,包括軌道參數、角度範圍或單位的問題時,就會發生這些錯誤。
| 錯誤程式碼 | 錯誤訊息 |
|---|---|
| MEAN_MOTION_INVALID | 所提供 TLE ephemeris 的平均動作與最新的參考 ephemeris 差異太大。注意:Ground Station 會在驗證期間使用 Space-Track 暫時性資料作為參考 |
| TIME_AZ_EL_AZ_RADIAN_RANGE_INVALID | AzEl az 必須大於或等於 -π,且小於或等於 2π 弧度 |
| TIME_AZ_EL_EL_RADIAN_RANGE_INVALID | AzEl el 必須大於或等於 -π/2 且小於或等於 π/2 弧度 |
| TIME_AZ_EL_AZ_DEGREE_RANGE_INVALID | AzEl az 必須大於或等於 -180 且小於或等於 360 度 |
| TIME_AZ_EL_EL_DEGREE_RANGE_INVALID | AzEl el 必須大於或等於 -90 度,且小於或等於 90 度 |
| TIME_AZ_EL_ANGLE_UNITS_INVALID | 無效的 AzEl 角度單位 |
無效的原因: KMS_KEY_INVALID
當用於加密暫時性資料的 AWS Key Management Service (KMS) 金鑰發生問題時,就會發生這些錯誤。
| 錯誤程式碼 | 錯誤訊息 |
|---|---|
| INSUFFICIENT_KMS_PERMISSIONS | Ground Station 沒有足夠的許可可存取此暫時性的 KMS 金鑰 |
無效原因: VALIDATION_ERROR
當 ephemeris 資料的一般驗證問題不屬於其他特定類別時,就會發生這些錯誤。
| 錯誤程式碼 | 錯誤訊息 |
|---|---|
| INTERNAL_ERROR | ephemeris 驗證期間發生內部錯誤 |
| FILE_FORMAT_INVALID | ephemeris 檔案格式無效或損毀。驗證檔案符合 ephemeris 類型的預期格式 |