Skip to main content

Customer Endpoints

List Customer Details

Returns information about your customer entity.

GET/customers/
curl -X GET \
-H "X-Frame-ClientId: ${client_id}" \
-H "X-Frame-Timestamp: ${timestamp}" \
-H "X-Frame-Signature: ${signature}" \
"https://api.console.nutanix.com/v1/customers/"

List Customer Accounts

Returns a list of all accounts across all organizations.

GET/customers/:customer_id/accounts

Request Parameters

NameDescriptionParam TypeData TypeRequired
nameName or portion of name you would like to use for searching/filtering.URLStringFalse
activeFilters the accounts based on their “active” status. Useful for filtering out older terminated accounts.Search QueryStringFalse
organization_idFilters accounts list based on the provided Organization ID.Search QueryStringFalse
offsetUsed to specify where to start a Audit Trails query. Must be used in conjunction with the limit parameter.Search QueryInteger (String)False
limitUsed to specify the “page size” of the Audit Trails query. Must be used in conjunction with the offset parameter.Search QueryInteger (String)False
orderSpecifies the order of the results. Use “asc” for ascending order, and “desc” for descending order.Search QueryStringFalse
order_bySpecifies the field of which the ordering should occur. For example, “session_start”, “session_duration”, etc.Search QueryStringFalse
curl -X GET \
-H "X-Frame-ClientId: ${client_id}" \
-H "X-Frame-Timestamp: ${timestamp}" \
-H "X-Frame-Signature: ${signature}" \
"https://api.console.nutanix.com/v1/customers/${customer_id}/accounts?active=true"

List Customer Audit Trails

Returns Audit Trails for an account, constrained by a date range and a number of ways to filter & search for granular queries.

GET/customers/:customer_id/audit-trails

Request Parameters

NameDescriptionParam TypeData TypeRequired
customer_idYour Nutanix Customer IDURLStringTrue
searchFilters results if the provided string matches against a user's full name, email, idp, or the Audit Trail kind.Search QueryStringFalse
kindFilters Audit Trails by wildcard matching against the supplied string. For example, a kind of “launchpad” will return Audit Trails for both createLaunchpad and updateLaunchpad actions.Search QueryStringFalse
from_dateThe beginning date range for the query. The date needs to be an ISO 8601 UTC string (with the “Z” suffix). For example: “2021-12-25T23:20:58.128Z”.Search QueryISO 8601 UTC StringFalse
to_dateThe ending date range for the query. The date needs to be an ISO 8601 UTC string (with the “Z” suffix). For example: “2021-12-25T23:20:58.128Z”.Search QueryISO 8601 UTC StringFalse
offsetUsed to specify where to start a Audit Trails query. Must be used in conjunction with the limit parameter.Search QueryInteger (String)False
limitUsed to specify the “page size” of the Audit Trails query. Must be used in conjunction with the offset parameter.Search QueryInteger (String)False
orderSpecifies the order of the results. Use “asc” for ascending order, and “desc” for descending order.Search QueryStringFalse
order_bySpecifies the field of which the ordering should occur. For example, “session_start”, “session_duration”, etc.Search QueryStringFalse
curl -X GET \
-H "X-Frame-ClientId: ${client_id}" \
-H "X-Frame-Timestamp: ${timestamp}" \
-H "X-Frame-Signature: ${signature}" \
"https://api.console.nutanix.com/v1/customers/${customer_id}/audit-trails?search=jason.thompson@nutanix.com&kind=launchpad&limit=5&offset=0&from_date={{from_date}}&to_date={{to_date}}&order_by=inserted_at&order=desc"

List Customer Session Trails

Returns Session Trails based on a specified time frame and filters.

GET/customers/:customer_id/session-trails

Request Parameters

