---
title: "Exibir recurso"
method: GET
path: "/equipments/{id}"
tags: ["Recursos"]
---

# Exibir recurso

`GET /equipments/{id}`

Exibe informações completas de um determinado recurso.

Ao informar o parâmetro `show_entities`, será adicionado um atributo de nome `entities` na resposta dessa requisição, contendo a lista de campos personalizados vinculados ao tipo desse recurso.

## Path parameters

- `id` integer, required

## Query parameters

- `show_entities` boolean

## Response `200`

- union
  - object
    - `id` integer, required — Identificador do recurso
    - `name` string, required — Nome do recurso cadastrado no tiflux
    - `acquisition_date` string, nullable, required — Data de aquisição - Formato: YYYY-MM-DD
    - `warranty_date` string, nullable, required — Data de garantia - Formato: YYYY-MM-DD
    - `updated_by_id` integer, nullable, required — Identificador do último usuário que atualizou o recurso
    - `equipment_group` object, nullable, required
      - `id` integer
      - `name` string
    - `equipment_type` object, nullable, required
      - `id` integer
      - `name` string
    - `client` object, nullable, required
      - `id` integer
      - `name` string
    - `current_user` string, nullable, required — Usuário logado na máquina
    - `agent_user` string, nullable, required — Usuário do agente instalado
    - `agent_email` string, nullable, required — Email vinculado ao agente instalado
    - `last_seen` string, nullable, required — Data e hora do último contato com o agente
    - `network_name` string, nullable, required — Nome de rede do computador
    - `manufacturer` object, nullable, required — Fabricante do recurso
      - `name` string, nullable
      - `model` string, nullable
      - `serial` string, nullable
    - `processor` object, nullable, required — Processador do recurso
      - `name` string, nullable
    - `memory` object, nullable, required — Memória RAM total do recurso, em gigabytes
      - `total_gb` number, nullable
    - `motherboard` object, nullable, required — Placa-mãe do recurso
      - `manufacturer` string, nullable
      - `model` string, nullable
      - `bios` string, nullable
    - `vga` object[], required — Placas de vídeo (GPU) do recurso
      - `name` string, nullable
      - `vram_mb` integer, nullable
    - `disks` object[], required — Discos do recurso
      - `name` string
      - `size_gb` number, nullable
      - `use_percent` number, nullable
    - `disksmart` object[], required — Status S.M.A.R.T dos discos do recurso
      - `model` string, nullable
      - `status` string, nullable
    - `network` object[], required — Interfaces de rede do recurso
      - `name` string
      - `ipv4` string, nullable
      - `mac` string, nullable
    - `operating_system` object, nullable, required — Sistema operacional do recurso
      - `name` string, nullable
      - `kernel` string, nullable
      - `version` string, nullable
      - `service_pack` string, nullable
    - `antivirus` object[], required — Antivírus instalados no recurso
      - `name` string, nullable
      - `up_to_date` boolean, nullable
      - `active` boolean, nullable
    - `windows_update` object, required — Status de atualizações pendentes do Windows
      - `pending_count` integer
      - `has_critical_pending` boolean
    - `sound` object[], required — Dispositivos de áudio do recurso
      - `name` string, nullable
    - `printer` object[], required — Impressoras do recurso
      - `name` string, nullable
      - `port` string, nullable
      - `default` boolean, nullable
  - object
    - `id` integer, required — Identificador do recurso
    - `name` string, required — Nome do recurso cadastrado no tiflux
    - `acquisition_date` string, nullable, required — Data de aquisição - Formato: YYYY-MM-DD
    - `warranty_date` string, nullable, required — Data de garantia - Formato: YYYY-MM-DD
    - `updated_by_id` integer, nullable, required — Identificador do último usuário que atualizou o recurso
    - `equipment_group` object, nullable, required
      - `id` integer
      - `name` string
    - `equipment_type` object, nullable, required
      - `id` integer
      - `name` string
    - `client` object, nullable, required
      - `id` integer
      - `name` string
    - `current_user` string, nullable, required — Usuário logado na máquina
    - `agent_user` string, nullable, required — Usuário do agente instalado
    - `agent_email` string, nullable, required — Email vinculado ao agente instalado
    - `last_seen` string, nullable, required — Data e hora do último contato com o agente
    - `network_name` string, nullable, required — Nome de rede do computador
    - `manufacturer` object, nullable, required — Fabricante do recurso
      - `name` string, nullable
      - `model` string, nullable
      - `serial` string, nullable
    - `processor` object, nullable, required — Processador do recurso
      - `name` string, nullable
    - `memory` object, nullable, required — Memória RAM total do recurso, em gigabytes
      - `total_gb` number, nullable
    - `motherboard` object, nullable, required — Placa-mãe do recurso
      - `manufacturer` string, nullable
      - `model` string, nullable
      - `bios` string, nullable
    - `vga` object[], required — Placas de vídeo (GPU) do recurso
      - `name` string, nullable
      - `vram_mb` integer, nullable
    - `disks` object[], required — Discos do recurso
      - `name` string
      - `size_gb` number, nullable
      - `use_percent` number, nullable
    - `disksmart` object[], required — Status S.M.A.R.T dos discos do recurso
      - `model` string, nullable
      - `status` string, nullable
    - `network` object[], required — Interfaces de rede do recurso
      - `name` string
      - `ipv4` string, nullable
      - `mac` string, nullable
    - `operating_system` object, nullable, required — Sistema operacional do recurso
      - `name` string, nullable
      - `kernel` string, nullable
      - `version` string, nullable
      - `service_pack` string, nullable
    - `antivirus` object[], required — Antivírus instalados no recurso
      - `name` string, nullable
      - `up_to_date` boolean, nullable
      - `active` boolean, nullable
    - `windows_update` object, required — Status de atualizações pendentes do Windows
      - `pending_count` integer
      - `has_critical_pending` boolean
    - `sound` object[], required — Dispositivos de áudio do recurso
      - `name` string, nullable
    - `printer` object[], required — Impressoras do recurso
      - `name` string, nullable
      - `port` string, nullable
      - `default` boolean, nullable
    - `entities` object[], required — Campos personalizados configurados para o tipo desse recurso
      - `id` integer — Identificador do campo personalizado
      - `name` string — Nome do campo personalizado
      - `applied_in` string — Onde o campo personalizado está aplicado
      - `description` string, nullable — Descrição do campo personalizado
      - `active` boolean — Informa se o campo personalizado está ativo
      - `menu_item` boolean, nullable — Informa se o campo personalizado é um item de menu
      - `entity_fields` object[] — **Lista de campos, dos campos personalizados vinculados nesse objeto**
        - `id` integer, nullable — Identificador do valor preenchido
        - `field_type` 'email' | 'date' | 'currency' | 'phone' | 'checkbox' | 'text' | 'text_area' | 'single_select' | 'link' — Tipos de campo: "**email**", "**date**", "**currency**", "**phone**", "**checkbox**", "**text**", "**text_area**", "**single_select**", "**link**"
        - `name` string — Nome do campo
        - `required` boolean — Informa se o campo é de preenchimento obrigatório
        - `entity_field_id` integer — Identificador do campo
        - `entity_id` integer — Identificador do campo personalizado
        - `value` string, nullable — Valor preenchido
        - `options` object[] — **Lista com valores das opções preenchidas no campo** (utilizado em campos do tipo checkbox e single_select)
          - `id` integer — Identificador do valor preenchido
          - `entity_field_id` integer — Identificador do campo
          - `entity_field_option_id` integer — Identificador da opção
          - `title` string — Nome da opção
          - `value` string — Valor da opção

## Other responses

- `403` — ### **Problemas com permissão** Essa resposta significa que o seu usuário está autenticado corretamente, porém, não possui a permissão ou licença necessária para acessar essa rota
- `404` — ### **Recurso não encontrado**

---

[API](https://skmtc.net/tiflux/apis/tiflux-official-api.md) · [All operations](https://skmtc.net/tiflux/apis/tiflux-official-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tiflux/tiflux-official-api/revisions/c656412a58bc/schema)