Get Defender Names
GET/api/v32.07/defenders/names
x-prisma-cloud-target-env: {"permission":"manageDefenders"}
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
- 200
- default