View a markdown version of this page

Solucionar problemas con las actualizaciones de contactos fallidas - AWS Ground Station
Errores de validación sincrónicaCódigos de fallo asíncronosComprobar el estado de una actualización

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 UpdateContactAPI, 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 DescribeContactVersionla 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

Errores de validación sincrónica

Los siguientes errores se devuelven directamente en la respuesta HTTP cuando la UpdateContactsolicitud 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.

  2. Confirme que está utilizando las credenciales de la AWS cuenta propietaria del contacto.

  3. ListContactsUtilízala para buscar la correctacontactId.

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 UpdateContactAPI cuando el contacto está en el PASS estado SCHEDULEDPREPASS, 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 DescribeContactpara comprobar el estado actual del contacto.

  2. Si el contacto está en un estado terminal (por ejemplo,COMPLETED,FAILED, oCANCELLED), no se puede actualizar. Un contacto solo se puede actualizar cuando se encuentra en el PASS estado SCHEDULEDPREPASS, o. Para obtener una lista completa de los estados terminales, consulteAWS Ground Station estados de contacto.

  3. 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 DescribeContactVersionAPI 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íoclientToken.

  • 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 en la estación terrestre del contacto.

  • Falta cuando es nulo. AzElProgramTrackSettings satelliteArn

  • Proporciona un ephemerisId elemento que no está asociado a lo especificadosatelliteArn.

  • 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 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.

  2. Asegúrese de proporcionar exactamente un tipo de ProgramTrackSettings por solicitud.

  3. Si utilizas ángulos de azimuth/elevation puntería sin unsatelliteArn, 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.

  4. 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 UpdateContactcrea 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 DescribeContactVersionUtilí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.
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.
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 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 Como alternativa, considere la posibilidad de utilizar datos de efemérides TLE o datos de efemérides OEM si se ajustan a su caso de uso.
AZEL_EPHEMERIS_NOT_FOUND Las efemérides de elevación acimutal a las 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 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 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 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 llamarUpdateContact, la nueva versión del contacto comienza en el UPDATING estado. Durante este tiempo, DescribeContactcontinú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.

Para determinar si una actualización se realizó correctamente o no:

  1. Llame DescribeContactVersioncon el contactId y lo versionId devuelva la UpdateContact respuesta.

  2. 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.

  3. Si el estado esFAILED_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. Utilice el camarero en lugar de implementar su propia lógica de votación.