翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 失敗した問い合わせの更新のトラブルシューティング
[UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html) API を呼び出すと、 はリクエストに対して同期検証 AWS Ground Station を実行します。検証に合格すると、アンテナリージョンに変更を伝達するために、更新が非同期的に処理されます。同期検証エラーは HTTP レスポンスに直接返されます。非同期障害は、問い合わせバージョンの `failureCodes`および `failureMessage`フィールドを通じて報告されます。これを表示するには、更新に失敗したバージョンの [DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html) を呼び出します。
問い合わせのバージョニングの詳細については、「」を参照してください[連絡先と連絡先のバージョニングを更新する](contacts.versioning.md)。
## 同期検証エラー
[UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html) リクエストが検証に失敗すると、次のエラーが HTTP レスポンスに直接返されます。
### ResourceNotFoundException: 問い合わせが見つかりません
**一般的な原因**
指定された が存在しないか、別の AWS アカウントに属`contactId`しています。
**解決策**
1. `contactId` が正しいことを確認します。
1. 問い合わせを所有する AWS アカウントの認証情報を使用していることを確認します。
1. [ListContacts](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListContacts.html) を使用して正しい を見つけます`contactId`。
### ConflictException: 問い合わせを更新できません
**一般的な原因**
問い合わせは、更新を許可しない状態です。[UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html) API は、問い合わせが `SCHEDULED`、、`PREPASS`または `PASS`状態にある場合にのみ呼び出すことができます。このエラーは、別の更新がすでに進行中 (最新の問い合わせバージョンが `UPDATING`状態) でも発生します。
**解決策**
1. [DescribeContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContact.html) を呼び出して、現在の問い合わせステータスを確認します。
1. 問い合わせが終了状態 (、、 など`CANCELLED`) `COMPLETED`の場合`FAILED`、更新できません。コンタクトは、`SCHEDULED`、、`PREPASS`または `PASS`状態にある場合にのみ更新できます。ターミナル状態の詳細なリストについては、「」を参照してください[AWS Ground Station問い合わせステータス](contacts.lifecycle.md#contact-statuses)。
1. 別の更新が進行中の場合は、現在の更新が `ACTIVE`または `FAILED_TO_UPDATE`ステータスになるまで待ってから、別の更新を送信します。[DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html) API をポーリングするか、一部の AWS SDKs と が提供する`ContactUpdated`ウェーターコンビニエンスユーティリティを使用できます AWS Command Line Interface。
### InvalidParameterException: 無効なリクエストパラメータ
**一般的な原因**
リクエストに無効なパラメータが含まれています。一般的な原因には、以下が含まれます。
+ がないか、空です`clientToken`。
+ 1 つのリクエストに複数のタイプ `ProgramTrackSettings` (調整/昇格、OEM、TLE) が含まれます。リクエストごとに許可されるタイプは 1 つだけです。
+ コンタクトの地上局で[方位高度エフェメリス](providing-azimuth-elevation-ephemeris-data.md)が承認されずに null `satelliteArn`に設定する。
+ が null `AzElProgramTrackSettings`の場合、 `satelliteArn`は見つかりません。
+ 指定された に関連付けられ`ephemerisId`ていない を提供する`satelliteArn`。
+ 衛星には、コンタクト時間範囲の地上局からの有効な可視性ウィンドウがありません。
+ 衛星が地上局にオンボードされていないか、ミッションプロファイルに必要なライセンスがありません。
+ ミッションプロファイルには、連絡先の更新ではサポートされていない[アンテナダウンリンク復調デコード設定](how-it-works.config.md#how-it-works.config-antenna-downlink-demod-decode)設定が含まれています。
**解決策**
1. 無効なパラメータの詳細については、レスポンスのエラーメッセージを確認してください。
1. リクエスト`ProgramTrackSettings`ごとに のタイプを 1 つだけ指定してください。
1. なしで方位角/上昇角度を使用する場合は`satelliteArn`、アカウントが地上局でこの機能に対して承認されていることを確認します。詳細については、「[方位高度エフェメリスデータを提供する](providing-azimuth-elevation-ephemeris-data.md)」を参照してください。
1. 参照するエフェメリスが正しい衛星に関連付けられており、接触時間範囲をカバーしていることを確認します。
### ResourceLimitExceededException: 最大バージョン制限に達しました
**一般的な原因**
問い合わせがバージョンの最大数 (128) に達しました。[UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html) を呼び出すたびに新しいバージョンが作成され、連絡先がこの制限を超えることはできません。
**解決策**
1. この制限を増やすことはできません。さらに変更を加える必要がある場合は、問い合わせをキャンセルし、新しい問い合わせを予約します。
## 非同期障害コード
次の失敗コードは、 `FAILED_TO_UPDATE`ステータスの問い合わせバージョンの `failureCodes`フィールドに表示されます。[DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html) を使用して、これらの詳細を取得します。`failureMessage` フィールドには、障害に関する追加のコンテキストが表示されます。
| 失敗コード | 一般的な原因 | 解決策 |
| --- | --- | --- |
| INTERNAL\_ERROR | 更新の処理中に予期しない内部エラーが発生しました。 | リクエストの再試行 問題が解決しない場合は、[AWS サポート](https://console.aws.amazon.com/support) までお問い合わせください。 |
| INVALID\_SATELLITE\_ARN | 更新リクエストで指定された衛星 ARN が無効であるか、存在しません。 | 衛星 ARN を確認し、衛星がアカウントに登録されていることを確認します。 |
| INVALID\_UPDATE\_CONTACT\_REQUEST | 更新リクエストには、同期検証中に検出されなかった無効なパラメータが含まれています。 | 詳細failureMessageを確認し、リクエストパラメータを修正します。 |
| EPHEMERIS\_NOT\_FOUND | 追跡オーバーライドで参照されるエフェメリスは存在しません。 | を確認しephemerisId、エフェメリスが削除されていないことを確認します。 |
| EPHEMERIS\_TIME\_RANGE\_INVALID | エフェメリスは、問い合わせの時間範囲をカバーしません。 | 問い合わせ時間範囲全体をカバーする新しいエフェメリスをアップロードします。エフェメリス時間範囲を拡張できない場合は、問い合わせをキャンセルし、エフェメリスの期間中に新しい時間範囲を予約します。詳細については、「[カスタムエフェメリスデータを提供する](providing-custom-ephemeris-data.md)」を参照してください。 |
| EPHEMERIS\_NOT\_ENABLED | 参照されるエフェメリスは ENABLED状態ではありません。 | 更新を再試行する前に、エフェメリスのステータスを確認し、有効にします。 |
| SATELLITE\_DOES\_NOT\_MATCH\_EPHEMERIS | エフェメリスは、更新リクエストで指定された衛星に関連付けられていません。 | が で指定された衛星にephemerisId属していることを確認しますsatelliteArn。 |
| NOT\_ONBOARDED\_TO\_AZEL\_EPHEMERIS | アカウントは、問い合わせの地上局で[方位高度エフェメリスデータ](providing-azimuth-elevation-ephemeris-data.md)を使用することは承認されていません。方位高度エフェメリスは、限られた数の特殊なユースケースで使用できる制限付き機能です。 | ユースケースに方位高度エフェメリスが必要な場合は、 を通じて AWS サポート チケットを開いてアクセス[AWS Support Center Console](https://console.aws.amazon.com/support)をリクエストします。または、ユースケースに合った [TLE エフェメリスデータ](providing-tle-ephemeris-data.md)または [OEM エフェメリスデータ](providing-oem-ephemeris-data.md)を使用することを検討してください。 |
| AZEL\_EPHEMERIS\_NOT\_FOUND | リクエストで参照される[方位高度エフェメリス](providing-azimuth-elevation-ephemeris-data.md)は存在しません。 | を確認しephemerisId、方位高度エフェメリスが削除されていないことを確認します。 |
| AZEL\_EPHEMERIS\_WRONG\_GROUND\_STATION | [方位高度エフェメリス](providing-azimuth-elevation-ephemeris-data.md)は、コンタクトで使用されるものとは異なる地上局用に作成されました。 | 正しい地上局の新しい方位高度エフェメリスをアップロードするか、コンタクトの地上局に一致する既存のエフェメリスを使用します。 |
| AZEL\_EPHEMERIS\_INVALID\_STATUS | [方位高度エフェメリス](providing-azimuth-elevation-ephemeris-data.md)が有効な状態ではありません。 | エフェメリスのステータスを確認します。これは ENABLED状態である必要があります。エフェメリスの検証に失敗した場合は、修正されたバージョンをアップロードします。 |
| AZEL\_EPHEMERIS\_TIME\_RANGE\_INVALID | [方位高度エフェメリス](providing-azimuth-elevation-ephemeris-data.md)は、問い合わせの時間範囲をカバーしていません。 | コンタクト時間範囲全体をカバーする新しい方位高度エフェメリスをアップロードします。エフェメリス時間範囲を拡張できない場合は、問い合わせをキャンセルし、エフェメリスの期間中に新しい時間範囲を予約します。 |
## 更新のステータスの確認
を呼び出すと`UpdateContact`、新しい問い合わせバージョンは `UPDATING`状態で開始されます。この間、[DescribeContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContact.html) は以前にアクティブだった問い合わせのバージョンを引き続き返します。新しいバージョンは、アンテナに伝達されて`ACTIVE`ステータスに達する`DescribeContact`まで に表示されません。特定のバージョンのステータスを確認するには、[DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html) を使用します。
更新が成功したか失敗したかを確認するには:
1. レスポンスによって`versionId`返された `contactId`および を使用して [DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html) を呼び出します`UpdateContact`。
1. `version.status` フィールドを確認します。ステータスが の場合、更新が正常に適用された`ACTIVE`ことを意味します。ステータスが の場合、更新が失敗した`FAILED_TO_UPDATE`ことを意味します。
1. ステータスが の場合`FAILED_TO_UPDATE`、問題の詳細について `version.failureCodes` および `version.failureMessage`フィールドを確認します。
**ヒント**
AWS SDKsと は、バージョンが `ACTIVE`または `FAILED_TO_UPDATE`ステータスに達する`DescribeContactVersion`まで自動的にポーリングする`ContactUpdated`ウェーター AWS Command Line Interface をサポートします。たとえば、 は [aws groundstation wait contact-updated](https://docs.aws.amazon.com/cli/latest/reference/groundstation/wait/contact-updated.html) コマンド AWS Command Line Interface を提供します。独自のポーリングロジックを実装する代わりに、ウェーターを使用します。