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 lo siguienteAPIs: ListDomainConfigurations, DescribeDomainConfigurationUpdateDomainConfiguration, y. DeleteDomainConfiguration

Visualización de configuraciones de dominio

Para obtener una lista paginada de todas las configuraciones de dominio que tiene Cuenta de AWS, utilice la. ListDomainConfigurationsAPI Puede ver los detalles de una configuración de dominio en particular mediante el DescribeDomainConfigurationAPI. APIToma un único domainConfigurationName parámetro 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 su dominio, utilice. UpdateDomainConfigurationAPI 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, utilice la UpdateDomainConfigurationAPIpara establecer el estado en. DISABLED Esto le ayuda a evitar que se elimine el punto de conexión por error. Tras deshabilitar la configuración del dominio, elimínela mediante DeleteDomainConfigurationAPI. Debe mantener los dominios AWS gestionados en DISABLED estado durante 7 días antes de poder eliminarlos. Puede colocar los dominios personalizados en DISABLED estado y, a continuación, eliminarlos de una vez.

Ejemplo

Tras eliminar una configuración de dominio, AWS IoT Core deja de servir 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 generaste tu certificado de servidor mediante AWS Certificate Manager (ACM), puedes configurar el certificado para que se renueve automáticamente. Al ACM renovar el certificado, recoge AWS IoT Core automáticamente el nuevo certificado. No tiene que realizar ninguna acción adicional. Si ha importado el certificado de servidor de una fuente diferente, puede cambiarlo importándolo de nuevo 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 de los certificados en las siguientes condiciones.

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

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