View a markdown version of this page

실패한 고객 응대 업데이트 문제 해결 - AWS Ground Station
동기 검증 오류비동기 장애 코드업데이트 상태 확인

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

실패한 고객 응대 업데이트 문제 해결

UpdateContact API를 호출하면가 요청에 대해 동기 검증을 AWS Ground Station 수행합니다. 검증이 통과하면 업데이트가 비동기적으로 처리되어 변경 사항이 안테나 리전에 전파됩니다. 동기 검증 오류는 HTTP 응답에서 직접 반환됩니다. 비동기 실패는 연락처 버전의 failureCodes 및 failureMessage 필드를 통해 보고되며, 업데이트에 실패한 버전에 대해 DescribeContactVersion을 호출하여 볼 수 있습니다.

고객 응대 버전 관리에 대한 자세한 내용은 섹션을 참조하세요연락처 및 연락처 버전 관리 업데이트.

동기 검증 오류

UpdateContact 요청이 검증에 실패하면 HTTP 응답에 다음 오류가 직접 반환됩니다.

ResourceNotFoundException: 연락처를 찾을 수 없음

일반적인 원인

지정된이 contactId 존재하지 않거나 다른 AWS 계정에 속합니다.

​해결 방법

  1. contactId가 올바른지 확인합니다.

  2. 연락처를 소유한 AWS 계정의 자격 증명을 사용하고 있는지 확인합니다.

  3. ListContacts를 사용하여 올바른를 찾습니다contactId.

ConflictException: 연락처를 업데이트할 수 없음

일반적인 원인

연락처가 업데이트를 허용하지 않는 상태입니다. UpdateContact API는 연락처가 SCHEDULED, PREPASS또는 PASS 상태일 때만 호출할 수 있습니다. 이 오류는 다른 업데이트가 이미 진행 중인 경우에도 발생합니다(최신 연락처 버전이 UPDATING 상태임).

​해결 방법

  1. DescribeContact를 호출하여 현재 연락처 상태를 확인합니다.

  2. 연락처가 터미널 상태(예: , COMPLETED FAILED또는 CANCELLED)인 경우 업데이트할 수 없습니다. 연락처는 SCHEDULED, PREPASS또는 PASS 상태일 때만 업데이트할 수 있습니다. 터미널 상태의 전체 목록은 섹션을 참조하세요AWS Ground Station고객 응대 상태.

  3. 다른 업데이트가 진행 중인 경우 다른 업데이트를 제출하기 전에 현재 업데이트가 ACTIVE 또는 FAILED_TO_UPDATE 상태에 도달할 때까지 기다립니다. DescribeContactVersion API를 폴링하거나 someSDK 및에서 제공하는 ContactUpdated웨이터 편의 유틸리티를 사용할 수 있습니다 AWS Command Line Interface. AWS SDKs

InvalidParameterException: 잘못된 요청 파라미터

일반적인 원인

요청에 잘못된 파라미터가 포함되어 있습니다. 일반적인 사용 사례는 다음과 같습니다.

  • 가 누락되었거나 비어 있습니다clientToken.

  • 단일 요청에 포함된 여러 유형의 ProgramTrackSettings (azimuth/elevation, OEM 및 TLE) 요청당 하나의 유형만 허용됩니다.

  • 고객 응대의 지상국에서 방위 고도 에페메리스에 대한 승인을 받지 않고 satelliteArn null로 설정합니다.

  • satelliteArn가 null인 AzElProgramTrackSettings 경우 누락됩니다.

  • 지정된와 연결되지 ephemerisId 않은를 제공합니다satelliteArn.

  • 위성에는 접촉 시간 범위에 대한 지상국의 유효한 가시성 창이 없습니다.

  • 위성이 지상국에 온보딩되지 않았거나 미션 프로파일에 필요한 라이선스가 없습니다.

  • 미션 프로파일에는 연락처 업데이트에 지원되지 않는 안테나 다운링크 복조 디코드 구성 구성이 포함되어 있습니다.

​해결 방법

  1. 응답의 오류 메시지를 검토하여 유효하지 않은 파라미터에 대한 세부 정보를 확인합니다.

  2. 요청ProgramTrackSettings당 정확히 한 가지 유형의를 제공해야 합니다.

  3. 없이 방위각/상승 각도를 사용하는 경우 해당 계정이 지상국에서이 기능에 대해 승인되었는지 satelliteArn확인합니다. 자세한 내용은 방위각 고도 에페메리스 데이터 제공 단원을 참조하십시오.

  4. 참조하는 에페메리스가 올바른 위성과 연결되어 있고 연락 시간 범위를 포함하는지 확인합니다.

ResourceLimitExceededException: 최대 버전 제한에 도달함

일반적인 원인

고객 응대가 최대 버전 수(128)에 도달했습니다. UpdateContact에 대한 각 호출은 새 버전을 생성하며 연락처는이 제한을 초과할 수 없습니다.

​해결 방법

  1. 이 한도는 늘릴 수 없습니다. 추가 변경이 필요한 경우 연락처를 취소하고 새 연락처를 예약합니다.

비동기 장애 코드

다음 실패 코드는 연락처 버전의 failureCodes 필드에 FAILED_TO_UPDATE 상태인 상태로 표시됩니다. DescribeContactVersion을 사용하여 이러한 세부 정보를 검색합니다. failureMessage 필드는 실패에 대한 추가 컨텍스트를 제공합니다.

