您正在查看 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 状态,以查看是否存在中断:
您使用的是包含客户支持的 Edge Cloud 版本吗?
虽然您可能需要与 Apigee 支持团队联系以解决此错误,但您可以先尝试上述 常规 问题排查步骤中的步骤。如果您需要 Apigee 帮助,请参阅 Apigee 支持。
您使用的是 Edge 私有云吗?
在 Private Cloud 安装中,您可以定义系统管理员。如果您需要执行需要系统管理员凭据的操作(例如创建组织),则必须与 Edge 系统管理员合作。