管理域配置

本主题介绍供您管理域配置资源的关键操作。您还可以使用以下 API 管理现有配置的生命周期：ListDomainConfigurations、DescribeDomainConfiguration、UpdateDomainConfiguration 和 DeleteDomainConfiguration。

查看域配置

要返回您的 AWS 账户中所有域配置的分页列表，请使用 ListDomainConfigurations API。您可以使用 DescribeDomainConfiguration API 查看特定域配置的详细信息。此 API 采用单个 domainConfigurationName 参数并返回指定配置的详细信息。

示例：

更新域配置

要更新域配置的状态或自定义授权方，请使用 UpdateDomainConfiguration API。您可以将状态设置为 ENABLED 或 DISABLED。如果您禁用域配置，连接到该域的设备将收到身份验证错误。目前，您无法更新域配置中的服务器证书。要更改域配置的证书，必须删除并重新创建该证书。

示例：

删除域配置

删除域配置之前，请使用 UpdateDomainConfiguration API 将状态设置为 DISABLED。这有助于避免意外删除端点。禁用域配置后，请使用 DeleteDomainConfiguration API 将其删除。您必须将 AWS 管理的域置于 DISABLED 状态，持续 7 天，然后才可以将其删除。您可以将自定义域置于 DISABLED 状态，然后立即将其删除。

示例：

当您删除域配置后，AWS IoT Core 不再提供与该自定义域关联的服务器证书。

在自定义域中轮换证书

您可能需要定期使用更新的证书替换服务器证书。您执行此操作的速率取决于证书的有效期。如果您使用 AWS Certificate Manager（ACM）生成服务器证书，您可以将证书设置为自动续订。当 ACM 续订您的证书时，AWS IoT Core 会自动接受新证书。您无需执行任何其它操作。如果从其它源导入服务器证书，则可以通过将其重新导入到 ACM 来轮换该证书。有关重新导入证书的信息，请参阅重新导入证书。