NameDescriptionParam TypeData TypeRequired
customer_idYour Nutanix Customer IDURLStringTrue
searchFilters results if the provided string matches against Server ID, Session ID, email address, and a user's full name.Search QueryStringFalse
session_startThe beginning date range for the query. The date needs to be an ISO 8601 UTC string (with the “Z” suffix). For example: “2021-12-25T23:20:58.128Z”.Search QueryISO 8601 UTC StringFalse
session_endThe ending date range for the query. The date needs to be an ISO 8601 UTC string (with the “Z” suffix). For example: “2021-12-25T23:20:58.128Z”.Search QueryISO 8601 UTC StringFalse
instance_typeFilters Session Trails based on a specific instance type ID.Search QueryStringFalse
pool_group_typeFilters Session Trails based on the pool group server type: sandbox, production, utility, persistent_desktop_production, persistent_desktop_shadow.Search QueryStringFalse
pool_idFilters Session Trails based on provided instance type's pool ID.Search QueryStringFalse
offsetUsed to specify where to start a Session Trails query. Must be used in conjunction with the limit parameter.Search QueryInteger (String)False
limitUsed to specify the “page size” of the Session Trails query. Must be used in conjunction with the offset parameter.Search QueryInteger (String)False
orderSpecifies the order of the results. Use “asc” for ascending order, and “desc” for descending order.Search QueryStringFalse
order_bySpecifies the field of which the ordering should occur. For example, “session_start”, “session_duration”, etc.Search QueryStringFalse
curl -X GET \
-H "X-Frame-ClientId: ${client_id}" \
-H "X-Frame-Timestamp: ${timestamp}" \
-H "X-Frame-Signature: ${signature}" \
"https://api.console.nutanix.com/v1/customers/${customer_id}/session-trails?limit=50&offset=0&order=desc&order_by=session_start"

List Customer API Authorization Rules

Returns all Customer API keys that have been generated and their associated permissions.

GET/customers/:customer_id/api_authorization_rules
curl -X GET \
-H "X-Frame-ClientId: ${client_id}" \
-H "X-Frame-Timestamp: ${timestamp}" \
-H "X-Frame-Signature: ${signature}" \
"https://api.console.nutanix.com/v1/customers/${customer_id}/api_authorization_rules"

List Customer Cloud Services

Returns a list of registered Cloud Service Providers configured with your Frame Customer entity.

GET/customers/:customer_id/cloud_services

Request Parameters

ParameterDescriptionParam TypeData TypeRequired
idYour Nutanix Customer ID.URLStringTrue
cloud_provider_idThe Frame cloud provider ID.Search QueryStringtrue
activeLists cloud services based on their “active” status.Search QueryBooleanFalse
omit_defaultIf true, omits Frame's default Cloud Services from the results.Search QueryBooleanFalse
curl -X GET \
-H "X-Frame-ClientId: ${client_id}" \
-H "X-Frame-Timestamp: ${timestamp}" \
-H "X-Frame-Signature: ${signature}" \
"https://api.console.nutanix.com/v1/customers/${customer_id}/cloud_services?active=true"

List Customer Elasticity

Returns information on all customer instance elasticity.

GET/customers/:customer_id/elasticity
curl -X GET \
-H "X-Frame-ClientId: ${client_id}" \
-H "X-Frame-Timestamp: ${timestamp}" \
-H "X-Frame-Signature: ${signature}" \
"https://api.console.nutanix.com/v1/customers/${customer_id}/elasticity

List Customer Settings

Returns all customer entity settings.

GET/customers/:customer_id/settings
curl -X GET \
-H "X-Frame-ClientId: ${client_id}" \
-H "X-Frame-Timestamp: ${timestamp}" \
-H "X-Frame-Signature: ${signature}" \
"https://api.console.nutanix.com/v1/customers/${customer_id}/settings"

List Customer Overall Usage

Returns information on all customer entity utilization.

GET/customers/:customer_id/usage

Request Parameters

NameDescriptionParam TypeData TypeRequired
idYour Nutanix Customer IDURLStringTrue
from_dateThe beginning date range for the query. The date needs to be an ISO 8601 UTC string (with the “Z” suffix). For example: “2021-12-25T23:20:58.128Z”.Search QueryISO 8601 UTC StringFalse
to_dateThe ending date range for the query. The date needs to be an ISO 8601 UTC string (with the “Z” suffix). For example: “2021-12-25T23:20:58.128Z”.Search QueryISO 8601 UTC StringFalse
resolution_typeResolution Type: by_hour, by_day, by_month, by_yearSearch QueryStringFalse
server_typeFilters query based on a specific server ID.Search QueryStringFalse
pool_idFilters query based on provided instance type's pool ID.Search QueryStringFalse
instance_type_idFilters the usage by an instance type's “external” ID, e.g. “gateway-prod.3”.Search QueryStringFalse
datacenter_idLimits the results to a specific Datacenter by ID.Search QueryStringFalse
skip_if_byo_accountTrue/False boolean value determining if BYO results should be returned.Search QueryBooleanFalse
curl -X GET \
-H "X-Frame-ClientId: ${client_id}" \
-H "X-Frame-Timestamp: ${timestamp}" \
-H "X-Frame-Signature: ${signature}" \
"https://api.console.nutanix.com/v1/customers/${customer_id}/usage?from_date=${from_date}&to_date=${to_date}"

