更新随用随付环境类型

本页面适用于 Apigee，但不适用于 Apigee Hybrid。

查看 Apigee Edge 文档。

Apigee 的随用随付价格属性部分取决于您附加到 Apigee 实例的环境类型。您可以随时选择向您的随用随付组织添加基础、中级或综合环境，并根据您的功能和容量需求定制价格方案。本主题介绍如何升级或降级现有环境的类型以添加或移除功能，以及管理您的 Apigee 随用随付结算资源用量。

所需的角色和权限

如需获得更新随用随付环境类型所需的权限，请让管理员向您授予项目的以下 IAM 角色：

  • Apigee Organization Admin (apigee.organization.admin)
  • Apigee Environment Admin (apigee.environment.admin)

如需详细了解如何授予角色，请参阅管理访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

使用 API 更新环境类型

如需更新现有随用随付环境的类型，请使用以下命令： 

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME?updateMask=type" \
  -H "Authorization: Bearer $token" \
  -X PATCH \
  -H 'Content-Type: application/json' \
  -d '{"type":"ENV_TYPE"}'

其中：

  • ORG_NAME 是 Apigee 随用随付组织的名称。
  • ENV_NAME 是要更新的 Apigee 环境的名称。
  • ENV_TYPE 是更新后的环境类型。选项为 BASE、INTERMEDIATE 或 COMPREHENSIVE。

例如，若要将名为 test-env 的基本环境升级到综合环境，请使用以下命令： 

curl "https://apigee.googleapis.com/v1/organizations/my-org/environments/test-env?updateMask=type" \
  -H "Authorization: Bearer $token" \
  -X PATCH \
  -H 'Content-Type: application/json' \
  -d '{"type":"COMPREHENSIVE"}'

操作完成后，使用以下命令确认环境类型的变化： 

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME" -H "Authorization: Bearer $token"

此命令会返回环境资源对象，其中包括所选环境类型。

错误参考信息

升级或降级环境类型时，如果现有环境包含与新所选环境类型不兼容的资源，则操作将失败。如需详细了解各环境的可用功能和限制，请参阅环境类型比较。

如果操作失败，您将看到类似于以下格式的错误： 

  {
    "error": {
      "code": "FAILED_PRECONDITION",
      "message": "environment type update invalid: ...<detailed message here >... :failed precondition",
      "status": "FAILED_PRECONDITION"
      }
  }

下表总结了可能的错误消息以及可用于解决问题和升级或降级环境类型的潜在步骤：

失败条件 错误消息 解决步骤
超出每个组织的环境数上限 cannot transfer active environments to INTERMEDIATE, will exceed limit

cannot transfer active environments to BASE, will exceed limit

 从组织中删除一个或多个环境。
部署在环境中的可扩展代理 existing environment has an extensible API 从环境中取消部署可扩展代理。
在环境中部署的共享流 existing environment has a shared flow 从环境中取消部署共享流。
每个区域每个环境的代理部署单元数上限 pdu count, 50, cannot exceed 20

pdu count, 425, cannot exceed 50

 从环境中取消部署和删除共享流或代理。
已在环境中启用的插件 Existing environment has an addon enabled 在环境中停用插件。
已在环境中启用多区域支持 instance attachment count, 2, cannot exceed 1 for BASE environment

instance attachment count, 2, cannot exceed 1 for INTERMEDIATE environment

 删除环境的第二个实例连接。