Amazon Elastic Compute Cloud (Amazon EC2) 是基于 Web 的服务，提供可扩展的计算容量，允许企业在 Amazon Web Services (AWS) Cloud 中运行应用程序。 IBM® App Connect Enterprise 提供了一个Amazon EC2 请求节点，使您能够连接到Amazon EC2 并发出请求，对Amazon机器映像、可用区、实例、密钥对、启动模板和安全组等对象执行操作。
关于此任务
IBM App Connect Enterprise 通过Amazon EC2 Request节点与Amazon EC2 进行同步通信，该节点可在Windows、 AIX 和 Linux® 系统上使用。
您可以使用
Amazon EC2 Request 节点连接到
Amazon EC2 并对对象执行操作，例如:
- Amazon Machine Image
- 检索图像
- 可用性专区
- 检索可用性区域
- 实例类型
- 检索实例类型
- 实例
- 检索，启动，启动，停止，重新引导或终止实例
- 密钥对
- 检索密钥对
- 启动模板
- 检索启动模板
- 安全组
- 检索安全组
有关配置 Amazon EC2 Request 节点的其他信息，请参阅 Amazon EC2 Request 节点。
过程
- 在 IBM App Connect Enterprise 工具包中，创建一个包含Amazon EC2 请求节点的流程。
- 在流中选择 Amazon EC2 Request 节点以在编辑器中显示节点属性。
- 在 基本 选项卡上，单击 启动连接器发现。
此时会显示一个面板，您可以在其中指定要在连接器发现期间使用的策略项目名称和保险库文件详细信息。
- 指定要在连接器发现期间使用的策略项目和保险库文件的详细信息：
- 在 策略项目 字段中，指定用于存储连接器发现期间创建的策略的策略项目。
也可以通过单击新建并指定新策略项目的名称来创建新的策略项目。 然后单击完成。
- 指定要在连接器发现期间使用的保险库文件。 缺省情况下，连接器发现期间使用的凭证存储在 外部目录保险库中，这是可供任何集成服务器使用的 App Connect Enterprise 保险库文件。 或者，您可以将凭证存储在集成服务器保险库文件中，该保险库文件是在集成服务器的工作目录中创建的，并且只能由该特定集成服务器使用。
要指定用于存储凭证的保险库文件，请完成下列其中一个主题的
使用连接器发现向导 部分中的步骤:
- 在 保险库密钥 字段中，输入用于访问保险库中存储的凭证的保险库密钥。 保险库密钥的长度必须至少为 8 个字符。
- 可选: 缺省情况下，指定的保险库文件位置和保险库文件密钥将另存为 Toolkit 中的首选项，以便在您启动 "连接器发现" 时预设这些值。 如果您不希望保存这些首选项，请取消选中保存在保险库文件首选项中。
- 单击 启动发现 以启动 Amazon EC2 连接器的 "连接器发现" 向导。
此时将显示 " 连接器发现 " 窗口。 如果现有 Amazon EC2 连接 (帐户) 可用，那么将显示这些连接的列表。 如果没有现有连接，那么 Amazon EC2 连接器的状态显示为 Not
connected。
- 如果一个或多个 Amazon EC2 连接 (帐户) 可用，请完成以下步骤:
- 通过单击连接（帐户）来选择要使用的连接（帐户）。
- 单击所需的对象类型，然后选择要对该对象执行的操作。 例如，要从 Amazon EC2检索实例，请单击 实例 ，然后单击 检索实例。
- 如果没有现有连接（帐户），请完成以下步骤：
- 单击向下箭头以显示可用对象类型的列表。
- 单击所需的对象类型，然后选择要对该对象执行的操作。 例如，要从 Amazon EC2检索实例，请单击 实例 ，然后单击 检索实例。
- 单击连接。
此时将显示一个窗口，您可以在该窗口中输入
Amazon EC2 帐户的连接详细信息。 输入以下信息：
- 私钥访问密钥: Amazon EC2 帐户的私钥访问密钥。 从 AWS 管理控制台中的 "安全凭证" 页面获取私钥访问密钥。
- 访问密钥标识: Amazon EC2 帐户的访问密钥标识。 从 AWS 管理控制台中的 "安全凭证" 页面获取访问密钥标识。
- 区域: Amazon EC2 实例的区域; 例如，
us-east-1。
有关识别这些连接详细信息的更多信息、请参阅 如何使用 IBM App Connect 和 Amazon EC2 中的 IBM App Connect Enterprise as a Service 文档。
- 单击连接。
- 在向导中设置必需的连接器属性。
您可以通过单击 添加条件 ，然后选择要过滤的属性来添加用于检索数据的条件。 例如，您可以检索具有指定标识或电子邮件地址的商机。 您还可以设置一些属性，这些属性指定要检索的最大记录数以及在超过该限制时要执行的操作。
- 在 "连接器发现" 向导中指定完属性后，单击 保存。
用于连接到
Amazon EC2 的凭证存储在保险库文件中，其他连接详细信息保存在
Amazon EC2 策略中。 在向导中设置的属性值将返回至
IBM App Connect Enterprise 工具包中的
Amazon EC2 请求节点。
- 完成发现并保存属性值后，通过单击窗口右上角的 X 或按 Alt+F4来退出 "连接器发现" 向导。
- 返回编辑亚马逊 EC2 请求节点，该节点位于 IBM App Connect Enterprise 工具包中。
现在，在 "连接器发现" 向导 (在步骤
6中) 中设置的连接器属性在属性编辑器中的
Amazon EC2 Request 节点上可视。
基本 选项卡显示您在向导中设置的
操作 和
对象 属性的值。 例如，如果在向导中选择了 ，那么将在节点的
基本 选项卡上显示以下属性:
- 操作 -
RETRIEVEALL
- 对象 -
Instances
操作和对象属性的值将以只读格式显示。 如果要更改这些值，您可以通过再次单击启动连接器发现并在“连接器发现”向导中设置新值来执行此操作。
模式基本名称 属性指定模式文件的基本名称，这些文件描述从 Amazon EC2 连接器发送和接收的请求和响应消息的格式。 第一次对节点运行发现时，将自动设置模式基本名称，该名称基于当前流名称和节点名。 如果在首次运行发现之前手动设置此属性，那么将使用您设置的值。 如果在发现后重命名模式，那么必须编辑此属性，以使其与项目中重命名的模式所使用的模式基本名称相匹配。 如果在发现后更改此属性，那么必须重命名模式名称以匹配或再次运行发现。
根据发现期间选择的操作， "连接器发现" 向导将生成请求模式和响应模式，或者仅生成响应模式。 仅当所选操作和对象需要请求消息时，才会生成请求模式。 此请求模式用于验证请求消息。 如果操作为 RETRIEVE 或 DELETE，那么连接器仅返回响应模式。
生成的模式文件将添加到项目中，并且可供 映射 节点用于变换输入或输出数据。 模式的完整文件名派生自模式基本名称 (例如 gen/MyMessageFlow.Amazon_EC2_Request) ，后缀为 response.schema.json 或 request.schema.json。 您可以通过单击 打开请求模式 或 打开响应模式来打开模式。
- 检查 Amazon EC2 Request 节点上的属性设置是否正确，然后保存消息流。
- 在 Amazon EC2 Request 节点的 Connection 选项卡上， Policy 属性显示策略的名称，该策略包含要用于连接的安全身份的详细信息。 策略的类型为
Amazon EC2。
- 可选: 在 连接 选项卡上设置 超时 属性，以指定节点等待 Amazon EC2 处理操作的时间 (以秒计)。
- Amazon EC2 Request 节点的 过滤器 选项卡包含一些属性，这些属性用于控制消息流选择数据的方式。 这些属性的初始值取自在 "连接器发现" 向导中为 Amazon EC2 连接器设置的属性值，包括过滤器选项属性以及指定的任何条件 (如步骤 6中所述)。 如果您随后返回到 "连接器发现" 向导并更改任何属性的值 (例如，通过添加新条件) ，那么这些更新将反映在节点上设置的属性中。
过滤器选项 属性控制执行 Amazon EC2 Request 节点时要对哪些对象进行操作。 过滤器限制 属性控制要检索的最大项数以及超出限制时要执行的操作。
您可以通过单击要在 " 过滤器选项 " 部分中修改的值旁边的 编辑 ，并通过更改在 过滤器限制 部分中设置的属性值来修改值。
属性值可以是文本值，也可以是 ESQL 或 XPATH 表达式，这些表达式在执行时根据传递到 Amazon EC2 Request 节点的消息内容进行解析。
- 在 请求 选项卡上，设置 数据位置 属性以指定入局消息树中包含要在 Amazon EC2中创建的对象数据的位置。 此数据构成从 Amazon EC2 Request 节点发送到 Amazon EC2 系统的请求。
- 在 结果 选项卡上，设置 输出数据位置 属性以指定输出消息树中将包含在 Amazon EC2中创建的记录数据的位置。
- 缺省情况下，将根据连接器发现期间生成的请求模式验证请求消息。 您可以使用 Amazon EC2 Request 节点的 Validation 属性来关闭请求验证或更改验证设置。
- 保存 消息流。