기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 잘못된 에페메리스 문제 해결 에페메리스 데이터를 업로드하면 비동기 검증 워크플로를 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/위성 카탈로그 번호가 위성의 위성 카탈로그 번호와 일치하는지 확인합니다. 카탈로그 번호가 할당되지 않은 위성`00000`에를 사용합니다. 잘못된 평균 모션 *오류:* "제공된 에페메리스의 평균 모션이 가장 최근 참조 에페메리스와 너무 크게 다름" *해결 방법:* TLE 데이터가 올바르고 유효한 궤도를 나타내는지 확인합니다. Ground Station은 검증 중에 스페이스 트랙 에페메리스를 참조로 사용합니다. ## OEM 에페메리스의 일반적인 검증 오류 다음은 OEM 에페메리스를 업로드할 때 발생하는 일반적인 검증 오류입니다. 잘못된 참조 프레임 *오류:* "REF\_FRAME은 지원되지 않습니다" *해결 방법:* 지원되는 참조 프레임 중 하나인 EME2000 또는 ITRF2000을 사용하도록 OEM 파일을 업데이트합니다. 필수 필드 누락 *오류:* "메타데이터 필드 누락: 보간" *해결 방법:* OEM 메타데이터 섹션에 INTERPOLATION 및 INTERPOLATION\_DEGREE 필드를 추가합니다. 이는가 정확한 안테나 조준 각도를 생성하는 AWS Ground Station 데 필요합니다. 지원되지 않는 시간 시스템 *오류:* "TIME\_SYSTEM은 지원되지 않습니다" *해결 방법:* OEM 파일이 UTC를 시간 시스템으로 사용하는지 확인합니다. 지원되지 않는 OEM 버전 *오류:* “CCSDS\_OEM\_VERS는 지원되지 않습니다.” *해결 방법:* OEM 파일이 CCSDS OEM 버전 2.0을 사용하는지 확인합니다. ## 방위각 고도 에페메리스에 대한 일반적인 검증 오류 다음은 방위각 고도 에페메리스를 업로드할 때 발생하는 일반적인 검증 오류입니다. 방위각/상승 데이터 누락 *오류:* “하나 이상의 AzElSegment에 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. 에페메리스 ID로 [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` 이러한 오류는 필수 메타데이터 필드가 누락되었거나, 형식이 잘못 지정되었거나, 에페메리스 데이터에 지원되지 않는 값이 포함된 경우에 발생합니다. | 오류 코드 | 오류 메시지 | | --- | --- | | MISMATCHED\_SATCAT\_ID | TLE 에페메리스에 있는 위성 카탈로그 번호가 관련 위성의 위성 카탈로그 번호와 일치하지 않습니다. | | OEM\_VERSION\_UNSUPPORTED | OEM 에페메리스CCSDS\_OEM\_VERS의는 지원되지 않습니다. 지원되는 값: [2.0] | | ORIGINATOR\_MISSING | OEM 에페메리스에서 ORIGINATOR 헤더 필드가 누락되었습니다. | | CREATION\_DATE\_MISSING | OEM 에페메리스에서 CREATION\_DATE 헤더 필드가 누락되었습니다. | | OBJECT\_NAME\_MISSING | OEM 에페메리스에서 OBJECT\_NAME 메타데이터 필드가 누락되었습니다. | | OBJECT\_ID\_MISSING | OEM 에페메리스에서 OBJECT\_ID 메타데이터 필드가 누락되었습니다. | | REF\_FRAME\_UNSUPPORTED | OEM 에페메리스REF\_FRAME의는 지원되지 않습니다. 지원되는 값: [EME2000, ITRF2000] | | REF\_FRAME\_EPOCH\_UNSUPPORTED | OEM 에페메리스의 REF\_FRAME\_EPOCH 메타데이터 필드는 지원되지 않습니다. 에페메리스에서이 필드를 제거하세요. | | TIME\_SYSTEM\_UNSUPPORTED | OEM 에페메리스TIME\_SYSTEM의는 지원되지 않습니다. 지원되는 값: [UTC] | | CENTER\_BODY\_UNSUPPORTED | OEM 에페메리스CENTER\_BODY의는 지원되지 않습니다. 지원되는 값: [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) 필드가 누락되었습니다. | | 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` 이러한 오류는 시작/종료 시간, 세그먼트 순서 지정, 세그먼트 중첩 또는 시간 불일치 문제를 포함하여 에페메리스에 잘못된 시간 범위가 포함된 경우 발생합니다. | 오류 코드 | 오류 메시지 | | --- | --- | | START\_TIME\_IN\_FUTURE | 에페메리스 시작 시간은 미래이지만 과거여야 합니다. | | END\_TIME\_IN\_PAST | 에페메리스 종료 시간은 과거이지만 미래여야 합니다. | | EXPIRATION\_TIME\_TOO\_EARLY | 제공된 만료 시간이 임시 종료 시간보다 빠릅니다. | | 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\_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 | 세그먼트의 참조 에포크가 잘못되었거나 형식이 잘못되었습니다. | | 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 | 세그먼트의 종료 시간이 참조 에포크에서 허용되는 최대 기간을 초과합니다. | | AZ\_EL\_TOTAL\_DURATION\_EXCEEDED | 모든 세그먼트의 총 지속 시간이 허용되는 최대 지시각 지속 시간을 초과합니다. | ### 잘못된 이유: `TRAJECTORY_INVALID` 이러한 오류는 궤도 파라미터, 각도 범위 또는 단위 문제를 포함하여 에페메리스에 잘못된 궤적 데이터가 포함된 경우 발생합니다. | 오류 코드 | 오류 메시지 | | --- | --- | | MEAN\_MOTION\_INVALID | 제공된 TLE 에페메리스의 평균 모션은 가장 최근의 참조 에페메리스와 너무 크게 다릅니다. 참고: Ground Station은 검증 중에 스페이스 트랙 에페메리스를 참조로 사용합니다. | | 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은 -π/2보다 크거나 같아[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\_AZ\_DEGREE\_RANGE\_INVALID | AzEl은 -180보다 크거나 같아[https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html)야 하고 360도보다 작거나 같아야 합니다. | | TIME\_AZ\_EL\_EL\_DEGREE\_RANGE\_INVALID | AzEl은 -90도 이상, 90도 이하여야 [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html) 합니다. | | TIME\_AZ\_EL\_ANGLE\_UNITS\_INVALID | 잘못된 AzEl 각도 단위 | ### 잘못된 이유: `KMS_KEY_INVALID` 이러한 오류는 에페메리스 데이터를 암호화하는 데 사용되는 AWS Key Management Service (KMS) 키에 문제가 있을 때 발생합니다. | 오류 코드 | 오류 메시지 | | --- | --- | | INSUFFICIENT\_KMS\_PERMISSIONS | Ground Station에이 에페메리스의 KMS 키에 액세스할 수 있는 충분한 권한이 없습니다. | ### 잘못된 이유: `VALIDATION_ERROR` 이러한 오류는 다른 특정 범주에 속하지 않는 에페메리스 데이터에 일반적인 검증 문제가 있을 때 발생합니다. | 오류 코드 | 오류 메시지 | | --- | --- | | INTERNAL\_ERROR | 에페메리스 검증 중에 내부 오류가 발생했습니다. | | FILE\_FORMAT\_INVALID | 에페메리스 파일 형식이 잘못되었거나 손상되었습니다. 파일이 에페메리스 유형의 예상 형식을 준수하는지 확인합니다. |