Esta versão do GitHub Enterprise Server foi descontinuada em 2024-03-26. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, segurança aprimorada e novos recursos, atualize para a última versão do GitHub Enterprise Server. Para obter ajuda com a atualização, entre em contato com o suporte do GitHub Enterprise.
Pontos de extremidade de API REST para funções de repositório personalizadas
Use a API REST para interagir com as funções de repositório personalizadas.
List custom repository roles in an organization
List the custom repository roles available in this organization. In order to see custom repository roles in an organization, the authenticated user must be an organization owner.
To use this endpoint the authenticated user must be an administrator for the organization or of an repository of the organization and must use an access token with admin:org repo
scope.
GitHub Apps must have the organization_custom_roles:read
organization permission to use this endpoint.
For more information on custom repository roles, see "About custom repository roles."
Parâmetros para "List custom repository roles in an organization"
Nome, Tipo, Descrição |
---|
accept string Setting to |
Nome, Tipo, Descrição |
---|
organization_id string ObrigatórioThe unique identifier of the organization. |
Códigos de status de resposta HTTP para "List custom repository roles in an organization"
Código de status | Descrição |
---|---|
200 | Response - list of custom role names |
Exemplos de código para "List custom repository roles in an organization"
Exemplo de solicitação
curl -L \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
http(s)://HOSTNAME/api/v3/organizations/ORGANIZATION_ID/custom_roles
Response - list of custom role names
Status: 200
{
"total_count": 2,
"custom_roles": [
{
"id": 8030,
"name": "Developer"
},
{
"id": 8031,
"name": "Designer"
}
]
}