에페메리스 검증 오류 이해 TLE 에페메리스에 대한 일반적인 검증 오류 OEM 에페메리스의 일반적인 검증 오류 방위각 고도 에페메리스에 대한 일반적인 검증 오류 문제 해결 단계 오류 코드 참조 완료

잘못된 에페메리스 문제 해결

에페메리스 데이터를 업로드하면 비동기 검증 워크플로를 AWS Ground Station거칩니다. 검증에 실패하면 에페메리스 상태가 로 변경됩니다INVALID. DescribeEphemeris 응답의 오류 메시징은 문제를 식별하고 해결하는 데 도움이 되는 자세한 정보를 제공합니다.

에페메리스 검증 오류 이해

에페메리스가 검증에 실패하면 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 에페메리스에 대한 일반적인 검증 오류

다음은 TLE 에페메리스를 업로드할 때 발생하는 일반적인 검증 오류입니다.

일치하지 않는 위성 카탈로그 번호

오류: “에페메리스에 있는 위성 카탈로그 번호가 연결된 위성의 위성 카탈로그 번호와 일치하지 않습니다.”

해결 방법: TLE 라인의 NORAD ID/위성 카탈로그 번호가 위성의 위성 카탈로그 번호와 일치하는지 확인합니다. 카탈로그 번호가 할당되지 않은 위성00000에를 사용합니다.

잘못된 평균 모션

오류: "제공된 에페메리스의 평균 모션이 가장 최근 참조 에페메리스와 너무 크게 다름"

해결 방법: TLE 데이터가 올바르고 유효한 궤도를 나타내는지 확인합니다. Ground Station은 검증 중에 스페이스 트랙 에페메리스를 참조로 사용합니다.

OEM 에페메리스의 일반적인 검증 오류

다음은 OEM 에페메리스를 업로드할 때 발생하는 일반적인 검증 오류입니다.

잘못된 참조 프레임

오류: "REF_FRAME은 지원되지 않습니다"

해결 방법: 지원되는 참조 프레임 중 하나인 EME2000 또는 ITRF2000을 사용하도록 OEM 파일을 업데이트합니다.

필수 필드 누락

오류: "Metadata 필드 누락: INTERPOLATION"

해결 방법: 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의를 초과해서는 안 됩니다.

문제 해결 단계

에페메리스가 검증에 실패하면 다음 단계에 따라 문제를 해결합니다.

에페메리스 ID로 DescribeEphemeris를 호출하여 errorCode 및를 검색합니다errorMessage.
오류 메시지를 검토하여 실패한 검증 검사에 대한 구체적인 세부 정보를 확인합니다.
에페메리스 데이터에서 식별된 문제를 수정합니다.
CreateEphemeris 업로드합니다.
ENABLED 상태가 될 때까지 새 에페메리스 상태를 모니터링합니다.
더 이상 필요하지 않은 경우 DeleteEphemeris를 사용하여 잘못된 에페메리스를 삭제합니다.

오류 코드 참조 완료

다음 섹션에서는 에페메리스 검증이 실패할 때 반환될 수 있는 모든 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	`azElSegmentList` 필드가 누락되었습니다.
INSUFFICIENT_TIME_AZ_EL	하나 이상의에 `TimeAzEl` 필드가 없습니다. `azElSegmentList`

잘못된 이유: `TIME_RANGE_INVALID`

이러한 오류는 시작/종료 시간, 세그먼트 순서 지정, 세그먼트 중첩 또는 시간 불일치 문제를 포함하여 에페메리스에 잘못된 시간 범위가 포함된 경우 발생합니다.

오류 코드	오류 메시지
START_TIME_IN_FUTURE	에페메리스 시작 시간은 미래이지만 과거여야 합니다.
END_TIME_IN_PAST	에페메리스 종료 시간은 과거이지만 미래여야 합니다.
만료_시간_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	하나 이상의 데이터 세그먼트`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	세그먼트의 참조 에포크가 잘못되었거나 형식이 잘못되었습니다.
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은 -π보다 크거나 같아`az`야 하며 2π 라디안보다 작거나 같아야 합니다.
TIME_AZ_EL_EL_RADIAN_RANGE_INVALID	AzEl은 -π/2보다 크거나 같아`el`야 하며 π/2 라디안보다 작거나 같아야 합니다.
TIME_AZ_EL_AZ_DEGREE_RANGE_INVALID	AzEl은 -180보다 크거나 같아`az`야 하고 360도보다 작거나 같아야 합니다.
TIME_AZ_EL_EL_DEGREE_RANGE_INVALID	AzEl은 -90도 이상, 90도 이하여야 `el` 합니다.
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	에페메리스 파일 형식이 잘못되었거나 손상되었습니다. 파일이 에페메리스 유형의 예상 형식을 준수하는지 확인합니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

정상 상태가 아닌 DataflowEndpointGroups 문제 해결

데이터를 수신하지 못한 고객 응대 문제 해결