View a markdown version of this page

Administración de configuraciones de dominio - AWS IoT Core

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.

Administración de configuraciones de dominio

En este tema se describen las operaciones clave para administrar los recursos de configuración de su dominio. También puede administrar los ciclos de vida de las configuraciones existentes mediante las siguientes API: ListDomainConfigurations, DescribeDomainConfiguration UpdateDomainConfiguration, y. DeleteDomainConfiguration

Visualización de configuraciones de dominio

Para obtener una lista paginada de todas las configuraciones de dominio que tienes Cuenta de AWS, usa la API. ListDomainConfigurations Puedes ver los detalles de una configuración de dominio concreta mediante la DescribeDomainConfiguration API. Esta API toma un único parámetro domainConfigurationName y devuelve los detalles de la configuración especificada.

Ejemplo

Actualización de configuraciones de dominio

Para actualizar el estado o el autorizador personalizado de la configuración de tu dominio, usa la UpdateDomainConfiguration API. Puede establecer el estado en ENABLED o DISABLED. Si deshabilita la configuración del dominio, los dispositivos conectados a ese dominio recibirán un error de autenticación. Actualmente no puede actualizar el certificado de servidor en la configuración de su dominio. Para cambiar el certificado de una configuración de dominio, debe eliminarlo y volver a crearlo.

Ejemplo

Eliminación de configuraciones de dominio

Antes de eliminar una configuración de dominio, usa la UpdateDomainConfiguration API para establecer el estado en. DISABLED Esto le ayuda a evitar que se elimine el punto de conexión por error. Después de deshabilitar la configuración del dominio, elimínela mediante la DeleteDomainConfiguration API. Debes colocar los dominios AWS gestionados en DISABLED estado durante 7 días antes de poder eliminarlos. Puede establecer el estado DISABLED para los dominios personalizados y, a continuación, eliminarlos inmediatamente.

Ejemplo

Tras eliminar una configuración de dominio, ya AWS IoT Core no se entregará el certificado de servidor asociado a ese dominio personalizado.

Certificados de rotación en dominios personalizados

Es posible que deba reemplazar periódicamente el certificado de servidor por un certificado actualizado. La velocidad a la que lo haga dependerá del período de validez del certificado. Si ha generado el certificado de servidor mediante AWS Gestor de certificados (ACM), puede configurar el certificado para que se renueve automáticamente. Cuando ACM renueva su certificado, lo recoge AWS IoT Core automáticamente. No tiene que realizar ninguna acción adicional. Si ha importado el certificado de servidor desde un origen diferente, puede rotarlo volviéndolo a importar a ACM. Para obtener información sobre la reimportación de certificados, consulte Volver a importar un certificado.

nota

AWS IoT Core solo recoge las actualizaciones del certificado en las siguientes condiciones.

  • El nuevo certificado tiene el mismo ARN que el anterior.

  • El nuevo certificado tiene el mismo algoritmo de firma, nombre común o nombre alternativo del asunto que el anterior.