本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 开始使用 AWS IoT SiteWise Monitor （经典）
**注意**
新客户不再可以使用 SiteWise 监控功能。现有客户可以继续正常使用该服务。有关更多信息，请参阅[SiteWise 监控器可用性更改](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html)。
如果您是组织的 AWS 管理员，则可以通过 AWS IoT SiteWise 控制台创建门户。完成以下步骤以创建门户，以便您的组织成员可以查看您的 AWS IoT SiteWise 数据：
1. 配置和创建门户
1. 添加门户管理员并发送邀请电子邮件
1. 添加门户用户
创建门户后，门户管理员可以查看您的 AWS IoT SiteWise 资产并将其分配给门户中的项目。然后，项目拥有者可以创建控制面板来显示资产的属性，以帮助项目查看者了解设备、流程和装置的运行情况。
**注意**
向门户添加用户或管理员时，请避免创建限制用户权限 AWS Identity and Access Management （例如受限 IP）的 (IAM) 策略。任何具有受限权限的附加策略都将无法连接到 AWS IoT SiteWise 门户。
您可以按照教程的说明，逐步设置具有项目、控制面板和多个用户的门户，用于使用风电场数据的特定场景。有关更多信息，请参阅 [在 Monito SiteWise r 中可视化和共享风电场数据](monitor-wind-farm.md)。
**Topics**
+ [在 Monito SiteWise r 中创建入口](monitor-create-portal.md)
+ [在 Monito SiteWise r 中配置您的门户](monitor-configure-portal.md)
+ [在 SiteWise 监控器中邀请管理员](monitor-invite-administrators.md)
+ [在 SiteWise 监控器中添加门户用户](monitor-add-portal-users.md)
+ [创建 AWS IoT SiteWise 仪表板 (AWS CLI)](create-dashboards-using-aws-cli.md)
+ [在中为你的传送门开启警报 AWS IoT SiteWise](monitor-enable-alarms.md)
+ [在边缘启用您的 AWS IoT SiteWise 门户](monitor-enable-edge.md)
+ [管理您的 SiteWise 监控器门户](administer-portals.md)
# 在 Monito SiteWise r 中创建入口
**注意**
新客户不再可以使用 SiteWise 监控功能。现有客户可以继续正常使用该服务。有关更多信息，请参阅[SiteWise 监控器可用性更改](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html)。
您可以在 AWS IoT SiteWise 控制台中创建 SiteWise 监控器门户。
**创建门户**
1. 登录 [AWS IoT SiteWise 控制台](https://console.aws.amazon.com/iotsitewise/)。
1. 在导航窗格中，选择 **监控**、**入门**。
![\[带有 “入门” 的 AWS IoT SiteWise 控制台左侧导航窗格突出显示。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/sitewise-choose-monitor-getting-started-console.png)
1. 选择 **创建门户**。
![\[“ AWS IoT SiteWise Monitor 入门” 页面突出显示了 “创建门户”。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/sitewise-choose-create-portal-console.png)
接下来，您必须提供一些基本信息来配置门户。
# 在 Monito SiteWise r 中配置您的门户
**注意**
新客户不再可以使用 SiteWise 监控功能。现有客户可以继续正常使用该服务。有关更多信息，请参阅[SiteWise 监控器可用性更改](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html)。
用户使用门户查看您的数据。您可以自定义门户的名称、描述、品牌、用户验证、支持联系人电子邮件和权限。
![\[用于创建门户的“门户配置”页面。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/PortalConfiguration.png)
**配置门户**
1. 输入门户的名称。
1. （可选）输入门户的描述。如果您有多个门户，请使用有意义的描述来帮助您跟踪每个门户包含的内容。
1. （可选）上传图片以在门户中显示您的品牌。选择一个正方形 PNG 图片。如果上传非方形图片，门户会将图片缩减为正方形。
1. 请选择以下选项之一：
+ 如果您的门户用户使用其公司用户名和密码登录此门户，请选择 **IAM Identity Center**。
如果您尚未在账户中启用 IAM Identity Center，请执行以下操作：
1. 选择**创建用户**。
1. 在 **创建用户**页面上，要创建第一个门户，请输入用户的电子邮件地址、名字和姓氏，然后选择**创建用户**。
![\[如果您尚未在 AWS 账户中启用 IAM 身份中心，请启用 IAM 身份中心。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/SSOUserCreation.png)
**注意**
AWS 当您创建第一个门户网站用户时，会自动在您的账户中启用 IAM 身份中心。
您一次只能在一个区域配置 IAM Identity Center。 SiteWise Monitor 连接到您为 IAM 身份中心配置的区域。这意味着您可以使用一个区域访问 IAM Identity Center，但可以在任何区域创建门户。
+ 如果您的门户用户使用其 IAM 凭证登录此门户，请选择 **IAM**。
**重要**
用户或角色必须具有登录门户的 `iotsitewise:DescribePortal` 权限。
1. 输入门户用户在遇到门户问题需要帮助时可以联系的电子邮件地址。
1. （可选）为门户添加标签。有关更多信息，请参阅 [标记您的 AWS IoT SiteWise 资源](tag-resources.md)。
1. 请选择以下选项之一：
+ 请选择**创建和使用新的服务角色**。默认情况下，M SiteWise onitor 会自动为每个门户创建一个服务角色。此角色允许您的门户用户访问您的 AWS IoT SiteWise 资源。有关更多信息，请参阅 [将服务角色用于 AWS IoT SiteWise Monitor](monitor-service-role.md)。
+ 选择**使用现有服务角色**，然后选择目标角色。
1. 选择 **下一步**。
1. 或者，为您的门户启用警报。有关更多信息，请参阅 [在中为你的传送门开启警报 AWS IoT SiteWise](monitor-enable-alarms.md)。
1. 选择 “**创建**”。 AWS IoT SiteWise 将创建您的门户。
**注意**
如果关闭控制台，您可以通过添加管理员和用户来完成设置过程。有关更多信息，请参阅 [在中添加或移除门户管理员 AWS IoT SiteWise](portal-change-admins.md)。如果您不想保留此门户，请将其删除，以免使用资源。有关更多信息，请参阅 [删除中的传送门 AWS IoT SiteWise](portal-delete-portal.md)。
**状态**列可以是以下值之一。
+ **正在创建**- AWS IoT SiteWise 正在处理您创建门户的请求。此过程可能需要几分钟才能完成。
+ **更新**- AWS IoT SiteWise 正在处理您更新门户的请求。此过程可能需要几分钟才能完成。
+ **待处理**- AWS IoT SiteWise 正在等待 DNS 记录传播完成。此过程可能需要几分钟完成。当门户的状态为 **PENDING** 时，您可以将其删除。
+ **正在删除**- AWS IoT SiteWise 正在处理您删除门户的请求。此过程可能需要几分钟才能完成。
+ **ACTIVE** ‐ 当门户变为活动状态时，您的门户用户可以访问它。
+ **失败**- AWS IoT SiteWise 无法处理您创建、更新或删除门户的请求。如果您启用 AWS IoT SiteWise 向 Amazon Logs 发送 CloudWatch 日志，则可以使用这些日志来解决问题。有关更多信息，请参阅[AWS IoT SiteWise 使用 CloudWatch 日志进行监控](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/monitor-cloudwatch-logs.html)。
门户创建时将显示一条消息。
![\[成功创建门户消息示例。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/sitewise-create-portal-success-console.png)
接下来，您必须为门户邀请一个或多个门户管理员。到目前为止，您创建了一个门户，但没有人可以访问它。
# 在 SiteWise 监控器中邀请管理员
要开始使用新门户，您必须分配门户管理员。门户管理员创建项目、选择项目拥有者并将资产分配给项目。门户管理员可以查看您的所有资 AWS IoT SiteWise 产。
根据用户身份验证服务，请选择以下选项之一：
------
#### [ IAM Identity Center ]
如果您是首次使用 M SiteWise onitor，则可以选择之前创建的用户作为门户管理员。如果您想添加其他用户作为门户管理员，可以从此页面创建 IAM Identity Center 用户。或者，您可以将外部身份提供商连接到 IAM Identity Center。有关更多信息，请参阅 [AWS IAM Identity Center 《用户指南》](https://docs.aws.amazon.com/singlesignon/latest/userguide/)。
**邀请管理员**
1. 选中您希望作为门户管理员的用户对应的复选框。这会将用户添加到**门户管理员**列表中。
**注意**
如果您使用 IAM Identity Center 作为身份存储，并且已登录 AWS Organizations 管理账户，则可以选择**创建用户**来创建 IAM Identity Center 用户。IAM Identity Center 会向新用户发送一封电子邮件，让他们设置密码。然后，您可以将该用户作为管理员分配到门户。有关更多信息，请参阅[管理 IAM Identity Center 中的身份](https://docs.aws.amazon.com/singlesignon/latest/userguide/manage-your-identity-source-sso.html)。
1. （可选）选择 **向选定用户发送邀请**。您的电子邮件客户端将打开，邮件正文中将填充邀请内容。
在将电子邮件发送给门户管理员之前您可以对其进行自定义。您也可以稍后再向门户管理员发送电子邮件。如果您是第一次尝试 M SiteWise onitor，并添加新的 IAM 身份中心或 IAM 用户或角色作为门户管理员，则无需给自己发送电子邮件。
1. 如果您添加了不希望其作为管理员的用户，请清除该用户对应的复选框。
1. 邀请门户管理员步骤完成后，选择 **下一步**。
------
#### [ IAM ]
您可以选择用户或角色作为门户管理员。如果您想添加其他用户或角色作为门户管理员，可以在 IAM 控制台中创建用户或角色。有关更多信息，请参阅 *IAM 用户指南*中的[在您的 AWS 账户中创建 IAM 用户](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html)和[创建 IAM 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html)。
**邀请管理员**
1. 执行以下操作：
+ 选择 **IAM 用户**以添加一个 IAM 用户作为您的门户管理员。
+ 选择 **IAM 角色**以将 IAM 角色添加为门户管理员。
1. 选中您希望作为门户管理员的用户或角色对应的复选框。这会将用户或角色添加到**门户管理员**列表中。
1. 如果您添加了不希望其作为管理员的用户或角色，请清除该用户或角色对应的复选框。
1. 邀请门户管理员步骤完成后，选择 **下一步**。
**重要**
用户或角色必须具有登录门户的 `iotsitewise:DescribePortal` 权限。
**注意**
如果您使用 IAM Identity Center 作为身份存储，并且已登录 AWS Organizations 管理账户，则可以选择**创建用户**来创建 IAM Identity Center 用户。IAM Identity Center 会向新用户发送一封电子邮件，让他们设置密码。然后，您可以将该用户作为管理员分配到门户。有关更多信息，请参阅[管理 IAM Identity Center 中的身份](https://docs.aws.amazon.com/singlesignon/latest/userguide/manage-your-identity-source-sso.html)。
------
您可以在以后更改门户管理员列表。有关更多信息，请参阅 [在中添加或移除门户管理员 AWS IoT SiteWise](portal-change-admins.md)。
**注意**
由于只有门户管理员可以创建项目并将资产分配给项目，因此在您指定至少一个门户管理员之前，门户的用途非常有限。
在最后一步中，您添加可以访问新门户的用户。
# 在 SiteWise 监控器中添加门户用户
**注意**
新客户不再可以使用 SiteWise 监控功能。现有客户可以继续正常使用该服务。有关更多信息，请参阅[SiteWise 监控器可用性更改](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html)。
您控制哪些用户可以访问您的门户。在每个门户中，门户管理员创建一个或多个项目，并分配门户用户作为每个项目的拥有者或查看者。每个项目的拥有者可以邀请其他门户用户来拥有或查看项目。
根据用户身份验证服务，请选择以下选项之一：
------
#### [ IAM Identity Center ]
如果您要在**用户**列表中添加用户，请完成以下步骤。
**添加门户用户**
1. 从**用户**列表中选择要添加到门户的用户。这会将用户添加到**门户用户**列表中。如果您是首次使用 M SiteWise onitor，则无需将门户管理员添加为门户用户。
**注意**
如果您使用 IAM Identity Center 作为身份存储，并且已登录 AWS Organizations 管理账户，则可以选择**创建用户**来创建 IAM Identity Center 用户。IAM Identity Center 会向新用户发送一封电子邮件，让他们设置密码。然后，您可以将用户作为用户分配给门户。有关更多信息，请参阅[管理 IAM Identity Center 中的身份](https://docs.aws.amazon.com/singlesignon/latest/userguide/manage-your-identity-source-sso.html)。
1. 如果您添加了不希望其访问门户的用户，请清除该用户对应的复选框。
1. 选择完用户后，选择**分配用户**。
![\[门户创建流程的分配 IAM Identity Center 用户步骤。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/SSOUserAssign.png)
------
#### [ IAM ]
如果您看到要在 **IAM 用户**或 **IAM 角色**列表中添加的用户或角色，请完成以下步骤。
**添加门户用户**
1. 执行以下操作：
+ 选择 **IAM 用户**以将 IAM 用户添加为门户用户。
+ 选择 **IAM 角色**以将 IAM 角色添加为门户用户。
如果您是首次使用 M SiteWise onitor，则无需将门户管理员添加为门户用户。
1. 选中要作为门户用户的用户或角色所对应的复选框。这会将用户或角色添加到**门户用户**列表中。
1. 如果您添加了不希望其访问门户的用户，请清除该用户对应的复选框。
1. 选择完用户后，选择**分配用户**。
**重要**
用户或角色必须具有登录门户的 `iotsitewise:DescribePortal` 权限。
![\[门户创建流程的分配 IAM 用户步骤。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/IAMUserAssign.png)
![\[门户创建流程的分配 IAM 步骤。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/IAMRoleAssign.png)
------
恭喜您！您已成功创建门户、分配门户管理员并分配在收到邀请时可以使用该门户的用户。门户管理员现在可以创建项目并将资产添加到这些项目。然后，项目拥有者可以创建控制面板来可视化各个项目资产的数据。
您可以在以后更改门户用户列表。有关更多信息，请参阅 [在中添加或移除门户用户 AWS IoT SiteWise](portal-change-users.md)。
如果需要对门户进行更改，请参阅[管理您的 SiteWise 监控器门户](administer-portals.md)。
要开始使用门户，请参阅《*SiteWise 监控器应用程序指南*》中的[入门](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/getting-started.html)。
# 创建 AWS IoT SiteWise 仪表板 (AWS CLI)
**注意**
新客户不再可以使用 SiteWise 监控功能。现有客户可以继续正常使用该服务。有关更多信息，请参阅[SiteWise 监控器可用性更改](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html)。
使用在仪表板中定义可视化（或微件）时 AWS CLI，必须在 `dashboardDefinition` JSON 文档中指定以下信息。此定义是[CreateDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateDashboard.html)和[UpdateDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateDashboard.html)操作的参数。
`widgets`
小部件定义结构的列表，其中每个结构均包含以下信息：
`type`
控件的类型。 AWS IoT SiteWise 提供以下控件类型：
+ `sc-line-chart` – 折线图。有关更多信息，请参阅 *AWS IoT SiteWise Monitor 应用指南*中的[折线图](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#line-charts)。
+ `sc-scatter-chart` – 散点图。有关更多信息，请参阅*AWS IoT SiteWise Monitor 应用程序指南*中的[散点图](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#scatter-charts)。
+ `sc-bar-chart` – 条形图。有关更多信息，请参阅*AWS IoT SiteWise Monitor 应用指南*中的[条形图](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#bar-charts)。
+ `sc-status-grid` – 一个状态控件，以网格形式显示资产属性的最新值。有关更多信息，请参阅*AWS IoT SiteWise Monitor 应用程序指南中的*[状态控件](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#status-widgets)。
+ `sc-status-timeline` – 一个状态控件，以时间轴的形式显示资产属性的历史值。有关更多信息，请参阅*AWS IoT SiteWise Monitor 应用程序指南中的*[状态控件](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#status-widgets)。
+ `sc-kpi` – 关键绩效指标 (KPI) 可视化。有关更多信息，请参阅*AWS IoT SiteWise Monitor 应用指南*中的 [KPI 控件](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#kpi-charts)。
+ `sc-table` – 表格控件。有关更多信息，请参阅*AWS IoT SiteWise Monitor 应用指南*中的[表格控件](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#table-widgets)。
`title`
小部件的标题。
`x`
小部件的水平位置，从网格的左侧开始。此值表示小部件在控制面板网格中的位置。
`y`
小部件的垂直位置，从网格的顶部开始。此值表示小部件在控制面板网格中的位置。
`width`
小部件的宽度，用控制面板网格上的空格数表示。
`height`
小部件的高度，用控制面板网格上的空格数表示。
`metrics`
指标结构的列表，其中每个结构均为此小部件定义一个数据流。此列表中的每个结构都必须包含以下信息：
`label`
要为此指标显示的标签。
`type`
该指标的数据源类型。 AWS IoT SiteWise 提供以下指标类型：
+ `iotsitewise` – 控制面板提取 AWS IoT SiteWise中的资产属性的数据。如果选择此选项，则必须为此指标定义 `assetId` 和 `propertyId`。
`assetId`
（可选） AWS IoT SiteWise中的资产的 ID。
如果您在该指标中为 `type` 选择 `iotsitewise`，则此字段是必填字段。
`propertyId`
（可选） AWS IoT SiteWise中的资产属性的 ID。
如果您在该指标中为 `type` 选择 `iotsitewise`，则此字段是必填字段。
`analysis`
或者，一种结构，用于定义要为小组件显示的分析（例如趋势线）。有关更多信息，请参阅*AWS IoT SiteWise Monitor 应用指南*中的[配置趋势线](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/configure-trend-lines.html)。您可以在小组件中为每个属性添加每种类型的趋势线。分析结构包含以下信息：
`trends`
或者，趋势结构列表，每个趋势结构都为该小组件定义了趋势分析。此列表中的每个结构包含以下信息：
`type`
趋势线的类型。选择以下选项：
+ `linear-regression`— 显示线性回归线。 SiteWise Monitor 使用[最小二乘](https://en.wikipedia.org/wiki/Least_squares)法计算线性回归。
`annotations`
或者，定义小组件阈值的注释结构。有关更多信息，请参阅 *版本指南中的AWS IoT SiteWise Monitor * [配置阈值](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/configure-thresholds.html)。每个控件可以添加最多 6 个注释。注释结构包含以下信息：
`y`
或者，注释结构列表，每个注释结构都定义了此小组件的水平阈值。此列表中的每个结构包含以下信息：
`comparisonOperator`
阈值的比较运算符。选择下列选项之一：
+ `LT` – 突出显示至少有一个数据点小于 `value` 的属性。
+ `GT` – 突出显示至少有一个数据点大于 `value` 的属性。
+ `LTE` – 突出显示至少有一个数据点小于或等于 `value` 的属性。
+ `GTE` – 突出显示至少有一个数据点大于或等于 `value` 的属性。
+ `EQ` – 突出显示至少有一个数据点等于 `value` 的属性。
`value`
用于将数据点与 `comparisonOperator` 进行比较的阈值。
`color`
（可选）阈值颜色的 6 位十六进制代码。对于至少有一个数据点符合阈值规则的属性，可视化效果会以这种颜色显示属性图例。默认值为黑色（`#000000`）。
`showValue`
或者，是否在控件的边距中显示阈值的值。默认值为 `true`。
`properties`
（可选）小部件属性的平面字典。该结构的成员取决于上下文。 AWS IoT SiteWise 提供了以下使用的小部件`properties`：
+ [折线图](#monitor-line-chart)、[散点图](#monitor-scatter-chart)和[条形图](#monitor-bar-chart)具有以下属性：
`colorDataAcrossThresholds`
或者，是否更改此小组件中跨越阈值的数据的颜色。启用此选项后，超过阈值的数据将以您选择的颜色显示。默认值为 `true`。
+ [状态网格](#monitor-status-grid)具有以下属性：
`labels`
或者，一种结构，用于定义要在状态网格上显示的标签。标签结构包含以下信息：
`showValue`
或者，是否在此小组件中显示每个资产属性的单位和值。默认值为 `true`。
**Example 示例控制面板定义**
以下示例从存储在 JSON 文件中的负载定义控制面板。
```
aws iotsitewise create-dashboard \
--project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE \
--dashboard-name "Wind Farm Dashboard" \
--dashboard-definition file://dashboard-definition.json
```
针对 `dashboard-definition.json` 的以下 JSON 示例定义具有以下可视化小部件的控制面板：
+ 控制面板左上角的直观显示风电场总功率的折线图。该折线图包括一个阈值，该阈值指示风电场何时输出功率少于其最低预期输出。该折线图还包括一条线性回归趋势线。
+ 控制面板右上角的直观显示四个涡轮机的风速的折线图。
此示例表示控制面板上的折线图和条形图可视化效果。此控制面板与[示例风电场控制面板](monitor-data.md)类似。
```
{
"widgets": [
{
"type": "sc-line-chart",
"title": "Total Average Power",
"x": 0,
"y": 0,
"height": 3,
"width": 3,
"metrics": [
{
"label": "Power",
"type": "iotsitewise",
"assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
"analysis": {
"trends": [
{
"type": "linear-regression"
}
]
}
}
],
"annotations": {
"y": [
{
"comparisonOperator": "LT",
"value": 20000,
"color": "#D13212",
"showValue": true
}
]
}
},
{
"type": "sc-bar-chart",
"title": "Wind Speed",
"x": 3,
"y": 3,
"height": 3,
"width": 3,
"metrics": [
{
"label": "Turbine 1",
"type": "iotsitewise",
"assetId": "a1b2c3d4-5678-90ab-cdef-2a2a2EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE"
},
{
"label": "Turbine 2",
"type": "iotsitewise",
"assetId": "a1b2c3d4-5678-90ab-cdef-2b2b2EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE"
},
{
"label": "Turbine 3",
"type": "iotsitewise",
"assetId": "a1b2c3d4-5678-90ab-cdef-2c2c2EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE"
},
{
"label": "Turbine 4",
"type": "iotsitewise",
"assetId": "a1b2c3d4-5678-90ab-cdef-2d2d2EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE"
}
]
}
]
}
```
# 在中为你的传送门开启警报 AWS IoT SiteWise
**注意**
新客户不再可以使用 SiteWise 监控功能。现有客户可以继续正常使用该服务。有关更多信息，请参阅[SiteWise 监控器可用性更改](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html)。
**注意**
终止支持通知： AWS 已终止对的支持 AWS IoT Events。有关更多信息，请参阅[AWS IoT Events 终止支持](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-end-of-support.html)。
您可以 AWS IoT Events 为门户启用支持的警报功能，以便门户管理员可以在您的 SiteWise 监控器入口中创建、编辑和删除 AWS IoT Events 警报模型。项目所有者可以配置警报。项目查看者可以查看警报详情。本节介绍如何使用 AWS IoT SiteWise 控制台为门户启用警报功能。
**重要**
您无法在门户中创建外部警报。
如果要发送警报通知，则必须为用户身份验证服务选择 IAM Identity Center。
警报通知功能在中国（北京 AWS 区域）不可用。
配置和创建门户时，可以在**步骤 2 其他功能**中启用警报和警报通知。根据用户身份验证服务，请选择以下选项之一：
------
#### [ IAM Identity Center ]
![\[用于为门户启用警报的其他功能页面。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/portal-create-console-enable-alarms-sso.png)
**为入口启用警报**
1. 或者，选择**启用警报**。
1. 对于 **AWS IoT SiteWise 访问角色**，请使用现有角色或创建具有所需权限的角色。此角色需要 `iotevents:BatchPutMessage` 权限和信任关系，以允许 `iot.amazonaws.com` 和 `iotevents.amazonaws.com` 代入该角色。
1. 或者，选择**启用警报通知**。
1. 对于 **发送人**，请选择发送人。
**重要**
您必须在 Amazon SES 中验证发送人的电子邮件地址。有关更多信息，请参阅 *Amazon Simple Email Service 开发人员指南* 中的 [在 Amazon SES 中验证电子邮件地址](https://docs.aws.amazon.com/ses/latest/dg/verify-addresses-and-domains.html)。
1. 对于 **AWS Lambda 角色**，请使用现有角色或创建具有所需权限的角色。此角色需要 `lambda:InvokeFunction` 和 `sso-directory:DescribeUser` 权限以及允许 `iotevents.amazonaws.com` 和 `lambda.amazonaws.com` 代入该角色的信任关系。
1. 对于 **AWS Lambda 函数**，请选择现有 Lambda 函数或或创建用于管理警报通知的函数。有关详细信息，请参阅 *AWS IoT Events 开发人员指南* 中的 [管理警报通知](https://docs.aws.amazon.com/iotevents/latest/developerguide/lambda-support.html)。
------
#### [ IAM ]
![\[用于为门户启用警报的其他功能页面。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/portal-create-console-enable-alarms-iam.png)
**为入口启用警报**
+ 或者，选择**启用警报**。
1. 对于 **AWS IoT SiteWise 访问角色**，请使用现有角色或创建具有所需权限的角色。此角色需要 `iotevents:BatchPutMessage` 权限和信任关系，以允许 `iot.amazonaws.com` 和 `iotevents.amazonaws.com` 代入该角色。
------
有关 Monito SiteWise r 中警报的更多信息，请参阅《*AWS IoT SiteWise 应用指南》*中的 “[使用警报进行监控](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/monitor-alarms.html)”。
# 在边缘启用您的 AWS IoT SiteWise 门户
**注意**
新客户不再可以使用 SiteWise 监控功能。现有客户可以继续正常使用该服务。有关更多信息，请参阅[SiteWise 监控器可用性更改](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html)。
在边缘启用门户后，在您的账户中启用了数据处理包的所有 SiteWise Edge 网关上均可使用此门户。
**在边缘启用传送门**
1. 在**边缘配置**部分，开启**在边缘启用此门户**。
1. 选择**创建**。
# 管理您的 SiteWise 监控器门户
**注意**
新客户不再可以使用 SiteWise 监控功能。现有客户可以继续正常使用该服务。有关更多信息，请参阅[SiteWise 监控器可用性更改](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html)。
您可以管理和配置门户的各个方面，包括添加和删除用户或管理员、设置用户权限和角色、自定义门户的 URL 和名称、设置支持联系信息以及向门户管理员发送电子邮件邀请。
1. 登录 [AWS IoT SiteWise 控制台](https://console.aws.amazon.com/iotsitewise/home)。
1. 在导航窗格中，选择 **监控**、**门户**。
![\[AWS IoT SiteWise 控制台的左侧导航窗格中突出显示了 P or tals。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/sitewise-choose-portals-console.png)
1. 选择门户，然后选择 **查看详细信息**（或选择门户的 **名称**）。
1. 您可以执行以下任一管理任务：
+ [在中更改门户详细信息 AWS IoT SiteWise](portal-change-details.md)
+ [在中添加或移除门户管理员 AWS IoT SiteWise](portal-change-admins.md)
+ [向门户管理员发送电子邮件邀请](send-email-invitations-to-portal.md)
+ [在中添加或移除门户用户 AWS IoT SiteWise](portal-change-users.md)
+ [删除中的传送门 AWS IoT SiteWise](portal-delete-portal.md)
有关如何创建门户的信息，请参阅[开始使用 AWS IoT SiteWise Monitor （经典）](monitor-getting-started.md)。
**Topics**
+ [在中更改门户详细信息 AWS IoT SiteWise](portal-change-details.md)
+ [在中添加或移除门户管理员 AWS IoT SiteWise](portal-change-admins.md)
+ [向门户管理员发送电子邮件邀请](send-email-invitations-to-portal.md)
+ [在中添加或移除门户用户 AWS IoT SiteWise](portal-change-users.md)
+ [删除中的传送门 AWS IoT SiteWise](portal-delete-portal.md)
# 在中更改门户详细信息 AWS IoT SiteWise
**注意**
新客户不再可以使用 SiteWise 监控功能。现有客户可以继续正常使用该服务。有关更多信息，请参阅[SiteWise 监控器可用性更改](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html)。
您可以更改门户的名称、描述、品牌、支持电子邮件和权限。
1. 在门户详细信息页面的**门户详细信息**部分，选择 **编辑**。
![\[突出显示编辑的门户详细信息页面的门户详细信息部分。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/sitewise-view-portal-details-console.png)
1. 更新 **名称**、**描述**、**门户品牌**、**支持联系人电子邮件** 或 **权限**。
1. 完成后，选择 **保存**。
# 在中添加或移除门户管理员 AWS IoT SiteWise
**注意**
新客户不再可以使用 SiteWise 监控功能。现有客户可以继续正常使用该服务。有关更多信息，请参阅[SiteWise 监控器可用性更改](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html)。
通过几个步骤，您可以添加或删除作为门户管理员的用户。根据用户身份验证服务，请选择以下选项之一。
------
#### [ IAM Identity Center ]
![\[门户详细信息页面的“门户管理员”部分。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/SSOAdminDetail.png)
**添加门户管理员**
1. 在门户详细信息页面的**门户管理员**部分，选择**分配管理员**。
1. 在**分配管理员**页面上，选中作为管理员添加到门户的用户对应的复选框。
**注意**
如果您使用 IAM Identity Center 作为身份存储，并且已登录 AWS Organizations 管理账户，则可以选择**创建用户**来创建 IAM Identity Center 用户。IAM Identity Center 会向新用户发送一封电子邮件，让他们设置密码。然后，您可以将该用户作为管理员分配到门户。有关更多信息，请参阅[管理 IAM Identity Center 中的身份](https://docs.aws.amazon.com/singlesignon/latest/userguide/manage-your-identity-source-sso.html)。
1. 选择**分配管理员**。
![\[“Assign administrators (分配管理员)”页面。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/SSOAdminAssign.png)
**删除门户管理员**
+ 在门户详细信息页面的 **门户管理员** 部分，选中要删除的各个用户的复选框，然后选择 **从门户中删除**。
**注意**
我们建议您至少选择一名门户管理员。
------
#### [ IAM ]
![\[门户详细信息页面的“门户管理员”部分。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/IAMAdminDetail.png)
**添加门户管理员**
1. 在门户详细信息页面的**门户管理员**部分，选择**分配管理员**。
1. 在**分配管理员**页面上，执行以下操作：
+ 如果您想添加**IAM 用户**作为门户管理员，请选择 IAM 用户。
+ 如果您想以门户管理员身份添加 IAM 角色，请选择 **IAM 角色**。
1. 选中您希望作为门户管理员的用户或角色对应的复选框。这会将用户或角色添加到**门户管理员**列表中。
1. 选择**分配管理员**。
**重要**
用户或角色必须具有登录门户的 `iotsitewise:DescribePortal` 权限。
![\[“Assign administrators (分配管理员)”页面。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/IAMUserAdminAssign.png)
![\[“Assign administrators (分配管理员)”页面。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/IAMRoleAdminAssign.png)
**删除门户管理员**
+ 在门户详细信息页面的 **门户管理员** 部分，选中要删除的各个用户的复选框，然后选择 **从门户中删除**。
**注意**
不建议不为门户添加管理员。
------
# 向门户管理员发送电子邮件邀请
**注意**
新客户不再可以使用 SiteWise 监控功能。现有客户可以继续正常使用该服务。有关更多信息，请参阅[SiteWise 监控器可用性更改](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html)。
向门户管理员发送电子邮件邀请。
1. 在门户详细信息页面的 **门户管理员** 部分，选中门户管理员对应的复选框。
![\[门户详细信息页面的门户管理员部分，突出显示了“Send invitations (发送邀请)”。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/sitewise-select-portal-administrator-console.png)
1. 选择 **发送邀请**。您的电子邮件客户端将打开，邮件正文中将填充邀请内容。
在将电子邮件发送给门户管理员之前您可以对其进行自定义。
# 在中添加或移除门户用户 AWS IoT SiteWise
**注意**
新客户不再可以使用 SiteWise 监控功能。现有客户可以继续正常使用该服务。有关更多信息，请参阅[SiteWise 监控器可用性更改](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html)。
您选择哪些用户可以访问您的门户。门户用户显示在 Monito SiteWise r 门户中的用户列表中。从此列表，门户管理员可以添加项目拥有者，而项目拥有者可以添加项目查看者。
**注意**
如果您的门户管理员和门户用户需要添加或删除用户，可能会通过门户的支持电子邮件与您联系。
根据用户身份验证服务，请选择以下选项之一。
------
#### [ IAM Identity Center ]
![\[门户详细信息页面的“门户管理员”部分。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/SSOUserDetail.png)
**添加门户用户**
1. 在门户详细信息页面的 **门户用户** 部分，选择 **分配用户**。
1. 在**分配用户**页面上，选中要添加到门户的用户的复选框。
**注意**
如果您使用 IAM Identity Center 作为身份存储，并且已登录 AWS Organizations 管理账户，则可以选择**创建用户**来创建 IAM Identity Center 用户。IAM Identity Center 会向新用户发送一封电子邮件，让他们设置密码。然后，您可以将用户作为用户分配给门户。有关更多信息，请参阅[管理 IAM Identity Center 中的身份](https://docs.aws.amazon.com/singlesignon/latest/userguide/manage-your-identity-source-sso.html)。
1. 选择 **分配用户**。
![\[“Assign Users (分配用户)”页面。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/SSOUserAssign2.png)
**删除门户用户**
+ 在门户详细信息页面的**门户用户**部分，选中要从门户中删除的用户对应的复选框，然后选择**从门户中删除**。
------
#### [ IAM ]
![\[门户详细信息页面的“门户管理员”部分。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/IAMRoleUserDetail.png)
**添加门户用户**
1. 在门户详细信息页面的 **门户用户** 部分，选择 **分配用户**。
1. 在**分配用户**页面上，执行以下操作：
+ 选择 **IAM 用户**以将 IAM 用户添加为您的门户用户。
+ 选择 **IAM 角色**以将 IAM 角色添加为您的门户用户。
1. 选中您希望作为门户用户添加的用户或角色对应的复选框。这会将用户或角色添加到**门户用户**列表中。
1. 选择 **分配用户**。
![\[“Assign Users (分配用户)”页面。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/IAMUserAssign2.png)
![\[“Assign Users (分配用户)”页面。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/IAMRoleAssign2.png)
**删除门户用户**
+ 在门户详细信息页面的**门户用户**部分，选中要从门户中删除的用户对应的复选框，然后选择**从门户中删除**。
**重要**
用户或角色必须具有登录门户的 `iotsitewise:DescribePortal` 权限。
------
# 删除中的传送门 AWS IoT SiteWise
**注意**
新客户不再可以使用 SiteWise 监控功能。现有客户可以继续正常使用该服务。有关更多信息，请参阅[SiteWise 监控器可用性更改](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html)。
如果您是出于测试目的创建门户，或者您重复创建了已经创建的门户，您可以删除该门户。
**注意**
您必须先手动删除门户中的所有控制面板和项目，然后才能删除门户。有关更多信息，请参阅《*SiteWise 监控器应用程序指南》*中的[删除项目](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/delete-projects.html)[和删除仪表板](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/delete-dashboards.html)。
1. 在门户详细信息页面上，选择 **删除**。
**重要**
删除门户时，您将丢失门户包含的所有项目以及每个项目中的所有控制面板。此操作无法撤消。您的资产数据不受影响。
![\[突出显示删除的门户详细信息页面。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/sitewise-delete-portal-console.png)
1. 在**删除门户**对话框中，选择**删除管理员和用户**。
您必须先从门户中删除管理员和用户，然后才能删除门户。如果门户没有管理员或用户，则不会显示按钮，您可以跳到下一步。
![\[“删除门户”对话框，突出显示了“删除管理员和用户”。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/sitewise-delete-portal-remove-users-console.png)
1. 如果您确定要删除整个门户，请在字段中输入 **delete** 以确认删除。
![\[“删除门户”对话框，突出显示了“删”。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/sitewise-delete-portal-confirm-delete-console.png)
1. 选择**删除**。