本页面适用于 Apigee 和 Apigee Hybrid。
查看 Apigee Edge 文档。
您在此步骤中执行的操作
请按照以下步骤创建和部署测试 API 代理。最后,通过向 API 代理发送 HTTP 请求来测试该代理。
创建和部署 API 代理
Apigee 的预配过程不会自动为您创建和部署 API 代理。您必须手动创建和部署代理。
Cloud 控制台中的 Apigee 界面
如需创建和部署第一个代理,请执行以下操作:
- 在浏览器中打开 Cloud 控制台中的 Apigee 界面。
- 确保从界面左上角的下拉菜单中选择您的组织名称。组织名称与您的 Google Cloud 项目名称相同。
- 在左侧导航窗格中,点击代理开发 > API 代理。
- 点击 + 创建 (+ Create)。
系统会打开创建代理页面。
- 在代理模板框中,选择反向代理(最常见)。
- 在第 1 步:代理详细信息中,使用以下值配置代理:
参数名称 值 代理名称 hello-world
基本路径 /hello-world
目标(现有 API) mocktarget.apigee.net
- 点击下一步。
- 在第 2 步:部署(可选)中:
- 部署环境:可选。使用相应复选框选择在其中部署代理的一个或多个环境。如果您不想在此时部署代理,请将 Deployment environments 字段留空。您以后可以随时部署代理。
- 服务账号:可选。将服务账号关联到您的部署,使代理能够访问服务账号的角色和权限中指定的 Google Cloud 服务。
- 点击创建。
新的 API 代理会在所选环境中创建和部署。
- 系统会打开新创建的代理的 Proxy summary 页面。状态下的绿色对勾标记表示代理已成功部署。如果代理未部署,请参阅部署 API 代理,然后按照相应步骤手动部署代理。
- 在左侧导航窗格中,依次选择管理 > 环境 > 环境组。
- 复制环境组的主机名。您将在后续步骤中使用此主机名来调用 API 代理。
Apigee 界面
如需创建和部署第一个代理,请执行以下操作:
- 登录 Apigee 界面。
- 确保从界面左上角的下拉菜单中选择您的组织名称。组织名称与您的 Google Cloud 项目名称相同。
- 在主视图中点击 API 代理。
- 从选择环境下拉列表中,选择一个环境。
- 点击新建。
- 点击反向代理(最常见)。
- 在 Proxy details 页面中,使用以下值配置代理:
参数名称 值 名称 hello-world
基本路径 /hello-world
目标(现有 API) https://mocktarget.apigee.net
- 点击下一步。
- 在通用政策页面中的安全性:授权下,选择通过(无授权)。
- 点击下一步。
- 在摘要页面的 Optional Deployment 下,选择要在其中部署代理的环境。
- 点击创建和部署。
新的 API 代理会在所选环境中创建和部署。
- 点击 Go to proxy list。状态下的绿色对勾标记表示代理已成功部署。如果代理未部署,请参阅部署 API 代理,然后按照相应步骤手动部署代理。
- 在左侧导航窗格中,依次选择管理 > 环境 > 组。
- 点击在 Google Cloud 控制台中查看。
- 复制环境组的主机名。您将在后续步骤中使用此主机名来调用 API 代理。
- 关闭 Google Cloud 控制台。
使用内部访问权限调用代理
如果您在第 4 步:自定义访问路由中允许内部访问,请按照调用仅限内部访问的 API 代理中的说明操作。
使用外部访问权限调用代理
如果您在第 4 步:自定义访问路由中允许外部访问,请按照以下步骤操作:
- 为您的主机设置 DNS 条目。 您可以通过两种方式完成此任务:
- 在注册商处,创建一条 A 记录,以便将环境组主机名指向向导页面上配置 DNS 下显示的 IP 地址。例如,如果您的主机名为
sales.example.com
,IP 地址为 10.23.0.2,则将sales.example.com
的记录指向地址10.23.0.2
。 - 使用 Google Cloud DNS 将网址映射到 IP 地址。
- 在注册商处,创建一条 A 记录,以便将环境组主机名指向向导页面上配置 DNS 下显示的 IP 地址。例如,如果您的主机名为
- 通过在终端窗口中发送以下请求来测试 API 代理:
curl -v -H "Host:YOUR_ENV_GROUP_HOSTNAME" \ https://YOUR_INSTANCE_IP_OR_DNS/hello-world
其中:
Host
标头的值(YOUR_ENV_GROUP_HOSTNAME)是环境 > 环境组页面中的主机名。
如果请求成功,则会返回字符串
Hello, Guest!
。 如果请求不成功,请参阅问题排查。
后续步骤
- 浏览 Apigee 教程,包括: