故障診斷無效的短暫性事件 - AWS Ground Station

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

故障診斷無效的短暫性事件

當您將暫時性資料上傳至 時 AWS Ground Station,它會經歷非同步驗證工作流程。如果驗證失敗,暫時性狀態會變更為 INVALIDDescribeEphemeris 回應中的錯誤訊息提供詳細資訊,協助您識別和解決問題。

了解暫時性驗證錯誤

當暫時性驗證失敗時,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的 。

疑難排解步驟

如果您的暫時性驗證失敗,請依照下列步驟解決問題:

  1. 使用您的 ephemeris ID 呼叫 DescribeEphemeris 以擷取 errorCodeerrorMessage

  2. 檢閱錯誤訊息,以取得有關哪些驗證檢查失敗的特定詳細資訊。

  3. 更正 ephemeris 資料中已識別的問題。

  4. 使用 CreateEphemeris 上傳具有更正資料的新 ephemeris。

  5. 監控新的暫時性狀態,直到其達到ENABLED狀態為止。

  6. 如果不再需要,請使用 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中的 。支援的值:【EME2000ITRF2000
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 類型的預期格式