---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# API de herança de função do usuário

# API de herança de função do usuário {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 24 de jun. de 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

A API de herança de função do usuário fornece endpoints que permitem que você veja as funções que um usuário específico herdou.
Esta API requer o plug-in Contextual Security: Role Management V2 REST API (com.glide.role_management.inh_count.rest_api), ativado automaticamente em novas instâncias a partir da versão Jakarta, ou o plug-in Contextual Security: Role Management Enhancements REST API, ativado automaticamente começando com a versão Geneva. A REST API da Contextual Security: Role Management V2 depende do plug-in Contextual Security: Role Management V2 (com.glide.role_management.inh_count).

A função de um usuário pode ser concedida diretamente, herdada de outras funções ou herdada de grupos. Você deve ter a função user_admin para acessar esta API.

## Herança de função do usuário - GET /global/user_role_inheritance {#ariaid-title2}

Retorna as funções concedidas e herdadas de um usuário especificado.

### Formato da URL {#user_role_inher-GET__section_pg5_hds_2mb}

URL com controle de versão: /api/global/{api_version}/user_role_inheritance

URL padrão: /api/global/user_role_inheritance

### Parâmetros de solicitação compatíveis

{#user_role_inher-GET__entry__2}{#user_role_inher-GET__version-RESTAPI}

| Nome | Descrição |
|-|-|
| api_version | Opcional. Versão do endpoint a ser acessada. Por exemplo, <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Somente especifique este valor para usar uma versão de endpoint diferente da mais recente. Tipo de dados: cadeia de caracteres |
[Tabela 1. Parâmetros de caminho]

{#user_role_inher-GET__entry__6}

| Nome | Descrição |
|-|-|
| usuário_sysid | Obrigatório. Sys_id do usuário para o qual as informações de função serão retornadas. |
[Tabela 2. Parâmetros de consulta]

{#user_role_inher-GET__entry__10}

| Nome | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 3. Parâmetros do corpo da solicitação (XML ou JSON)]

### Cabeçalhos

Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte [Cabeçalhos de REST API compatíveis](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#user_role_inher-GET__entry__14}{#user_role_inher-GET__accept-RESTAPI}

| Cabeçalho | Descrição |
|-|-|
| Aceitar | Formato de dados do corpo da resposta. Tipos compatíveis: application/json ou application/xml. Padrão: application/json |
[Tabela 4. Cabeçalhos da solicitação]

{#user_role_inher-GET__entry__18}

| Cabeçalho | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 5. Cabeçalhos de resposta]

### Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de códigos de status possíveis usados na REST API, consulte [Códigos de resposta HTTP de REST API](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#user_role_inher-GET__entry__22}{#user_role_inher-GET__entry-200-status-code}{#user_role_inher-GET__entry-400-status-code}{#user_role_inher-GET__entry-401-status-code}{#user_role_inher-GET__entry-404-status-code}{#user_role_inher-GET__entry-500-status-code}

| Código de status | Descrição |
|-|-|
| 200 | Bem-sucedido. A solicitação foi processada com sucesso. |
| 400 | Solicitação Incorreta. Foi detectado um tipo de solicitação incorreto ou solicitação malformada. |
| 401 | Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas. |
| 404 | Não encontrado. O item solicitado não foi encontrado. |
| 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. |
[Tabela 6. Códigos de status]

### Parâmetros do corpo da resposta (JSON ou XML)

{#user_role_inher-GET__entry__34}

| Nome | Descrição |
|-|-|
| de_grupo | Lista de funções herdadas de grupos que têm funções. Tipo de dados: matriz |
| função_de | Lista de funções que são concedidas diretamente ou herdadas de outras funções. Tipo de dados: matriz |
| user_name | Nome completo do usuário. Tipo de dados: cadeia de caracteres |
[ ]

### Amostra de solicitação cURL

    curl "https://instance.service-now.com/api/global/user_role_inheritance?user_sysid=62826bf03710200044e0bfc8bcbe5df1" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"

    {
      "result": {
        "user_name": "abel.tuter",
        "from_group": [
          "[Azure Operators]/sn_azure.operator",
          "[Azure Operators]/sn_azure.operator/sn_azure.user"
        ],
        "from_role": [
          "/snc_internal",
          "/cloud_user",
          "/cloud_user/pa_viewer",
          "/cloud_user/sn_azure.user",
          "/cloud_user/aws_user"
        ]
      }
    }