本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 对无效的星历进行故障排除
当您将星历数据上传到时 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 响应会包含两个字段来帮助诊断问题：
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/satellite 目录号是否与卫星的卫星目录号相匹配。`00000`用于没有指定目录编号的卫星。
无效的平均运动
*错误：*“提供的星历的平均运动与最新的参考星历表差异太大”
*解决方案：*验证您的 TLE 数据是否正确且代表有效的轨道。Ground Station 在验证期间使用 Space-Track 星历表作为参考。
## OEM 星历表的常见验证错误
以下是上传 OEM 星历表时遇到的常见验证错误：
参考框架无效
*错误：*“不支持 REF\_FRAME”
*解决方案：*更新您的 OEM 文件以使用其中一个支持的参考框架： EME2000 或 ITRF2000。
缺少必填字段
*错误：*“缺少元数据字段：插值”
*解决方案：*将 INTERPOLATION 和 INTERPOLATION\_DEGREE 字段添加到您的 OEM 元数据部分。它们是生成精确的 AWS Ground Station 天线指向角度所必需的。
不支持的时间系统
*错误：*“不支持 TIME\_SYSTEM”
*解决方案：*确保您的 OEM 文件使用 UTC 作为时间系统。
不支持的 OEM 版本
*错误：*“不支持 CCSDS\_OEM\_VERS”
*解决方案：*确保您的 OEM 文件使用 CCSDS OEM 版本 2.0。
## 方位角高程星历表的常见验证错误
以下是上传方位角高程星历表时遇到的常见验证错误：
缺少 azimuth/elevation 数据
*错误：*“至少有一个 TimeAzEl 字段中没有字段 AzElSegment”
*解决方案：*确保方位角高程数据中的每个分段至少包含一个带时间标签的对。 azimuth/elevation
无效的方位角范围（度）
*错误：*“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] 弧度之内。
非单调时间值
*错误：*“中的 TimeAzEl 商品 AzElSegment 必须按时间顺序排列”
*解决方案：*确保每个分段中的时间值严格增加。
区段出现故障
*错误：*“AzElSegments 必须按时间顺序排列”
*解决方案：*确保区段按时间顺序排列。
重叠的区段
*错误：*“至少一个分段的时间范围与其他分段的时间范围重叠”
*解决方案：*确保每个分段都有唯一的、不重叠的时间范围。一个分段`endTime`的值不应超过下一个分段`startTime`的值。
## 故障排除步骤
如果您的星历未能通过验证，请按照以下步骤解决问题：
1. [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`
当必填的元数据字段缺失、格式不正确或星历数据中包含不支持的值时，就会发生这些错误。
| 错误代码 | 错误消息 |
| --- | --- |
| 不匹配的\_SATCAT\_ID | TLE 星历表中的卫星目录编号与相关卫星的卫星目录号不匹配 |
| 不支持 OEM\_VERSION\_ | 不CCSDS\_OEM\_VERS支持 OEM 星历中的。支持的值：[2.0] |
| 创始人\_失踪 | OEM 星历中缺少ORIGINATOR标题字段 |
| 创建日期缺失 | OEM 星历中缺少CREATION\_DATE标题字段 |
| 缺少对象名称 | OEM 星历中缺少OBJECT\_NAME元数据字段 |
| 缺少对象 ID | OEM 星历中缺少OBJECT\_ID元数据字段 |
| REF\_FRAME\_不支持 | 不REF\_FRAME支持 OEM 星历中的。支持的值：[EME2000，ITRF2000] |
| 不支持 REF\_FRAME\_EPOCH\_EPOCH | 不支持 OEM 星历中的REF\_FRAME\_EPOCH元数据字段。请从星历中删除此字段 |
| 不支持时间系统 | 不TIME\_SYSTEM支持 OEM 星历中的。支持的值：[UTC] |
| CENTER\_BODY\_不支持 | 不CENTER\_BODY支持 OEM 星历中的。支持的值：[Earth] |
| 插值\_缺失 | OEM 星历中缺少INTERPOLATION元数据字段 |
| 插值\_度数\_无效 | 对于插值法，OEM 星历中的插值度必须大于 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)字段丢失 |
| 时间不足\_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`
当星历包含无效的时间范围时，就会发生这些错误，包括时间问题、分段顺序问题、片段重叠或 start/end 时间不一致问题。
| 错误代码 | 错误消息 |
| --- | --- |
| 将来的开始时间 | Ephemeris 的开始时间是未来，但必须是过去 |
| 过去 END\_TIME | Ephemeris 的结束时间已经过去，但必须是将来 |
| 过期\_时间\_太早了\_太早 | 提供的到期时间早于星历结束时间 |
| START\_TIME\_METADATA\_TOO\_EARLY | START\_TIME元数据值早于 OEM 星历表数据中存在的最早时间 |
| STOP\_TIME\_METADATA\_TOO\_LATE | STOP\_TIME元数据值晚于 OEM 星历表数据中显示的最新时间 |
| 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\_OVERLA | 至少一个分段的时间范围与其他分段的时间范围重叠 |
| AZ\_EL\_SEGMENTS\_OUT\_OF\_ORDER | 区段不是按时间顺序排列的 |
| TIME\_AZ\_EL\_EL\_ITEMS\_OURD\_OURDER | a 中的[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 | 片段的参考周期无效或格式不正确 |
| AZ\_EL\_SEGMENT\_START\_TIME\_无效 | 区段有效时间范围内的开始时间不会在第一个分段之后开始 |
| AZ\_EL\_SEGMENT\_END\_TIME\_无效 | 区段有效时间范围内的结束时间不会在最后一个分段之后结束 |
| AZ\_EL\_SEGMENT\_VALID\_TIME\_RANGE\_VALID\_ | 区段的有效时间范围无效 |
| AZ\_EL\_SEGMENT\_END\_TIME\_TIME\_TOO\_LATE | 片段的结束时间超过了从参考周期开始的最大允许持续时间 |
| 已超过 AZ\_EL\_TOTAL\_持续时间 | 所有分段的总持续时间超过了允许的最大指向角度持续时间 |
### 无效原因：`TRAJECTORY_INVALID`
当星历中包含无效的轨迹数据（包括轨道参数、角度范围或单位问题）时，就会发生这些错误。
| 错误代码 | 错误消息 |
| --- | --- |
| MEAN\_MOTION\_无效 | 所提供的 TLE 星历的平均动作与最新的参考星历表差异太大。注意：Ground Station 在验证期间使用 Space-Track 星历表作为参考 |
| TIME\_AZ\_EL\_AZ\_RADIAN\_RANGE\_RANGE\_无效 | 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\_RANGE\_无效 | 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 弧度 |
| 时间\_AZ\_EL\_AZ\_DEGRE\_RANGE\_RANGE\_无效 | 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\_RANGE\_ | 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\_ANGLE\_UNITS 无效 | AzEl 角度单位无效 |
### 无效原因：`KMS_KEY_INVALID`
当用于加密星历数据的 AWS 密钥管理服务 (KMS) 密钥出现问题时，就会发生这些错误。
| 错误代码 | 错误消息 |
| --- | --- |
| KMS\_权限不足 | Ground Station 没有足够的权限访问此简历的 KMS 密钥 |
### 无效原因：`VALIDATION_ERROR`
当星历数据存在不属于其他特定类别的一般验证问题时，就会发生这些错误。
| 错误代码 | 错误消息 |
| --- | --- |
| INTERNAL\_ERROR | 校验星历期间出现内部错误 |
| 文件格式无效 | 星历文件格式无效或已损坏。验证文件是否符合星历类型的预期格式 |