- 2 minutos de leitura
- Imprimir
- Tema escuroTema claro
- Pdf
GET | Listar um dispositivo por [id]
- 2 minutos de leitura
- Imprimir
- Tema escuroTema claro
- Pdf
Acesse informações de um dispositivo registrado no PAM Core.
Requisitos
- Autorização com permissão de acesso ao PAM Core concedida pelo administrador no A2A.
Acesse o documento sobre Como criar uma autorização para uma aplicação para mais informações. - Dispositivo criado no PAM Core.
Acesse o documento POST | Criar dispositivo para mais informações.
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.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.