关于细粒度个人访问令牌所需的权限
创建细粒度个人访问令牌时,您会授予其一组权限。权限定义了 GitHub 应用可以通过 API 访问哪些资源。有关更多信息,请参阅“管理您的个人访问令牌”。
为了帮助您选择正确的权限,您将在 REST API 响应中收到 X-Accepted-GitHub-Permissions
标头。该标头将告诉您要访问端点所需的权限。有关更多信息,请参阅“REST API 故障排除”。
这些权限是访问私有资源所必需的。某些端点也可以用于在没有这些权限的情况下访问公共资源。要查看端点是否可以在没有权限的情况下访问公共资源,请参阅该端点的文档。
某些端点需要多个权限。其他端点可以使用一组权限中的任何一个权限。在这些情况下,“其他权限”列将包含一个复选标记。有关使用端点所需的权限的完整详细信息,请参阅该端点的文档。
“管理”的组织权限
组织对“阻止用户”的权限
端点 | 访问 | 其他权限 |
---|---|---|
PUT /orgs/{org}/blocks/{username} | 写入 | |
DELETE /orgs/{org}/blocks/{username} | 写入 | |
GET /orgs/{org}/blocks | 读取 | |
GET /orgs/{org}/blocks/{username} | 读取 |
组织对“自定义组织角色”的权限
组织对“自定义属性”的权限
组织对“GitHub Copilot Business”的权限
组织对“成员”的权限
组织对“组织代码空间秘密”的权限
组织对“组织代码空间设置”的权限
端点 | 访问 | 其他权限 |
---|---|---|
PUT /orgs/{org}/codespaces/access | 写入 | |
POST /orgs/{org}/codespaces/access/selected_users | 写入 | |
DELETE /orgs/{org}/codespaces/access/selected_users | 写入 |
组织对“组织代码空间”的权限
组织对“组织 Dependabot 密钥”的权限
组织对“个人访问令牌请求”的权限
组织对“个人访问令牌”的权限
组织对“项目”的权限
组织对“Secrets”的权限
组织对“自托管运行器”的权限
组织对“团队讨论”的权限
组织对“变量”的权限
组织对“Webhooks”的权限
仓库对“Actions”的权限
仓库“管理”权限
仓库对“检查”的权限
仓库对“代码扫描警报”的权限
仓库对“Codespaces 生命周期管理”的权限
仓库对“Codespaces 元数据”的权限
端点 | 访问 | 其他权限 |
---|---|---|
GET /repos/{owner}/{repo}/codespaces/devcontainers | 读取 | |
GET /repos/{owner}/{repo}/codespaces/machines | 读取 | |
GET /user/codespaces/{codespace_name}/machines | 读取 |
“Codespaces 密钥”的仓库权限
“Codespaces”的仓库权限
“提交状态”的仓库权限
端点 | 访问 | 其他权限 |
---|---|---|
POST /repos/{owner}/{repo}/statuses/{sha} | 写入 | |
GET /repos/{owner}/{repo}/commits/{ref}/status | 读取 | |
GET /repos/{owner}/{repo}/commits/{ref}/statuses | 读取 |
“内容”的仓库权限
仓库权限为“Dependabot 提醒”
仓库权限为“Dependabot 密钥”
仓库权限为“部署”
仓库权限为“环境”
仓库权限为“问题”
仓库元数据权限
仓库对“Pages”的权限
仓库对“Projects”的权限
仓库对“Pull requests”的权限
仓库权限“仓库安全建议”
仓库权限“秘密扫描警报”
仓库权限“秘密”
仓库权限“变量”
仓库权限“Webhook”
仓库权限:"工作流"
用户权限:"阻止其他用户"
端点 | 访问 | 其他权限 |
---|---|---|
PUT /user/blocks/{username} | 写入 | |
DELETE /user/blocks/{username} | 写入 | |
GET /user/blocks | 读取 | |
GET /user/blocks/{username} | 读取 |
用户权限:"Codespaces 用户密钥"
用户权限:"电子邮件地址"
端点 | 访问 | 其他权限 |
---|---|---|
PATCH /user/email/visibility | 写入 | |
POST /user/emails | 写入 | |
DELETE /user/emails | 写入 | |
GET /user/emails | 读取 | |
GET /user/public_emails | 读取 |
用户权限:"关注者"
端点 | 访问 | 其他权限 |
---|---|---|
PUT /user/following/{username} | 写入 | |
DELETE /user/following/{username} | 写入 | |
GET /user/followers | 读取 | |
GET /user/following | 读取 | |
GET /user/following/{username} | 读取 |
用户权限:"GPG 密钥"
端点 | 访问 | 其他权限 |
---|---|---|
POST /user/gpg_keys | 写入 | |
DELETE /user/gpg_keys/{gpg_key_id} | 写入 | |
GET /user/gpg_keys | 读取 | |
GET /user/gpg_keys/{gpg_key_id} | 读取 |
用户权限:"Gists"
用户权限:"Git SSH 密钥"
端点 | 访问 | 其他权限 |
---|---|---|
POST /user/keys | 写入 | |
删除 /user/keys/{key_id} | 写入 | |
获取 /user/keys | 读取 | |
获取 /user/keys/{key_id} | 读取 | |
获取 /users/{username}/keys | 读取 |
用户对“交互限制”的权限
端点 | 访问 | 其他权限 |
---|---|---|
更新 /user/interaction-limits | 写入 | |
删除 /user/interaction-limits | 写入 | |
获取 /user/interaction-limits | 读取 |
用户对“计划”的权限
端点 | 访问 | 其他权限 |
---|---|---|
获取 /users/{username}/settings/billing/actions | 读取 | |
获取 /users/{username}/settings/billing/packages | 读取 | |
获取 /users/{username}/settings/billing/shared-storage | 读取 |
用户对“SSH 签名密钥”的权限
端点 | 访问 | 其他权限 |
---|---|---|
创建 /user/ssh_signing_keys | 写入 | |
删除 /user/ssh_signing_keys/{ssh_signing_key_id} | 写入 | |
获取 /user/ssh_signing_keys | 读取 | |
获取 /user/ssh_signing_keys/{ssh_signing_key_id} | 读取 |