Update RADIUS Gateway

PUT {{apiPath}}/environments/{{envID}}/gateways/{{gatewayID}}

You can use the PUT /environments/{{envID}}/gateways/{{gatewayID}} operation to update the details of an existing RADIUS gateway in your environment.

Points to note about the body of the request:

  • When updating a RADIUS gateway, you must include all of the parameters that are required when creating a RADIUS gateway, even if you are not modifying their values.

  • You cannot change the type of a gateway in an update call.

Prerequisites

For descriptions of the general parameters in the body of the request, see Gateway base data model.

PropertyTypeRequired?
descriptionStringOptional
enabledBooleanRequired
nameStringRequired

For descriptions of the RADIUS-specific parameters in the body of the request, see Gateway RADIUS data model.

PropertyTypeRequired?
davinci.policy.idStringRequired
defaultSharedSecretStringOptional
networkPolicyServerObjectOptional
networkPolicyServer.ipStringRequired
networkPolicyServer.portIntegerRequired
radiusClientsObject[]Required
radiusClients.ipString[]Required
radiusClients.sharedSecretString[]Optional

Request Body

{"name"=>"New RADIUS Gateway", "description"=>"Gateway with updated Davinci flow policy ID", "type"=>"RADIUS", "radiusClients"=>[{"ip"=>"127.0.0.1", "sharedSecret"=>nil}], "defaultSharedSecret"=>"secret", "davinci"=>{"policy"=>{"id"=>"567a3443878d406e3fb22f5307059e0b"}}}

RESPONSES

status: OK

{"_links":{"self":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/gateways/c512b7ce-6700-4c3b-a73d-791062165789"},"environment":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"},"instances":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/gateways/c512b7ce-6700-4c3b-a73d-791062165789/instances"},"credentials":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/gateways/c512b7ce-6700-4c3b-a73d-791062165789/credentials"}},"id":"c512b7ce-6700-4c3b-a73d-791062165789","environment":{"id":"abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"},"name":"New RADIUS Gateway","description":"Gateway with updated Davinci flow policy ID","type":"RADIUS","enabled":true,"supportedVersions":[{"version":"1.1.1","image":"pingidentity/pingone-radius-gateway:1.1.1","recommended":true,"latest":true},{"version":"1.1.0","image":"pingidentity/pingone-radius-gateway:1.1.0","supportEndsOn":"2024-11-30T00:00:00.000Z","daysUntilSupportEnds":217},{"version":"1.1.0","image":"gcr.io/ping-identity/pingone/pingone-radius-gateway:1.1.0","supportEndsOn":"2024-11-30T00:00:00.000Z","daysUntilSupportEnds":217}],"currentAlerts":[{"category":"No Instances Connected","detail":"No gateway instances are connected. All operations that require access to this gateway will fail.","severity":"ERROR"}],"radiusClients":[{"ip":"127.0.0.1"}],"davinci":{"policy":{"id":"567a3443878d406e3fb22f5307059e0b"}},"defaultSharedSecret":"secret"}