developer.sailpoint.com/docs/tools/sdk/python/Reference/V2024/Methods/AccessRequestIdentityMetricsApi.md

id, title, pagination_label, sidebar_label, sidebar_class_name, keywords, slug, tags

id	title	pagination_label	sidebar_label	sidebar_class_name	keywords	slug	tags
v2024-access-request-identity-metrics	Access_Request_Identity_Metrics	Access_Request_Identity_Metrics	Access_Request_Identity_Metrics	pythonsdk	python Python sdk Access_Request_Identity_Metrics V2024Access_Request_Identity_Metrics	/tools/sdk/python/v2024/methods/access-request-identity-metrics	SDK Software Development Kit Access_Request_Identity_Metrics V2024Access_Request_Identity_Metrics

sailpoint.v2024.AccessRequestIdentityMetricsApi

Use this API to implement access request identity metrics functionality. With this functionality in place, access request reviewers can see relevant details about the requested access item and associated source activity. This allows reviewers to see how many of the identities who share a manager with the access requester have this same type of access and how many of them have had activity in the related source. This additional context about whether the access has been granted before and how often it has been used can help those approving access requests make more informed decisions.

All URIs are relative to https://sailpoint.api.identitynow.com/v2024

Method	HTTP request	Description
get-access-request-identity-metrics	GET /access-request-identity-metrics/{identityId}/requested-objects/{requestedObjectId}/type/{type}	Return access request identity metrics

get-access-request-identity-metrics

:::warning experimental This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint. ::: Return access request identity metrics Use this API to return information access metrics.

API Spec

Parameters

Param Type	Name	Data Type	Required	Description
Path	identity_id	str	True	Manager's identity ID.
Path	requested_object_id	str	True	Requested access item's ID.
Path	type	str	True	Requested access item's type.
x_sail_point_experimental	str	True (default to 'true')	Use this header to enable this experimental API.

Return type

object

Responses

Code	Description	Data Type	Response headers
200	Summary of the resource access and source activity for the direct reports of the provided manager.	object	-
400	Client Error - Returned if the request body is invalid.	ErrorResponseDto	-
401	Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.	ListAccessProfiles401Response	-
403	Forbidden - Returned if the user you are running as, doesn't have access to this end-point.	ErrorResponseDto	-
429	Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again.	ListAccessProfiles429Response	-
500	Internal Server Error - Returned if there is an unexpected error.	ErrorResponseDto	-

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

Example

import sailpoint.v2024
from sailpoint.v2024.rest import ApiException
from pprint import pprint

    identity_id = '7025c863-c270-4ba6-beea-edf3cb091573' # str | Manager's identity ID. # str | Manager's identity ID.
    requested_object_id = '2db501be-f0fb-4cc5-a695-334133c52891' # str | Requested access item's ID. # str | Requested access item's ID.
    type = 'ENTITLEMENT' # str | Requested access item's type. # str | Requested access item's type.
    x_sail_point_experimental = 'true' # str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')

    try:
        # Return access request identity metrics
        
        api_response = api_instance.get_access_request_identity_metrics(identity_id, requested_object_id, type, x_sail_point_experimental)
        
        # Below is a request that includes all optional parameters
        # api_response = api_instance.get_access_request_identity_metrics(identity_id, requested_object_id, type, x_sail_point_experimental)
        print("The response of AccessRequestIdentityMetricsApi->get_access_request_identity_metrics:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling AccessRequestIdentityMetricsApi->get_access_request_identity_metrics: %s\n" % e)

[Back to top]