Skip to main content

Get Defender Names

GET 
/api/v31.02/defenders/names
x-prisma-cloud-target-env: {"permission":"manageDefenders","saas":true,"self-hosted":true}
x-public: true

Retrieves a list of Defender hostnames that can be used as the {id} query parameter in other /api/v1/defenders endpoints.

cURL Request​

Refer to the following example cURL command that retrieves a list of all Defenders:

$ curl -k \
  -u <USER> \
  -H 'Content-Type: application/json' \
  -X GET \
  https://<CONSOLE>/api/v<VERSION>/defenders/names

Refer to the following example cURL command that retrieves a list of connected Defenders using a query parameter and a specified boolean value in lower case:

$ curl -k \
  -u <USER> \
  -H 'Content-Type: application/json' \
  -X GET \
  "https://<CONSOLE>/api/v<VERSION>/defenders/names?connected=true"

Refer to the following example cURL command that retrieves a list of disconnected Defenders using a query parameter and a specified boolean value in lower case:

$ curl -k \
  -u <USER> \
  -H 'Content-Type: application/json' \
  -X GET \
  "https://<CONSOLE>/api/v<VERSION>/defenders/names?connected=false"

Note: The query parameter connected expects and accepts a boolean value in lower case. The endpoint enlists all the connected and disconnected Defenders if do not specify a boolean value.

Refer to the following example cURL command that retrieves a list of Defenders by type:

$ curl -k \
  -u <USER> \
  -H 'Content-Type: application/json' \
  -X GET \
  "https://<CONSOLE>/api/v<VERSION>/defenders/names?type=<linux|windows|docker|...>"

Request​

Responses​