Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Solucionar problemas con las actualizaciones de contactos fallidas
Cuando llamas a la [UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html)API, AWS Ground Station realiza una validación sincrónica de la solicitud. Si se aprueba la validación, la actualización se procesa de forma asíncrona para propagar los cambios a la región de la antena. Los errores de validación sincrónica se devuelven directamente en la respuesta HTTP. Los errores asíncronos se notifican a través de `failureCodes` los `failureMessage` campos de la versión de contacto, que se pueden consultar consultando [DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html)la versión que no se ha podido actualizar.
Para obtener más información sobre el control de versiones de contactos, consulte. [Actualice los contactos y el control de versiones de los contactos](contacts.versioning.md)
## Errores de validación sincrónica
Los siguientes errores se devuelven directamente en la respuesta HTTP cuando la [UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html)solicitud no pasa la validación.
### ResourceNotFoundException: No se ha encontrado el contacto
**Causa común**
La cuenta especificada `contactId` no existe o pertenece a otra AWS cuenta.
**Resolución**
1. Compruebe que `contactId` es correcto.
1. Confirme que está utilizando las credenciales de la AWS cuenta propietaria del contacto.
1. [ListContacts](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListContacts.html)Utilízala para buscar la correcta`contactId`.
### ConflictException: No se puede actualizar el contacto
**Causa común**
El contacto se encuentra en un estado que no permite actualizaciones. Solo se puede llamar a la [UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html)API cuando el contacto está en el `PASS` estado `SCHEDULED``PREPASS`, o. Este error también se produce si ya hay otra actualización en curso (la última versión del contacto está en ese `UPDATING` estado).
**Resolución**
1. Llama [DescribeContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContact.html)para comprobar el estado actual del contacto.
1. Si el contacto está en un estado terminal (por ejemplo,`COMPLETED`,`FAILED`, o`CANCELLED`), no se puede actualizar. Un contacto solo se puede actualizar cuando se encuentra en el `PASS` estado `SCHEDULED``PREPASS`, o. Para obtener una lista completa de los estados terminales, consulte[AWS Ground Station estados de contacto](contacts.lifecycle.md#contact-statuses).
1. Si hay otra actualización en curso, espere a que la actualización actual alcance `ACTIVE` `FAILED_TO_UPDATE` su estado antes de enviar otra actualización. Puedes sondear la [DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html)API o utilizar las cómodas utilidades de `ContactUpdated` camarero que ofrecen algunos AWS SDKs y los AWS Command Line Interface.
### InvalidParameterException: Parámetros de solicitud no válidos
**Causa común**
La solicitud contiene parámetros no válidos. Entre las causas comunes, se incluyen las siguientes:
+ Falta o está vacío`clientToken`.
+ Se incluyen varios tipos `ProgramTrackSettings` (acimut/elevación, OEM y TLE) en una sola solicitud. Solo se permite un tipo por solicitud.
+ [Se establece `satelliteArn` en nulo sin estar aprobado para las efemérides de elevación de acimut](providing-azimuth-elevation-ephemeris-data.md) en la estación terrestre del contacto.
+ Falta cuando es nulo. `AzElProgramTrackSettings` `satelliteArn`
+ Proporciona un `ephemerisId` elemento que no está asociado a lo especificado`satelliteArn`.
+ El satélite no tiene una ventana de visibilidad válida desde la estación terrestre para el intervalo de tiempo de contacto.
+ El satélite no está incorporado a la estación terrestre o no tiene la licencia requerida por el perfil de la misión.
+ El perfil de la misión incluye [Configuración de descodificación y desmodulación de enlace de bajada de antena](how-it-works.config.md#how-it-works.config-antenna-downlink-demod-decode) configuraciones, que no se admiten en las actualizaciones de contactos.
**Resolución**
1. Revisa el mensaje de error de la respuesta para obtener detalles sobre qué parámetro no es válido.
1. Asegúrese de proporcionar exactamente un tipo de `ProgramTrackSettings` por solicitud.
1. Si utilizas ángulos de azimuth/elevation puntería sin un`satelliteArn`, confirma que tu cuenta está aprobada para esta función en la estación terrestre. Para obtener más información, consulte [Proporcione datos de efemérides de elevación del acimut](providing-azimuth-elevation-ephemeris-data.md).
1. Compruebe que la efeméride a la que hace referencia esté asociada al satélite correcto y abarque el intervalo de tiempo de contacto.
### ResourceLimitExceededException: Se ha alcanzado el límite máximo de versiones
**Causa común**
El contacto ha alcanzado el número máximo de versiones (128). Cada llamada [UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html)crea una nueva versión y un contacto no puede superar este límite.
**Resolución**
1. Este límite no se puede aumentar. Si necesitas hacer más cambios, cancela el contacto y reserva uno nuevo.
## Códigos de fallo asíncronos
Los siguientes códigos de error aparecen en el `failureCodes` campo de una versión de contacto con un estado. `FAILED_TO_UPDATE` [DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html)Utilícelo para recuperar estos detalles. El `failureMessage` campo proporciona un contexto adicional sobre el error.
| Código de error | Causa habitual | Resolución |
| --- | --- | --- |
| INTERNAL\_ERROR | Se ha producido un error interno inesperado al procesar la actualización. | Vuelva a intentar la actualización. Si el problema continúa, póngase en contacto con [AWS Support](https://console.aws.amazon.com/support). |
| INVALID\_SATELLITE\_ARN | El ARN del satélite proporcionado en la solicitud de actualización no es válido o no existe. | Verifique el ARN del satélite y confirme que el satélite está registrado en su cuenta. |
| INVALID\_UPDATE\_CONTACT\_REQUEST | La solicitud de actualización contiene parámetros no válidos que no se detectaron durante la validación sincrónica. | Revise los failureMessage detalles y corrija los parámetros de la solicitud. |
| EPHEMERIS\_NOT\_FOUND | Las efemérides a las que se hace referencia en las anulaciones de seguimiento no existen. | Compruebe ephemerisId y confirme que las efemérides no se hayan eliminado. |
| EPHEMERIS\_TIME\_RANGE\_INVALID | La efeméride no cubre el intervalo de tiempo del contacto. | Sube una nueva efeméride que cubra todo el intervalo de tiempo de contacto. Si el intervalo de tiempo de las efemérides no se puede ampliar, cancela el contacto y reserva uno nuevo durante el intervalo de tiempo de las efemérides. Para obtener más información, consulte [Proporcione datos de efemérides personalizados](providing-custom-ephemeris-data.md). |
| EPHEMERIS\_NOT\_ENABLED | La efeméride a la que se hace referencia no está en ningún estado. ENABLED | Compruebe el estado de las efemérides y actívelo antes de volver a intentar la actualización. |
| SATELLITE\_DOES\_NOT\_MATCH\_EPHEMERIS | La efeméride no está asociada al satélite especificado en la solicitud de actualización. | Asegúrese de que ephemerisId pertenezca al satélite especificado en. satelliteArn |
| NOT\_ONBOARDED\_TO\_AZEL\_EPHEMERIS | Tu cuenta no está aprobada para usar [datos de efemérides de elevación acimutal en la estación](providing-azimuth-elevation-ephemeris-data.md) terrestre del contacto. Las efemérides de elevación azimutal son una función restringida que está disponible para un número limitado de casos de uso especializados. | Si su caso de uso requiere las efemérides de elevación de acimut, abra un ticket a través de ellas para solicitar el acceso. AWS Support [AWS Support Center Console](https://console.aws.amazon.com/support) Como alternativa, considere la posibilidad de utilizar datos de [efemérides TLE o datos de [efemérides OEM](providing-oem-ephemeris-data.md) si se](providing-tle-ephemeris-data.md) ajustan a su caso de uso. |
| AZEL\_EPHEMERIS\_NOT\_FOUND | Las [efemérides de elevación acimutal a las](providing-azimuth-elevation-ephemeris-data.md) que se hace referencia en la solicitud no existen. | Verifique ephemerisId y confirme que las efemérides de elevación acimutal no se hayan eliminado. |
| AZEL\_EPHEMERIS\_WRONG\_GROUND\_STATION | La [efeméride de elevación acimutal se](providing-azimuth-elevation-ephemeris-data.md) creó para una estación terrestre diferente a la utilizada por el contacto. | Cargue una nueva efeméride de elevación de acimut para la estación terrestre correcta o utilice una efeméride existente que coincida con la estación terrestre del contacto. |
| AZEL\_EPHEMERIS\_INVALID\_STATUS | La [efeméride de elevación acimutal](providing-azimuth-elevation-ephemeris-data.md) no está en un estado válido para su uso. | Compruebe el estado de las efemérides. Debe estar en un ENABLED estado. Si la efeméride no pasó la validación, sube una versión corregida. |
| AZEL\_EPHEMERIS\_TIME\_RANGE\_INVALID | Las [efemérides de elevación del acimut no cubren el intervalo](providing-azimuth-elevation-ephemeris-data.md) de tiempo del contacto. | Cargue una nueva efeméride de elevación de acimut que cubra todo el intervalo de tiempo de contacto. Si el intervalo de tiempo de las efemérides no se puede ampliar, cancela el contacto y reserva uno nuevo durante el período de tiempo de las efemérides. |
## Comprobar el estado de una actualización
Después de llamar`UpdateContact`, la nueva versión del contacto comienza en el `UPDATING` estado. Durante este tiempo, [DescribeContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContact.html)continúa devolviendo la versión previamente activa del contacto. La nueva versión no aparece `DescribeContact` hasta que se haya propagado a la antena y alcance el `ACTIVE` estado. Para comprobar el estado de una versión específica, utilice [DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html).
Para determinar si una actualización se realizó correctamente o no:
1. Llame [DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html)con el `contactId` y lo `versionId` devuelva la `UpdateContact` respuesta.
1. Comprueba el `version.status` campo. Un estado de `ACTIVE` significa que la actualización se ha aplicado correctamente. Un estado de `FAILED_TO_UPDATE` significa que la actualización ha fallado.
1. Si el estado es`FAILED_TO_UPDATE`, compruebe los `version.failureMessage` campos `version.failureCodes` y para obtener más información sobre lo que ha fallado.
**sugerencia**
Algunos AWS SDKs y otros AWS Command Line Interface admiten un `ContactUpdated` camarero que sondea automáticamente `DescribeContactVersion` hasta que la versión alcance su `ACTIVE` `FAILED_TO_UPDATE` estado. Por ejemplo, AWS Command Line Interface proporciona un comando [aws groundstation wait contact-updated](https://docs.aws.amazon.com/cli/latest/reference/groundstation/wait/contact-updated.html). Utilice el camarero en lugar de implementar su propia lógica de votación.