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：無法更新聯絡人

常見原因

聯絡人處於不允許更新的狀態。只有在聯絡案例處於 SCHEDULED、 或 PASS 狀態時PREPASS，才能呼叫 UpdateContact API。如果另一個更新已在進行中 （最新的聯絡版本處於 UPDATING 狀態），也會發生此錯誤。

解決方案

  1. 呼叫 DescribeContact 以檢查目前的聯絡狀態。

  2. 如果聯絡人處於終端狀態 （例如 COMPLETED、 或 CANCELLED)FAILED，則無法更新。只有在聯絡人處於 SCHEDULED、 或 PASS 狀態時PREPASS，才能更新聯絡人。如需終端狀態的完整清單，請參閱 AWS Ground Station聯絡狀態。

  3. 如果另一個更新正在進行中，請等待目前的更新達到 ACTIVE或 FAILED_TO_UPDATE 狀態，然後再提交另一個更新。您可以輪詢 DescribeContactVersion API，或使用 AWS SDKs和 提供的ContactUpdated等待程式便利公用程式 AWS Command Line Interface。

InvalidParameterException：無效的請求參數

常見原因

請求包含無效的參數。常見原因包括：

  • 遺失或空白 clientToken。

  • 單一請求中包含多種類型的 ProgramTrackSettings（方位/上升、OEM 和 TLE)。每個請求只允許一種類型。

  • 將 satelliteArn設定為 null，而不核准在聯絡人的地面工作站進行方位角抬高暫時性。

  • 當 satelliteArn為 null AzElProgramTrackSettings 時遺失。

  • 提供ephemerisId未與指定 相關聯的 satelliteArn。

  • 對於聯絡時間範圍，衛星沒有來自地面工作站的有效可見性時段。

  • 衛星未加入地面工作站，或沒有任務設定檔所需的授權。

  • 任務描述檔包含天線下行解調解碼組態組態，不支援聯絡人更新。

解決方案

  1. 檢閱回應中的錯誤訊息，了解哪個參數無效的詳細資訊。

  2. 請確定每個ProgramTrackSettings請求只提供一種類型的 。

  3. 如果在沒有 的情況下使用方位角/上升指向角satelliteArn，請確認您的帳戶已在地面站點獲得此功能的核准。如需詳細資訊，請參閱提供方位提升暫時性資料。

  4. 確認您參考的暫時性關聯至正確的衛星，並涵蓋聯絡時間範圍。

ResourceLimitExceededException：已達到最大版本限制

常見原因

聯絡人已達到版本數量上限 (128)。每次呼叫 UpdateContact 都會建立新的版本，且聯絡人不能超過此限制。

解決方案

  1. 此限制無法提高。如果您需要進一步變更，請取消聯絡人並保留新的聯絡人。

非同步失敗代碼

下列失敗代碼會出現在FAILED_TO_UPDATE狀態為 的聯絡版本的 failureCodes欄位中。使用 DescribeContactVersion 擷取這些詳細資訊。failureMessage 欄位提供有關失敗的其他內容。

失敗代碼 常見原因 Resolution
INTERNAL_ERROR 處理更新時發生非預期的內部錯誤。 重試更新。如果問題仍持續發生，請聯絡 AWS 支援。
INVALID_SATELLITE_ARN 更新請求中提供的衛星 ARN 無效或不存在。 驗證衛星 ARN 並確認衛星已在您的帳戶中註冊。
INVALID_UPDATE_CONTACT_REQUEST 更新請求包含同步驗證期間未攔截到的無效參數。 檢閱 failureMessage 以取得詳細資訊，並更正請求參數。
EPHEMERIS_NOT_FOUND 追蹤覆寫中參考的 ephemeris 不存在。 驗證 ephemerisId並確認尚未刪除 ephemeris。
EPHEMERIS_TIME_RANGE_INVALID ephemeris 不涵蓋聯絡的時間範圍。 上傳涵蓋完整聯絡時間範圍的新臨時事件。如果暫時時間範圍無法延長，請取消聯絡人，並在暫時時段保留新的聯絡人。如需詳細資訊，請參閱提供自訂暫時性資料。
EPHEMERIS_NOT_ENABLED 參考的 ephemeris 未處於 ENABLED 狀態。 檢查暫時性更新狀態，並在重試更新之前啟用。
SATELLITE_DOES_NOT_MATCH_EPHEMERIS ephemeris 與更新請求中指定的衛星沒有關聯。 確保 ephemerisId屬於 中指定的衛星satelliteArn。
NOT_ONBOARDED_TO_AZEL_EPHEMERIS 您的帳戶未獲核准在聯絡人的地面工作站使用方位提升暫時性資料。方位浮水印是一種限制功能，適用於有限數量的專業使用案例。 如果您的使用案例需要方位提升暫時性，請透過 開立 AWS 支援 票證AWS Support Center Console以請求存取。或者，如果符合您的使用案例，請考慮使用 TLE ephemeris 資料或 OEM ephemeris 資料。
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. 使用 呼叫 DescribeContactVersion，contactId並由UpdateContact回應versionId傳回。

  2. 檢查 version.status 欄位。狀態 ACTIVE表示已成功套用更新。狀態 FAILED_TO_UPDATE表示更新失敗。

  3. 如果狀態為 FAILED_TO_UPDATE，請檢查 version.failureCodes和 version.failureMessage 欄位以取得錯誤的詳細資訊。

提示

AWS SDKs和 AWS Command Line Interface 支援在版本達到 ACTIVE或 FAILED_TO_UPDATE 狀態DescribeContactVersion之前自動輪詢的ContactUpdated等待程式。例如， AWS Command Line Interface 提供 aws Groundstation 等待 contact-updated 命令。使用等待程式，而不是實作您自己的輪詢邏輯。