View a markdown version of this page

失敗した問い合わせの更新のトラブルシューティング - AWS Ground Station
同期検証エラー非同期障害コード更新のステータスの確認

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

失敗した問い合わせの更新のトラブルシューティング

UpdateContact API を呼び出すと、 はリクエストに対して同期検証 AWS Ground Station を実行します。検証に合格すると、アンテナリージョンに変更を伝達するために、更新が非同期的に処理されます。同期検証エラーは HTTP レスポンスに直接返されます。非同期障害は、問い合わせバージョンの failureCodesおよび failureMessageフィールドを通じて報告されます。これを表示するには、更新に失敗したバージョンの DescribeContactVersion を呼び出します。

問い合わせのバージョニングの詳細については、「」を参照してください連絡先と連絡先のバージョニングを更新する。

同期検証エラー

UpdateContact リクエストが検証に失敗すると、次のエラーが HTTP レスポンスに直接返されます。

ResourceNotFoundException: 問い合わせが見つかりません

一般的な原因

指定された が存在しないか、別の AWS アカウントに属contactIdしています。

解決策

  1. contactId が正しいことを確認します。

  2. 問い合わせを所有する AWS アカウントの認証情報を使用していることを確認します。

  3. ListContacts を使用して正しい を見つけますcontactId。

ConflictException: 問い合わせを更新できません

一般的な原因

問い合わせは、更新を許可しない状態です。UpdateContact API は、問い合わせが SCHEDULED、、PREPASSまたは PASS状態にある場合にのみ呼び出すことができます。このエラーは、別の更新がすでに進行中 (最新の問い合わせバージョンが UPDATING状態) でも発生します。

解決策

  1. DescribeContact を呼び出して、現在の問い合わせステータスを確認します。

  2. 問い合わせが終了状態 (、、 などCANCELLED) COMPLETEDの場合FAILED、更新できません。コンタクトは、SCHEDULED、、PREPASSまたは PASS状態にある場合にのみ更新できます。ターミナル状態の詳細なリストについては、「」を参照してくださいAWS Ground Station問い合わせステータス。

  3. 別の更新が進行中の場合は、現在の更新が ACTIVEまたは FAILED_TO_UPDATEステータスになるまで待ってから、別の更新を送信します。DescribeContactVersion API をポーリングするか、一部の AWS SDKs と が提供するContactUpdatedウェーターコンビニエンスユーティリティを使用できます AWS Command Line Interface。

InvalidParameterException: 無効なリクエストパラメータ

一般的な原因

リクエストに無効なパラメータが含まれています。一般的な原因には、以下が含まれます。

  • がないか、空ですclientToken。

  • 1 つのリクエストに複数のタイプ ProgramTrackSettings (調整/昇格、OEM、TLE) が含まれます。リクエストごとに許可されるタイプは 1 つだけです。

  • コンタクトの地上局で方位高度エフェメリスが承認されずに null satelliteArnに設定する。

  • が null AzElProgramTrackSettingsの場合、 satelliteArnは見つかりません。

  • 指定された に関連付けられephemerisIdていない を提供するsatelliteArn。

  • 衛星には、コンタクト時間範囲の地上局からの有効な可視性ウィンドウがありません。

  • 衛星が地上局にオンボードされていないか、ミッションプロファイルに必要なライセンスがありません。

  • ミッションプロファイルには、連絡先の更新ではサポートされていないアンテナダウンリンク復調デコード設定設定が含まれています。

解決策

  1. 無効なパラメータの詳細については、レスポンスのエラーメッセージを確認してください。

  2. リクエストProgramTrackSettingsごとに のタイプを 1 つだけ指定してください。

  3. なしで方位角/上昇角度を使用する場合はsatelliteArn、アカウントが地上局でこの機能に対して承認されていることを確認します。詳細については、「方位高度エフェメリスデータを提供する」を参照してください。

  4. 参照するエフェメリスが正しい衛星に関連付けられており、接触時間範囲をカバーしていることを確認します。

ResourceLimitExceededException: 最大バージョン制限に達しました

一般的な原因

問い合わせがバージョンの最大数 (128) に達しました。UpdateContact を呼び出すたびに新しいバージョンが作成され、連絡先がこの制限を超えることはできません。

解決策

  1. この制限を増やすことはできません。さらに変更を加える必要がある場合は、問い合わせをキャンセルし、新しい問い合わせを予約します。

非同期障害コード

次の失敗コードは、 FAILED_TO_UPDATEステータスの問い合わせバージョンの failureCodesフィールドに表示されます。DescribeContactVersion を使用して、これらの詳細を取得します。failureMessage フィールドには、障害に関する追加のコンテキストが表示されます。

失敗コード 一般的な原因 解決策
INTERNAL_ERROR 更新の処理中に予期しない内部エラーが発生しました。 リクエストの再試行 問題が解決しない場合は、AWS サポート までお問い合わせください。
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 サポート チケットを開いてアクセス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. レスポンスによってversionId返された contactIdおよび を使用して DescribeContactVersion を呼び出しますUpdateContact。

  2. version.status フィールドを確認します。ステータスが の場合、更新が正常に適用されたACTIVEことを意味します。ステータスが の場合、更新が失敗したFAILED_TO_UPDATEことを意味します。

  3. ステータスが の場合FAILED_TO_UPDATE、問題の詳細について version.failureCodes および version.failureMessageフィールドを確認します。

ヒント

AWS SDKsと は、バージョンが ACTIVEまたは FAILED_TO_UPDATEステータスに達するDescribeContactVersionまで自動的にポーリングするContactUpdatedウェーター AWS Command Line Interface をサポートします。たとえば、 は aws groundstation wait contact-updated コマンド AWS Command Line Interface を提供します。独自のポーリングロジックを実装する代わりに、ウェーターを使用します。