连接到 Amazon - Amazon Toolkit with Amazon Q
先决条件通过 Toolkit 连接到 AmazonAmazon Q 开发者版Amazon Toolkit 文档和教程
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

连接到 Amazon

以下各节介绍如何开始使用 Amazon Toolkit for Visual Studio with Amazon Q。安装扩展后首次启动 Visual Studio 时，编辑器窗口中会显示一个开始使用界面。在开始使用选项卡中，您可以完成以下操作。

  • 启用或禁用 Amazon Q 和 Amazon Toolkit。

  • 添加新凭证并使用新凭证进行身份验证。

  • 使用现有凭证进行身份验证。

  • 访问文档和教程以帮助您开始使用 Amazon Q 和 Amazon Toolkit。

先决条件

要开始使用 Amazon Q 和 Amazon Toolkit，您需要使用 Amazon 凭证进行身份验证。如果您之前已设置 Amazon 账户并通过另一个 Amazon 工具或服务（比如 Amazon Command Line Interface）进行了身份验证，则 Amazon Toolkit 会自动检测您的凭证。如果您是 Amazon 新用户或尚未创建账户，则可以从 Amazon 注册门户注册一个 Amazon 账户。有关设置新 Amazon 账户的详细信息，请参阅《Amazon 设置用户指南》中的 概述 主题。

通过 Toolkit 连接到 Amazon

要从 Amazon Toolkit 连接到您的 Amazon 账户，可通过完成以下操作，随时打开开始使用选项卡。

在 Visual Studio 中打开开始使用选项卡

  1. 在 Visual Studio 中，从主菜单展开扩展程序，然后展开 Amazon 工具包子菜单。

  2. 选择开始使用。

  3. 开始使用选项卡将在 Visual Studio 编辑器窗口中打开。

在开始使用选项卡中，有两个主要部分：

  • 功能：在该部分，您可以启用或禁用 Amazon Q 和 Amazon Toolkit 等功能。

  • 文档和教程：您已启用功能的参考汇总。

    注意

    只有启用一项或多项功能后，才能看到“文档和教程”部分。

Amazon Q 开发者版

在开始使用选项卡的“Amazon Q”部分，您可以启用或禁用 Amazon Q、添加新连接或切换到其他 Amazon 连接。必须先启用 Amazon Q，然后才能查看或访问这些操作。要启用 Amazon Q，请单击启用按钮。

禁用 Amazon Q 后，所有 Amazon Q 特性和功能都将从 Visual Studio 中完全删除。启用 Amazon Q 会自动在开始使用选项卡中打开为 Amazon Q 设置身份验证。要继续操作，您必须进行身份验证，使用 Amazon IAM Identity Center 凭证可访问专业套餐，使用 Amazon 构建者 ID 可访问免费套餐。有关每种套餐选项的详细信息，请参阅《Amazon Q 开发者版用户指南》中的了解 Amazon Q 开发者版的服务套餐主题。

要继续，请完成下列过程之一。

使用 IAM Identity Center 进行专业套餐访问认证
注意

专业套餐访问认证所需的配置文件名称、起始 URL、配置文件区域或 SSO 区域字段通常由您公司或组织的管理员提供。有关 IAM Identity Center 凭证的详细信息，请参阅《Amazon IAM Identity Center 用户指南》中的什么是 IAM Identity Center？主题。

  1. 在开始使用：Amazon Toolkit with Amazon Q 屏幕中，选择 Amazon Q 图块中的登录按钮，导航到为 Amazon Q 设置身份验证屏幕。

  2. 在为 Amazon Q 设置身份验证屏幕上，导航到专业套餐部分，填写必需字段并选择连接按钮。

  3. 确认您希望在默认 Web 浏览器中打开 Amazon 授权请求门户。

  4. 完成 Amazon 授权请求门户所要求的步骤，之后您会收到通知，届时您即可安全地关闭浏览器并返回 Visual Studio。

  5. 完成该过程后，在开始使用选项卡中，Amazon Q 会更新显示，告知您已通过 IAM Identity Center 成功连接。

使用 Amazon 构建者 ID 进行免费套餐身份验证
注意

有关 Amazon 构建者 ID 的更多详细信息，请参阅《Amazon 登录用户指南》中的使用 Amazon 构建者 ID 登录主题。

  1. 在开始使用：Amazon Toolkit with Amazon Q 屏幕中，选择 Amazon Q 图块中的登录按钮，导航到为 Amazon Q 设置身份验证屏幕。

  2. 在为 Amazon Q 设置身份验证屏幕上，导航至免费套餐部分，然后选择注册或登录按钮。

  3. 确认您希望在默认 Web 浏览器中打开 Amazon 授权请求门户。

  4. 完成 Amazon 授权请求门户所要求的步骤，之后您会收到通知，届时您即可安全地关闭浏览器并返回 Visual Studio。

  5. 完成该过程后，在开始使用选项卡中，Amazon Q 会更新显示，告知您已通过 Amazon 构建者 ID 成功连接。