실패 코드 일반적인 원인 해결 방법
INTERNAL_ERROR 업데이트를 처리하는 동안 예기치 않은 내부 오류가 발생했습니다. 업데이트를 다시 시도합니다. 문제가 지속되면 AWS Support에 문의하세요.
INVALID_SATELLITE_ARN 업데이트 요청에 제공된 위성 ARN이 유효하지 않거나 존재하지 않습니다. 위성 ARN을 확인하고 위성이 계정에 등록되어 있는지 확인합니다.
INVALID_UPDATE_CONTACT_REQUEST 업데이트 요청에 동기 검증 중에 포착되지 않은 잘못된 파라미터가 포함되어 있습니다. 에서 failureMessage 세부 정보를 검토하고 요청 파라미터를 수정합니다.
EPHEMERIS_NOT_FOUND 추적 재정의를 참조하는 에페메리스가 존재하지 않습니다. 를 ephemerisId 확인하고 에페메리스가 삭제되지 않았는지 확인합니다.
EPHEMERIS_TIME_RANGE_INVALID 에페메리스는 고객 응대의 시간 범위를 다루지 않습니다. 전체 연락 시간 범위를 포함하는 새 에페메리스를 업로드합니다. 임시 시간 범위를 확장할 수 없는 경우 연락처를 취소하고 임시 시간 범위 동안 새 연락처를 예약합니다. 자세한 내용은 사용자 지정 에페메리스 데이터 제공 단원을 참조하십시오.
EPHEMERIS_NOT_ENABLED 참조된 에페메리스가 ENABLED 상태가 아닙니다. 업데이트를 다시 시도하기 전에 에페메리스 상태를 확인하고 활성화합니다.
SATELLITE_DOES_NOT_MATCH_EPHEMERIS 에페메리스는 업데이트 요청에 지정된 위성과 연결되지 않습니다. 가에 지정된 위성에 ephemerisId 속하는지 확인합니다satelliteArn.
NOT_ONBOARDED_TO_AZEL_EPHEMERIS 계정이 연락처의 지상국에서 방위각 고도 에페메리스 데이터를 사용하도록 승인되지 않았습니다. 방위각 고도 에페메리스는 제한된 수의 특수 사용 사례에 사용할 수 있는 제한된 기능입니다. 사용 사례에 방위각 고도 에페메리스가 필요한 경우를 통해 AWS Support 티켓을 열어 액세스를 AWS Support Center Console 요청합니다. 또는 사용 사례에 맞는 경우 TLE 에페메리스 데이터 또는 OEM 에페메리스 데이터를 사용하는 것이 좋습니다.
AZEL_EPHEMERIS_NOT_FOUND 요청에 참조된 방위각 고도 에페메리스가 존재하지 않습니다. 를 ephemerisId 확인하고 방위각 고도 에페메리스가 삭제되지 않았는지 확인합니다.
AZEL_EPHEMERIS_WRONG_GROUND_STATION 방위각 고도 에페메리스는 고객 응대에서 사용하는 것과 다른 지상국에 대해 생성되었습니다. 올바른 지상국에 대한 새 방위각 고도 에페메리스를 업로드하거나 연락처의 지상국과 일치하는 기존 에페메리스를 사용합니다.
AZEL_EPHEMERIS_INVALID_STATUS 방위각 고도 에페메리스가 유효한 사용 상태가 아닙니다. 에페메리스 상태를 확인합니다. 상태여야 합니다ENABLED. 에페메리스가 검증에 실패한 경우 수정된 버전을 업로드합니다.
AZEL_EPHEMERIS_TIME_RANGE_INVALID 방위각 고도 에페메리스는 고객 응대의 시간 범위를 다루지 않습니다. 전체 연락 시간 범위를 포함하는 새 방위각 고도 에페메리스를 업로드합니다. 임시 시간 범위를 확장할 수 없는 경우 연락처를 취소하고 임시 시간 범위 동안 새 연락처를 예약합니다.

업데이트 상태 확인

UpdateContact를 호출한 후 새 연락처 버전이 UPDATING 상태로 시작됩니다. 이 기간 동안 DescribeContact는 이전 활성 버전의 연락처를 계속 반환합니다. 새 버전은 안테나로 전파되고 ACTIVE 상태에 도달할 DescribeContact 때까지에 표시되지 않습니다. 특정 버전의 상태를 확인하려면 DescribeContactVersion을 사용합니다.

업데이트 성공 또는 실패 여부를 확인하려면:

  1. UpdateContact 응답에서 versionId 반환된 contactId 및를 사용하여 DescribeContactVersion을 호출합니다.

  2. version.status 필드를 확인합니다. 상태가 이면 업데이트가 성공적으로 적용되었음을 ACTIVE 의미합니다. 상태가 이면 업데이트가 실패했음을 FAILED_TO_UPDATE 의미합니다.

  3. 상태가 인 경우 version.failureCodes 및 version.failureMessage 필드에서 무엇이 잘못되었는지 자세히 FAILED_TO_UPDATE확인합니다.

작은 정보

AWS SDKs 및는 버전이 ACTIVE 또는 FAILED_TO_UPDATE 상태에 도달할 DescribeContactVersion 때까지 자동으로 폴링하는 ContactUpdated웨이터를 AWS Command Line Interface 지원합니다. 예를 들어는 aws groundstation wait contact-updated 명령을 AWS Command Line Interface 제공합니다. 자체 폴링 로직을 구현하는 대신 웨이터를 사용합니다.