Basic API example for CPM login and retrieving the list of CPM users using powershell

Basic API example for CPM login and retrieving the list of CPM users using powershell

The below script provides a basic example for the usage of CPM API with Powershell.

Copy the below text into a .ps1 file, replace the text in blue with your relevant text and run the script.


[System.Net.ServicePointManager]::ServerCertificateValidationCallback = {$true}


$ApiKey = "Enter_your_API_Key_here"

$your_cpm_address = "https://enter_you_cpm_address"

$tokenobtainurl = -join($your_cpm_address,"/api/token/obtain/api_key/")

$path_to_file = "Insert_full_path_to_where_you_want_to_print_the_users_list_to\users.txt"


#The below command stores the access key and refresh key received in the response from CPM

$Response = Invoke-WebRequest -Uri $tokenobtainurl -Method "POST" -Headers @{"Authorization" = "Bearer $NO_AUTH" } -ContentType "application/json" -Body "{`"api_key`":`"$ApiKey`"}" | ConvertFrom-Json

Write-Host "Your Access key is:" $Response.access

Write-Host "Your Refresh key is:" $Response.refresh


#Building the Authorization header

$Authorization = -join("Bearer ", $Response.access)

Write-Host "The Authorization Header is:" $Authorization


#Example below receives the list of users and stores them into a file on your PC

$userspath = -join($your_cpm_address,"/api/users/")

Invoke-WebRequest -Uri $userspath -Method "GET" -Headers @{"Authorization"="$Authorization"; "Accept"="application/json; version=1.0" } -ContentType "application/json" -OutFile $path_to_file | ConvertFrom-Json


For full API documentation, please refer to CPM’s API user guide-

    • Related Articles

    • RestAPI example files

      Background: CPM contain rich RESTful API interface that enable you to do everything you do manually in the UI in an automated way, but it can be difficult to start using the RESTful API. We created this examples to assist customers in understanding ...
    • CPM RESTful API guide for CPM v2.6.0

      Attached to this article is the user guide for CPM RESTful API v1.3 (for CPM v2.6.0 and up). For CPM CLI information see here: You can find the latest version ...
    • Restful API examples

      The purpose of this article is to help you get started with N2WS Restful API and provide you some examples on how to use it. However, it is not meant to replace the official documentation - for full and accurate information on all the APIs and ...
    • How to configure IDP users to have Root/Admin Account Permissions in CPM

      Background: Often administrators are asked to configure logins of  an IDP solution with Cloud Protection Manager CPM. This document will discuss the required configuration steps needed to allow IDP users to easily access CPM GUI and be able to see ...
    • New feature - CPM now adds tags to snapshots and AMIs using a single API call

      To reduce the number of API calls, CPM's behavior has been changed. When applying tags to snapshots, CPM will apply the tags using a single API call, rather than an API call per tag. Reference defect number - e5de964f41, fixed in v2.2.0 Link to ...