使用 IAM Identity Center 或 Amazon 构建者 ID 凭证进行身份验证后，您可以在 Visual Studio 中访问 Amazon Q。此外，您还可以在开始使用选项卡中执行以下操作：

  • 注销：断开您当前的凭证与所有 Amazon Q 功能的连接。Amazon Q 仍处于启用状态，但大多数功能无法使用。

  • 禁用 Amazon Q：完全禁用 Visual Studio 中的所有 Amazon Q 功能。

Amazon Toolkit

在 Amazon Toolkit 部分的开始使用 Amazon Toolkit 选项卡中，您可以启用或禁用 Amazon Toolkit、添加新连接或切换到其他 Amazon 连接。必须先启用 Amazon Toolkit，然后才能查看或访问这些操作。要启用 Amazon Toolkit，请单击启用按钮。

启用 Amazon Toolkit 后，为 Amazon Toolkit 设置身份验证会自动加载到开始使用 Amazon Toolkit 选项卡中。要继续，您必须使用您的 Amazon IAM Identity Center 凭证或 IAM 用户角色凭证进行身份验证。

注意

有关 IAM Identity Center 凭证的详细信息，请参阅《Amazon IAM Identity Center 用户指南》中的什么是 IAM Identity Center？主题。有关 IAM 用户角色凭证的详细信息，请参阅《Amazon SDK 和工具参考指南》中的 Amazon 访问密钥：长期凭证主题。

使用 IAM Identity Center 进行身份验证和连接

  1. 在开始使用：Amazon Toolkit with Amazon Q 屏幕中，选择 Amazon Toolkit 图块中的登录按钮，导航到为 Amazon Toolkit 设置身份验证屏幕。

  2. 在为 Amazon Toolkit 设置身份验证屏幕中，从配置文件类型下拉菜单中选择 IAM Identity Center（单点登录服务的升级版）。

  3. 在从现有配置文件中选择或添加新配置文件下拉菜单中，选择一个现有配置文件，或选择添加新配置文件以添加新的配置文件信息。

    注意

    如果选择现有配置文件，请转到步骤 7。

  4. 在配置文件名称字段中，输入您要用于身份验证的关联 IAM Identity Center 账户的 profile name。

  5. 在起始 URL 文本字段中，输入附加到您的 IAM Identity Center 凭证的 Start URL。

  6. 从配置文件区域（默认为 us-east-1）下拉菜单中，选择由您正在用于身份验证的 IAM Identity Center 用户配置文件定义的配置文件区域。

  7. 在 SSO 区域（默认为 us-east-1）下拉菜单中，选择由您的 IAM Identity Center 凭证定义的 SSO 区域。

  8. 选择连接按钮，在您的默认 Web 浏览器中打开 Amazon 授权请求站点。

  9. 按照默认 Web 浏览器中的提示操作，当授权流程完成时您会收到通知，届时您即可安全地关闭浏览器并返回 Visual Studio。

  10. 完成该过程后，在开始使用选项卡中，Amazon Toolkit 部分会更新显示，告知您已通过 IAM Identity Center 成功连接。

使用 IAM 用户角色凭证进行身份验证和连接

  1. 在开始使用：Amazon Toolkit with Amazon Q 屏幕中，选择 Amazon Toolkit 图块中的登录按钮，导航到为 Amazon Toolkit 设置身份验证屏幕。

  2. 在为 Amazon Toolkit 设置身份验证屏幕中，从配置文件类型下拉菜单中选择 IAM 用户角色。

  3. 在从现有配置文件中选择或添加新配置文件下拉菜单中，选择 Add new profile。

    注意

    如果您要从列表中选择现有的配置文件名称，请跳至步骤 8。

  4. 在配置文件名称文本字段中，输入新配置文件的名称。

  5. 在访问密钥 ID 文本字段中，为用于身份验证的配置文件输入 Access Key ID。

  6. 在密钥文本字段中，为用于身份验证的配置文件输入 Secret Key。

  7. 从存储位置（默认为“共享的凭证文件”）下拉菜单中，指定是使用共享的凭证文件还是 .NET 加密存储来存储您的凭证。

  8. 从配置文件区域（默认为 us-east-1）下拉菜单中，选择附加到用于身份验证的配置文件的分区和配置文件区域。

  9. 选择连接按钮，将此配置文件添加到您的 Amazon 存储位置并/或进行 Amazon 身份验证。

  10. 完成该过程后，在开始使用选项卡中，Amazon Toolkit 部分会更新显示，告知您已通过 IAM 用户角色凭证成功连接。

使用 IAM Identity Center 或 IAM 用户角色凭证进行身份验证后，您可以在 Toolkit for Visual Studio 中访问 Amazon 各区服务浏览器。此外，您还可以从开始使用选项卡中注销并禁用 Amazon Toolkit for Visual Studio with Amazon Q。

文档和教程

“文档和教程”部分会根据您首选的 Amazon 服务和功能，自动用推荐的文档和教程来更新。这些参考资料只有在您启用了至少一项功能后才会显示。