本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
对无效的星历进行故障排除
当您将星历数据上传到时 AWS Ground Station，它会经过异步验证工作流程。如果验证失败，则星历状态将更改为。INVALIDDescribeEphemeris响应中的错误消息提供了详细信息，可帮助您识别和解决问题。
了解星历验证错误
当星历未通过验证时，DescribeEphemerisAPI 响应会包含两个字段来帮助诊断问题：
- 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/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的值。
故障排除步骤
如果您的星历未能通过验证，请按照以下步骤解决问题：
-
DescribeEphemeris使用您的星历编号致电以检索和。
errorCodeerrorMessage -
查看错误消息，了解有关哪些验证检查失败的具体详细信息。
-
更正星历数据中已发现的问题。
-
使用上传包含更正数据的新星历。CreateEphemeris
-
监控新的星历状态，直到其达到状态。
ENABLED -
DeleteEphemeris如果不再需要无效的星历表，请使用将其删除。
完整的错误代码参考
以下各节按高级类别提供了星历验证失败时可能返回的所有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 | 该azElSegmentList字段丢失 |
| 时间不足_AZ_EL | 至少有一个TimeAzEl字段中没有字段 azElSegmentList |
无效原因：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 | 至少有一个数据段endTime的位于该分段之前 startTime |
| AZ_EL_SEGMENT_TIMES_OVERLA | 至少一个分段的时间范围与其他分段的时间范围重叠 |
| AZ_EL_SEGMENTS_OUT_OF_ORDER | 区段不是按时间顺序排列的 |
| TIME_AZ_EL_EL_ITEMS_OURD_OURDER | a 中的TimeAzEl项目AzElSegment必须按时间顺序排列 |
| 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 az必须大于或等于-π 且小于或等于 2π 弧度 |
| TIME_AZ_EL_EL_RADIAN_RANGE_RANGE_无效 | AzEl el必须大于或等于-π/2 且小于或等于 π/2 弧度 |
| 时间_AZ_EL_AZ_DEGRE_RANGE_RANGE_无效 | AzEl az必须大于或等于 -180 且小于或等于 360 度 |
| TIME_AZ_EL_EL_DEGREE_RANGE_RANGE_ | AzEl el必须大于或等于 -90 度且小于或等于 90 度 |
| TIME_AZ_EL_ANGLE_ANGLE_UNITS 无效 | AzEl 角度单位无效 |
无效原因：KMS_KEY_INVALID
当用于加密星历数据的 AWS 密钥管理服务 (KMS) 密钥出现问题时，就会发生这些错误。
| 错误代码 | 错误消息 |
|---|---|
| KMS_权限不足 | Ground Station 没有足够的权限访问此简历的 KMS 密钥 |
无效原因：VALIDATION_ERROR
当星历数据存在不属于其他特定类别的一般验证问题时，就会发生这些错误。
| 错误代码 | 错误消息 |
|---|---|
| INTERNAL_ERROR | 校验星历期间出现内部错误 |
| 文件格式无效 | 星历文件格式无效或已损坏。验证文件是否符合星历类型的预期格式 |
