开始使用 API
本部分将介绍如何设置您的环境以通过 AWS API 进行 Amazon Bedrock 请求。AWS 提供以下工具来简化您的体验：
-
AWS Command Line Interface (AWS CLI)
-
AWS SDK
-
Amazon SageMaker AI 笔记本
要开始使用 API，您需要获取凭证来授予编程访问权限。如果以下部分与您有关，请展开并按照说明操作。否则，请继续完成剩余部分。
如果您还没有 AWS 账户，请完成以下步骤来创建一个。
注册 AWS 账户
打开 https://portal.aws.amazon.com/billing/signup
。 按照屏幕上的说明操作。
在注册时，将接到电话或收到短信，要求使用电话键盘输入一个验证码。
当您注册 AWS 账户 时，系统将会创建一个 AWS 账户根用户。根用户有权访问该账户中的所有 AWS 服务和资源。作为最佳安全实践，请为用户分配管理访问权限，并且只使用根用户来执行需要根用户访问权限的任务。
注册过程完成后，AWS 会向您发送一封确认电子邮件。在任何时候，您都可以通过转至 https://aws.amazon.com/
保护您的 AWS 账户根用户
-
选择根用户并输入您的 AWS 账户 电子邮件地址，以账户拥有者身份登录 AWS 管理控制台
。在下一页上，输入您的密码。 要获取使用根用户登录方面的帮助，请参阅《AWS 登录 用户指南》中的 Signing in as the root user。
-
为您的根用户启用多重身份验证（MFA）。
有关说明，请参阅《IAM 用户指南》中的为 AWS 账户 根用户启用虚拟 MFA 设备（控制台）。
要安装 AWS CLI，请按照 Install or update to the latest version of the AWS CLI 中的步骤操作。
要安装 AWS SDK，请在用于在 AWS 上进行构建的工具
-
对服务请求进行加密签名
-
重试请求
-
处理错误响应
获取凭证来授予编程访问权限
如果用户需要在 AWS 管理控制台之外与 AWS 交互，则需要编程式访问。AWS 提供了多种选项，具体取决于您的安全考量。
注意
关于如何生成可用于快速访问 Amazon Bedrock API 的 API 密钥的分步指南，请参阅开始使用 Amazon Bedrock API 密钥：生成 30 天密钥并发出第一个 API 调用。
如有更高的安全性要求，请继续阅读本部分。
授予编程式访问权限的方法取决于访问 AWS 的用户类型。
要向用户授予编程式访问权限，请选择以下选项之一。
| 哪个主体需要编程访问权限？ | 目的 | 方式 |
|---|---|---|
| IAM 用户 | 限制对 AWS CLI、AWS SDK 或 AWS API 的编程请求进行签名的长期凭证的有效时长。 |
按照您希望使用的界面的说明进行操作。
|
| IAM 角色 | 使用临时凭证签署向 AWS CLI、AWS SDK 或 AWS API 发出的编程请求。 | 按照《IAM 用户指南》中将临时凭证用于 AWS 资源中的说明进行操作。 |
|
人力身份 （在 IAM Identity Center 中管理的用户） |
使用临时凭证签署向 AWS CLI、AWS SDK 或 AWS API 发出的编程请求。 |
按照您希望使用的界面的说明进行操作。
|
如果决定对 IAM 用户使用访问密钥，AWS 建议通过包含限制性内联策略来为 IAM 用户设置过期时间。
重要
请注意以下警告：
-
不得使用账户的根凭证来访问 AWS 资源。这些凭证可提供不受限的账户访问且难以撤销。
-
不得在应用程序文件中按字面输入访问密钥或凭证信息。如果您这样做，则在将项目上传到公共存储库或在其他情况下，会有意外暴露凭证的风险。
-
不得在项目区域中放入包含凭证的文件。
-
安全管理您的访问密钥。请不要向未经授权方提供访问密钥，即便是为了帮助找到您的账户标识符也不行。如果您这样做，可能会向某人提供对您的账户的永久访问权限。
-
请注意，共享 AWS 凭证文件中存储的所有凭证都以明文形式存储。
有关更多详细信息，请参阅《AWS 一般参考》中的 Best practices for managing AWS access keys。
创建 IAM 用户
-
在 AWS 管理控制台主页上，选择 IAM 服务或导航到 IAM 控制台，网址为 https://console.aws.amazon.com/iam/
。 -
在导航窗格中，选择用户，然后选择创建用户。
-
按照 IAM 控制台中的指南，设置一个（无权访问 AWS 管理控制台的）编程用户，并且不授予其任何权限。
将用户访问权限限制在有限的时间段内
您创建的任何 IAM 用户访问密钥都属于长期凭证。为了确保这些凭证在处理不当的情况下会过期，您可以创建内联策略来指定密钥失效的日期，从而限制这些凭证的使用时间。
-
打开刚创建的 IAM 用户。在权限选项卡中，选择添加权限，然后选择创建内联策略。
-
在 JSON 编辑器中，指定以下权限。要使用此策略，请将示例策略中的
aws:CurrentTime时间戳值替换为自己的结束日期。注意
IAM 建议将访问密钥限制在 12 小时以内。
创建访问密钥
-
在用户详细信息页面上，选择安全凭证选项卡。在访问密钥部分，选择创建访问密钥。
-
表明您计划将这些访问密钥用作其他，然后选择创建访问密钥。
-
在 Retrieve access keys（检索访问密钥）页面上，选择 Show（显示）来显示用户的秘密访问密钥的值。您可以复制凭证或下载 .csv 文件。
重要
如果不再需要此 IAM 用户，建议将其移除并遵循 AWS 安全最佳实践。建议要求人类用户在访问 AWS 时通过 AWS IAM Identity Center 使用临时凭证。
将 Amazon Bedrock 权限附加到用户或角色
在设置好编程访问凭证后，您需要为用户或 IAM 角色配置权限，以便其访问一组与 Amazon Bedrock 相关的操作。要设置这些权限，请执行以下操作：
-
在 AWS 管理控制台主页上，选择 IAM 服务或导航到 IAM 控制台，网址为 https://console.aws.amazon.com/iam/
。 -
选择用户或角色，然后选择您的用户或角色。
-
在权限选项卡中，选择添加权限，然后选择添加 AWS 托管式策略。选择 AmazonBedrockFullAccess AWS 托管式策略。
-
要允许用户或角色订阅模型，请选择创建内联策略，然后在 JSON 编辑器中指定以下权限：
尝试对 Amazon Bedrock 进行 API 调用
在完成所有前提条件后，选择以下主题之一来测试使用 Amazon Bedrock 模型发出模型调用请求：
主题
