GET | Listar um dispositivo por [id]
  • 2 minutos de leitura
  • Tema escuro
    Tema claro
  • Pdf

GET | Listar um dispositivo por [id]

  • Tema escuro
    Tema claro
  • Pdf

Resumo do artigo

Acesse informações de um dispositivo registrado no PAM Core.

Requisitos

Requisição

GET /api/pam/device/[id]

Parâmetros de requisição

Envie o parâmetro abaixo no path da URL.

id - int - obrigatório - Código único de identificação do dispositivo.Nota: esse valor é automaticamente atribuído pelo senhasegura em POST | Criar dispositivo e é obtido na resposta da requisição GET | Listar todos os dispositivos.

Exemplo de requisição

GET {{url}}/api/pam/device/14

Resposta

HTTP/1.1 200 OK 
{
    "code": 200,
    "response": {
        "status": 200,
        "message": "Device 14",
        "error": false,
        "error_code": 0,
        "detail": "",
        "mensagem": "Device 14",
        "erro": false,
        "cod_erro": 0
    },
    "tenant": "senhasegura",
    "device": {
        "id": "14",
        "hostname": "API device",
        "ip": "10.66.33.17",
        "model": "Gmail",
        "type": "Desktop",
        "vendor": "Linux",
        "site": "AWS",
        "device_domain": "my_device_domain",
        "connectivities": "HTTP:80, SSH:22"",
        "session_remote_config": "HTTP::",
        "device_tags": "test"
    }
}

Campos do corpo da resposta

devices - objeto - Dados do dispositivo.


    → id - int - Código único de identificação do dispositivo.


    → hostname - string - Nome do host do dispositivo.


    → ip - string - Endereço IP do dispositivo.


    → model - string Modelo do dispositivo .


    → type - string - Tipo de dispositivo.


    → vendor - string - Fabricante do dispositivo.


    → site - string Localização do dispositivo.


    →device_domain - string - Nome ou abreviação do dispositivo.


    →connectivities - string - Conectividade do dispositivo.


    →session_remote_config - string - Expressão de login.


    →device_tags - string - Palavras-chave associadas ao dispositivo.


Erros

400 - Bad Request

Mensagem: "1011: Device not found"


Possível causa: dispositivo não encontrado.

Solução: verifique o valor do id e envie a requisição novamente.


404 - Not Found.

Mensagem: "Resource sub not found"

Possível causa: a URL ou o recurso solicitado não está correto.

Solução: verifique a URL e garanta que todos os parâmetros estão corretos.


500 - Internal Server Error.

Mensagem: "Unexpected error."

Possível causa: o erro está no servidor senhasegura.

Solução: contate o time de suporte para mais informações.


Mensagem: "You are not authorized to access this resource."

Possível causa: você não possui autorização para acessar esse recurso.

Solução: solicite ao administrador que revise sua permissão de acesso aos recursos do PAM Core no A2A.


Client authentication failed.

Mensagem: "Client authentication failed."

Possível causa: falha na autenticação da sua aplicação com o servidor senhasegura.

Solução: verifique os parâmetros de autenticação como Access Token URL, Client ID e Client secret e solicite um novo token de acesso.

Invalid signature.

Mensagem: "Invalid signature"

Possível causa: falha no reconhecimento da URL da aplicação cliente.

Solução: verifique a URL da aplicação cliente e envie a requisição novamente.


No route matched with those values.

Mensagem: "No route matched with those values."

Possível causa: ausência do header de autorização na requisição de API.

Solução: solicite um novo token de acesso.


Request timed out.

Mensagem: "Request timed out."

Possível causa: o tempo da requisição se esgotou.

Solução: verifique a conectividade entre a origem da requisição e o servidor senhasegura.


Este artigo foi útil?