什么是政策？

本页面适用于 Apigee 和 Apigee Hybrid。

查看 Apigee Edge 文档。

借助 Apigee，您可以使用政策编程 API 行为，而无需编写任何代码。政策就像一个实现特定受限管理功能的模块。这些政策旨在让您能够轻松可靠地向 API 添加常见的管理功能类型。政策提供安全、速率限制、转换和中介功能等功能，让您无需自行编写代码和维护此功能。

不限于 Apigee 提供的一组政策类型。您还可以编写自定义脚本和代码（例如 JavaScript 应用），它们能够扩展 API 代理功能，让您在 Apigee 政策支持的基本管理功能的基础上创新。

请观看本视频，了解政策附件和执行。

政策类型

从技术上讲，政策是 XML 格式的配置文件。每个政策类型的结构（例如必需和可选配置元素）均由 XML 架构定义。如果您精通 XML 工具，那么值得熟悉 GitHub 上 API 平台示例中的政策架构。

Apigee 政策类型分为以下功能类别：

流量管理

通过流量管理类别中的政策，您可以通过 API 代理控制请求和响应消息的流。这些政策同时支持操作级和业务级控制。它们可让您控制原始吞吐量，还可以按应用控制流量。通过流量管理政策类型，您可以强制执行配额，还有助于减轻拒绝服务攻击的风险。

安全

安全类别中的政策支持身份验证、授权以及基于内容的安全措施。

中介

中介类别中的政策让您可以在消息流经 API 代理时主动对其执行操作。它们允许您将消息格式从 XML 转换为 JSON（反之亦然），或将一种 XML 格式转换为另一种 XML 格式。它们还可让您解析消息、生成新消息和更改出站消息的值。中介政策还与 Apigee 公开的基本服务进行交互，让您可以在运行时检索有关应用、开发者、安全令牌和 API 产品的数据。

扩展程序

通过扩展程序类别中的政策，您可以利用 Apigee 的可扩展性，从而以您选择的编程语言实现自定义行为。

政策参考概览详细记录了每种政策类型。本主题展示了一般互动，向您介绍如何创建政策，以及如何将它们附加到 API 代理配置中的流。

部署政策更改

要使政策更改生效，您必须将 API 代理修订版本部署到环境。在附加政策或对现有政策做出更改后，请使用 Apigee 界面或 Apigee API 部署更改。

验证政策执行情况

要验证政策是否正确执行，API 必须由 HTTP 客户端调用。如需验证此 Quota 配置，请向 API 提交多个请求，超出您在配额政策中设置的配额限制。（下面请求中的 URI 路径（配置为 ProxyEndpoint 中的基本路径设置）是 /weather）。

http://{org_name}-test.apigee.net/weather/forecastrss?w=12797282

在一分钟内提交多个请求后，您应该会看到以下错误消息：

{
   "fault":{
      "faultstring":"policies.ratelimit.QuotaViolation",
      "detail":{
         "errorcode":"policies.ratelimit.QuotaViolation"
      }
   }
}

这表示 Apigee 正在强制执行 Quota 政策。

基于政策的错误处理

请记下以上错误消息的格式。它包含 faultstring 属性和 errorcode 属性。在许多情况下，您需要实现某些处理这些错误的行为。例如，您可能想要向应用超出 Quota 的开发者发送自定义消息。

如需详细了解错误处理，请参阅处理错误。

最佳做法：常见政策集

为了满足基本管理要求，API 代理通常会强制执行以下政策：

基本 API 密钥验证

ProxyEndpoint 请求流程：

SpikeArrest
XMLThreatProtection 或 JSONThreatProtection
API 密钥验证
Quota
ResponseCache

ProxyEndpoint 响应流程：

ResponseCache

基本转换：JSON 到 XML

请求流程：

SpikeArrest
JSONThreatProtection
API 密钥验证
Quota
JSONtoXML

响应流程：

XMLToJSON
ResponseCache