建议后续步骤

本页面适用于 ApigeeApigee Hybrid

查看 Apigee Edge 文档。

您在此步骤中执行的操作

请按照以下步骤创建和部署测试 API 代理。最后,通过向 API 代理发送 HTTP 请求来测试该代理。

创建和部署 API 代理

创建和部署代理需要最小权限集。 如果您具有 Apigee Org Admin 角色,则可以完成此任务。如需了解您可以使用的其他角色,请参阅 Apigee 角色

Apigee 的预配过程不会自动为您创建和部署 API 代理。您必须手动创建和部署代理。

如需创建和部署第一个代理,请执行以下操作:

  1. 在浏览器中打开 Cloud 控制台中的 Apigee 界面
  2. 确保从界面左上角的下拉菜单中选择您的组织名称。组织名称与您的 Google Cloud 项目名称相同。
  3. 在左侧导航窗格中,点击代理开发 > API 代理
  4. 点击 + 创建 (+ Create)。

    系统会打开创建代理页面。

  5. 代理模板框中,选择反向代理(最常见)
  6. 第 1 步:代理详细信息中,使用以下值配置代理:
    参数名称
    代理名称 hello-world
    基本路径 /hello-world
    目标(现有 API) mocktarget.apigee.net
  7. 点击下一步
  8. 第 2 步:部署(可选)中:
    • 部署环境:可选。使用相应复选框选择在其中部署代理的一个或多个环境。如果您不想在此时部署代理,请将 Deployment environments 字段留空。您以后可以随时部署代理。
    • 服务账号:可选。将服务账号关联到您的部署,使代理能够访问服务账号的角色和权限中指定的 Google Cloud 服务。
  9. 点击创建

    新的 API 代理会在所选环境中创建和部署。

  10. 系统会打开新创建的代理的 Proxy summary 页面。状态下的绿色对勾标记表示代理已成功部署。如果代理未部署,请参阅部署 API 代理,然后按照相应步骤手动部署代理。
  11. 在左侧导航窗格中,依次选择管理 > 环境 > 环境组
  12. 复制环境组的主机名。您将在后续步骤中使用此主机名来调用 API 代理。

如需创建和部署第一个代理,请执行以下操作:

  1. 登录 Apigee 界面
  2. 确保从界面左上角的下拉菜单中选择您的组织名称。组织名称与您的 Google Cloud 项目名称相同。
  3. 在主视图中点击 API 代理
  4. 选择环境下拉列表中,选择一个环境。
  5. 点击新建
  6. 点击反向代理(最常见)
  7. Proxy details 页面中,使用以下值配置代理:
    参数名称
    名称 hello-world
    基本路径 /hello-world
    目标(现有 API) https://mocktarget.apigee.net
  8. 点击下一步
  9. 通用政策页面中的安全性:授权下,选择通过(无授权)
  10. 点击下一步
  11. 摘要页面的 Optional Deployment 下,选择要在其中部署代理的环境。
  12. 点击创建和部署

    新的 API 代理会在所选环境中创建和部署。

  13. 点击 Go to proxy list状态下的绿色对勾标记表示代理已成功部署。如果代理未部署,请参阅部署 API 代理,然后按照相应步骤手动部署代理。
  14. 在左侧导航窗格中,依次选择管理 > 环境 > 组
  15. 点击在 Google Cloud 控制台中查看
  16. 复制环境组的主机名。您将在后续步骤中使用此主机名来调用 API 代理。
  17. 关闭 Google Cloud 控制台。

使用内部访问权限调用代理

如果您在第 4 步:自定义访问路由中允许内部访问,请按照调用仅限内部访问的 API 代理中的说明操作。

使用外部访问权限调用代理

如果您在第 4 步:自定义访问路由中允许外部访问,请按照以下步骤操作:

  1. 为您的主机设置 DNS 条目。 您可以通过两种方式完成此任务:
    • 在注册商处,创建一条 A 记录,以便将环境组主机名指向向导页面上配置 DNS 下显示的 IP 地址。例如,如果您的主机名为 sales.example.com,IP 地址为 10.23.0.2,则将 sales.example.com 的记录指向地址 10.23.0.2
    • 使用 Google Cloud DNS 将网址映射到 IP 地址。
  2. 通过在终端窗口中发送以下请求来测试 API 代理:
    curl -v -H "Host:YOUR_ENV_GROUP_HOSTNAME" \
      https://YOUR_INSTANCE_IP_OR_DNS/hello-world

    其中:

    • Host 标头的值(YOUR_ENV_GROUP_HOSTNAME)是环境 > 环境组页面中的主机名。

    如果请求成功,则会返回字符串 Hello, Guest!。 如果请求不成功,请参阅问题排查

后续步骤