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

# 故障診斷無效的短暫性事件
<a name="troubleshooting-invalid-ephemerides"></a>

 當您將暫時性資料上傳至 時 AWS Ground Station，它會經歷非同步驗證工作流程。如果驗證失敗，暫時性狀態會變更為 `INVALID`。[DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html) 回應中的錯誤訊息提供詳細資訊，協助您識別和解決問題。

## 了解暫時性驗證錯誤
<a name="w2aac74c19b5"></a>

 當暫時性驗證失敗時，[DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html) API 回應會包含兩個欄位，以協助診斷問題：

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 ephemerides 的常見驗證錯誤
<a name="w2aac74c19b7"></a>

 以下是上傳 TLE 暫時性資料時遇到的常見驗證錯誤：

不相符的衛星目錄編號  
 *錯誤：*「ephemeris 中存在的衛星目錄號碼與關聯的衛星目錄號碼不符」   
 *解決方案：*確認 TLE 行中的 NORAD ID/衛星目錄編號符合您衛星的衛星目錄編號。`00000` 用於沒有指派目錄編號的衛星。

無效的平均動作  
 *錯誤：*「所提供 ephemeris 的平均動作與最新的參考 ephemeris 差異太大」   
 *解決方案：*確認您的 TLE 資料正確，並代表有效的軌道。Ground Station 會在驗證期間使用 Space-Track 半聚體做為參考。

## OEM ephemerides 的常見驗證錯誤
<a name="w2aac74c19b9"></a>

 以下是上傳 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 版。

## 方位角升高環冪化物的常見驗證錯誤
<a name="w2aac74c19c11"></a>

 以下是上傳方位角海拔半合物時遇到的常見驗證錯誤：

遺失方位/上升資料  
 *錯誤：*「至少一個 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`的 。

## 疑難排解步驟
<a name="w2aac74c19c13"></a>

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

1. 使用您的 ephemeris ID 呼叫 [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html) 以擷取 `errorCode`和 `errorMessage`。

1. 檢閱錯誤訊息，以取得驗證檢查失敗的特定詳細資訊。

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

1. 使用 [CreateEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateEphemeris.html) 上傳具有更正資料的新 ephemeris。

1. 監控新的暫時性狀態，直到其達到`ENABLED`狀態為止。

1. 如果不再需要，請使用 [DeleteEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DeleteEphemeris.html) 刪除無效的暫時性資料。

## 完成錯誤碼參考
<a name="w2aac74c19c15"></a>

 下列各節提供 ephemeris 驗證失敗時可能傳回的所有`errorCode`值的完整映射，依高階`invalidReason`類別組織。

### 無效的原因： `METADATA_INVALID`
<a name="w2aac74c19c15b5"></a>

 當所需的中繼資料欄位遺失、格式不正確或在 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 | [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\_TIME\_AZ\_EL | 至少一個 中沒有[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`
<a name="w2aac74c19c15b7"></a>

 當暫時性事件包含無效的時間範圍，包括開始/結束時間、區段排序、重疊區段或時間不一致的問題時，就會發生這些錯誤。


| 錯誤程式碼 | 錯誤訊息 | 
| --- | --- | 
| 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 | 至少一個資料區段[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\_EL\_SEGMENT\_TIMES\_OVERLAP | 至少一個區段的時間範圍與其他區段時間範圍重疊 | 
| AZ\_EL\_SEGMENTS\_OUT\_OF\_ORDER | 區段不會暫時排序 | 
| TIME\_AZ\_EL\_ITEMS\_OUT\_OF\_ORDER | 內的[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\_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`
<a name="w2aac74c19c15b9"></a>

 當暫時性資料包含無效的軌跡資料，包括軌道參數、角度範圍或單位的問題時，就會發生這些錯誤。


| 錯誤程式碼 | 錯誤訊息 | 
| --- | --- | 
| MEAN\_MOTION\_INVALID | 所提供 TLE ephemeris 的平均動作與最新的參考 ephemeris 差異太大。注意：Ground Station 會在驗證期間使用 Space-Track 暫時性資料作為參考 | 
| TIME\_AZ\_EL\_AZ\_RADIAN\_RANGE\_INVALID | AzEl [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html) 必須大於或等於 -π 且小於或等於 2π 弧度 | 
| TIME\_AZ\_EL\_EL\_RADIAN\_RANGE\_INVALID | AzEl [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html) 必須大於或等於 -π/2 且小於或等於 π/2 弧度 | 
| TIME\_AZ\_EL\_AZ\_DEGREE\_RANGE\_INVALID | AzEl [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html) 必須大於或等於 -180 且小於或等於 360 度 | 
| TIME\_AZ\_EL\_EL\_DEGREE\_RANGE\_INVALID | AzEl [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html) 必須大於或等於 -90 度，且小於或等於 90 度 | 
| TIME\_AZ\_EL\_ANGLE\_UNITS\_INVALID | 無效的 AzEl 角度單位 | 

### 無效的原因： `KMS_KEY_INVALID`
<a name="w2aac74c19c15c11"></a>

 當用於加密暫時性資料的 AWS Key Management Service (KMS) 金鑰發生問題時，就會發生這些錯誤。


| 錯誤程式碼 | 錯誤訊息 | 
| --- | --- | 
| INSUFFICIENT\_KMS\_PERMISSIONS | Ground Station 沒有足夠的許可來存取此 ephemeris 的 KMS 金鑰 | 

### 無效的原因： `VALIDATION_ERROR`
<a name="w2aac74c19c15c13"></a>

 當 ephemeris 資料的一般驗證問題不屬於其他特定類別時，就會發生這些錯誤。


| 錯誤程式碼 | 錯誤訊息 | 
| --- | --- | 
| INTERNAL\_ERROR | ephemeris 驗證期間發生內部錯誤 | 
| FILE\_FORMAT\_INVALID | ephemeris 檔案格式無效或損毀。驗證檔案符合 ephemeris 類型的預期格式 |