• Home
  • Dynatrace Managed
  • Cluster API
  • Cluster API v2
  • Remote access
  • Change state of access request

Change state of access request

This API call changes state of access request for a specific request ID. You can set the state access request to PENDING, ACCEPTED, REJECTED or EXPIRED. The request consumes an application/json payload.

Authentication

To execute this request, you need one of the following API-Token scopes:

  • Cluster token management (ClusterTokenManagement)
  • Service Provider API (ServiceProviderAPI )
  • Nodekeeper access for node management (Nodekeeper)
    To learn how to obtain and use it, see Cluster API - Authentication.

Endpoint

/api/cluster/v2/remoteaccess/requests

Parameters

ParameterTypeDescriptionInRequired
requestIdstring

Request id param

pathrequired
bodyAccessRequestStateData

The JSON body of the request, containing new state of access request.

bodyoptional

Request body objects

The AccessRequestStateData object

Access request data - format used to change a state of a request

ElementTypeDescriptionRequired
statestring

Access request state

The element can hold these values
  • ACCEPTED
  • EXPIRED
  • PENDING
  • REJECTED
optional

Request body JSON model

This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.

json
{ "state": "ACCEPTED" }

Response code

Response codes

CodeDescription
200

Success

400

Bad request

403

Approving remote access request is disabled

404

Access request not found

409

Access request was found, but it's already expired

500

Operation failed

Example

In this example you request to change the remote access permission to rejected for access request ID: 7a397770-86b7-473b-b23e-4a07d79f2eff. The response code is 200 and the remote access permission state is changed.

Curl

bash
curl -X PUT "https://myManaged.cluster.com/api/cluster/v2/remoteaccess/requests/7a397770-86b7-473b-b23e-4a07d79f2eff/state" -H "accept: */*" -H "Content-Type: */*" -d "{\"state\":\"ACCEPTED\"}"

Request URL

plaintext
https://myManaged.cluster.com/api/cluster/v2/remoteaccess/requests/7a397770-86b7-473b-b23e-4a07d79f2eff/state

Request body

json
{ "state": "REJECTED" }

Response code

200