List Customer Disk Volume Usage

Returns information on all customer entity disk volume utilization.

GET/customers/:customer_id/disk_volume_usage?from_date=X&to_date=Y

Request Parameters

NameDescriptionParam TypeData TypeRequired
customer_idYour Nutanix Customer ID.URLStringTrue
from_dateThe beginning date range for the query.The date needs to be an ISO 8601 UTC string (with the “Z” suffix). For example: “2021-12-25T23:20:58.128Z”.YYYY-MM-DD Date stringFalse
to_dateThe ending date range for the query.The date needs to be an ISO 8601 UTC string (with the “Z” suffix). For example: “2021-12-25T23:20:58.128Z”.YYYY-MM-DD Date stringFalse
resolution_typeResolution Type: by_hour, by_day, by_month, by_yearSearch QueryStringFalse
server_typeServer Type: sandbox, production, utility, persistent_desktop_production, persistent_desktop_shadowSearch QueryStringFalse
disk_volume_type_idDisk Volume Type: all, standard, gp2, io1Search QueryStringFalse
datacenter_idLimits the results to a specific Datacenter ID number.Search QueryStringFalse
skip_if_byo_accountTrue/False boolean value determining if BYO results should be returned.Search QueryBooleanFalse
curl -X GET \
-H "X-Frame-ClientId: ${client_id}" \
-H "X-Frame-Timestamp: ${timestamp}" \
-H "X-Frame-Signature: ${signature}" \
"https://api.console.nutanix.com/v1/customers/${customer_id}/disk_volume_usage?from_date=${from_date}&to_date=${to_date}"

List Customer Master Images

Returns information on all customer master images.

GET/customers/:customer_id/cloud_services/:external_cloud_service_id/master_images?external_data_center_id=XYZ

Request Parameters

ParameterDescriptionParam TypeData TypeRequired
external_data_center_idThis ID represents a Frame “external” datacenter ID.Search QueryStringFalse
curl -X GET \
-H "X-Frame-ClientId: ${client_id}" \
-H "X-Frame-Timestamp: ${timestamp}" \
-H "X-Frame-Signature: ${signature}" \
"https://api.console.nutanix.com/v1/customers/${customer_id}/cloud_services/${external_cloud_service_id}/master_images?external_data_center_id=${external_data_center_id}"

List Customer User Activity

Returns statistical user activity information for the specified Customer constrained by a date range. Can be ordered by passing a string parameter as well as exclude specified user IDPs.

GET/customers/:customer_id/user_activities?from_date=X&to_date=Y

Request Parameters

NameDescriptionParam TypeData TypeRequired
customer_idYour Nutanix Customer IDURLStringTrue
from_dateThe beginning date range for the query.Search QueryYYYY-MM-DD Date stringTrue
to_dateThe ending date range for the query.Search QueryYYYY-MM-DD Date stringTrue
orderSpecifies the order of the results. Use “asc” for ascending order, and “desc” for descending order.Search QueryStringFalse
order_bySpecifies the field of which the ordering should occur. For example, “session_start”, “session_duration”, etc.Search QueryStringFalse
skip_user_idpsUser Identity Providers to skip.Search QueryArray (String)False
curl -X GET \
-H "X-Frame-ClientId: ${client_id}" \
-H "X-Frame-Timestamp: ${timestamp}" \
-H "X-Frame-Signature: ${signature}" \
"https://api.console.nutanix.com/v1/customers/${customer_id}/user_activities?from_date=${from_date}&to_date=${to_date}&skip_user_idps[]=example-okta-admins&skip_user_idps[]=example-okta-dev