禁止的错误

您正在查看 Apigee Edge 文档。
转到 Apigee X 文档。
info

错误文本

Forbidden. [Description]

其中 [Description] 是描述错误原因的字符串。

示例

Forbidden. You don't have permissions to access this resource.

进行 API 调用时,您通常会看到 Forbidden 错误消息。一种常见原因是,组织管理员或其他类型的用户对需要系统管理员凭据的 Edge 管理 API 进行调用。

例如,如需使用 Edge 管理 API 在 Cloud 中的 Edge 上创建用户,您可以向 https://api.enterprise.apigee.com/v1/users 发出 POST 请求。 但是,如果您传递除系统管理员之外的任何用户的凭据,则调用会返回 HTTP 403 Forbidden 错误,如下所示:

> POST /v1/users HTTP/1.1
> Host: api.enterprise.apigee.com
> User-Agent: curl/7.54.0
> Accept: */*
> Content-Type:application/xml
> Content-Length: 162
>
* upload completely sent off: 162 out of 162 bytes
< HTTP/1.1 403 Forbidden

此错误的含义

Edge 组织中的每个用户都会被分配一个角色,而角色本质上是 基于 CRUD 的权限集。CRUD 是指“创建、读取、更新、删除”。例如,用户可能会获得一个角色,可让其读取或“获取”有关实体的详细信息,但不能获得“更新”或“删除”该实体的权限。

Forbidden 错误通常表示分配给用户的角色 没有执行所请求操作的权限。

如需了解详情,请参阅分配角色 。

问题排查

常规问题排查步骤

虽然您可能需要 Apigee 专家帮助您解决此错误,但在联系支持团队或向 Apigee 社区发帖之前,您可以尝试以下 常规问题排查步骤。

您是刚刚创建第一个组织的新客户吗?

对于首次创建组织的 Apigee 新用户,Apigee 可能需要几个 小时才能完成创建过程。如果您在新 组织中看到 Forbidden 错误,请等待几个小时,然后重试。

检查是否有其他用户最近更改了权限

在 Edge 界面中,依次选择管理 > 组织历史记录,查看最近是否有 任何权限更改。查找最近创建或 移除的权限:

您是否正在进行需要系统管理员凭据的 API 调用?

有几个 Edge 管理 API 需要您传递系统管理员凭据,例如以下 API:

如果您是 Cloud 客户,Apigee 会充当系统管理员。因此,如果您需要执行 需要系统管理员权限的操作,则必须与 Apigee Edge 支持团队 联系。

如果您在进行 Edge 管理 API 调用时遇到 Forbidden 错误, 请查看 API 参考文档 快速入门,以确定调用 API 的要求。

您是否正在创建或修改角色以使其能够访问受保护的资源?

借助 Edge,您可以创建自定义角色来控制用户对受保护资源的访问权限。例如, 您可以创建角色来控制对 API、产品和报告的访问权限。如需了解详情,请参阅分配角色。

但是,只有系统管理员才能创建为以下 资源指定权限的角色:

  • /environments
  • /environments/*
  • /environments/*/keystores/*/aliases/*/key
  • /environments/*/pods
  • /environments/*/servers
  • /pods
  • /rebuildindex
  • /userroles/devadmin
  • /userroles/devadmin/permissions
  • /userroles/devadmin/permissions/*
  • /userroles/devadmin/users
  • /userroles/devadmin/users/*
  • /users/*/status
  • /users
  • /users/*

如果您尝试创建为这些资源分配权限的角色,则会收到 Forbidden 错误。

对于 Cloud 客户,请查看 Apigee 状态页面以了解中断情况

如果 Edge for Cloud 中断,可能会出现 Forbidden 错误。使用 以下网址检查当前的 Edge 状态,以查看是否存在中断:

https://status.apigee.com/

您使用的是包含客户支持的 Edge Cloud 版本吗?

虽然您可能需要与 Apigee 支持团队联系以解决此错误,但您可以先尝试上述 常规 问题排查步骤中的步骤。如果您需要 Apigee 帮助,请参阅 Apigee 支持。

您使用的是 Edge 私有云吗?

在 Private Cloud 安装中,您可以定义系统管理员。如果您需要执行需要系统管理员凭据的操作(例如创建组织),则必须与 Edge 系统管理员合作。

您使用的是 Apigee Edge 的免费 评估版吗?

虽然您可能需要在 Apigee 社区 中发布您的问题以解决此错误,但您可以 先尝试上述 常规问题排查步骤 中的步骤。