PUT /service/api/console/gsm/{gsmKey}/sites/{siteId}/endpoints

Moves endpoints to a different group.

Request Information

URI Parameters

NameDescriptionTypeAdditional Information
gsmKey

The GSM console keycode.

string

Required

siteId

The site identifier.

string

Required

URI Sample(s)

PUT
https://unityapi.webrootcloudav.com/service/api/console/gsm/BB3E-2A40-E745-4AE3-8CEF/sites/c160577f-c327-4565-8337-cfe65432f98a/endpoints

Body Parameters

Additional information for setting a group for endpoints.

Either use EndpointsList or SourceGroupId to specify the endpoints being moved. If both are specified, EndpointsList is used. If both are left empty, all endpoints on the site are moved to the group specified by TargetGroupId.

SetGroupEndpointsRequestModel
NameDescriptionTypeAdditional Information
EndpointsList

Comma delimited string of endpoint ids. The endpoints are moved to the group specified by TargetGroupId.

string

None.

SourceGroupId

The id of the group where endpoints are moved from.

string

None.

TargetGroupId

The id of the group where endpoints are moved to.

string

Required

Inheritance

Value defining which policy should take effect.

  • 0 = The policy assignment of moved endpoints does not change. Endpoints which previously inherited their policies from the group's endpoint policy setting will inherit from the target group's endpoint policy setting.
  • 1 = The target group's policy will be applied to all moved endpoints.
  • 3 = No longer supported.
Default value is 0.

Note: Inheritance value 3 is no longer supported and behaves as if 0 was specified. If you used value 3 before, it is recommended to switch to value 0 instead.

integer

None.

Sample Request

{
  "EndpointsList": null,
  "SourceGroupId": "41a42961-9d39-4c22-8378-ebf080ac8f23",
  "TargetGroupId": "f14d46fb-feeb-4d29-a579-e5c1a0b4e975",
  "Inheritance": 1
}                    
<SetGroupEndpointsRequestModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.Console.Models">
  <EndpointsList i:nil="true" />
  <Inheritance>1</Inheritance>
  <SourceGroupId>41a42961-9d39-4c22-8378-ebf080ac8f23</SourceGroupId>
  <TargetGroupId>f14d46fb-feeb-4d29-a579-e5c1a0b4e975</TargetGroupId>
</SetGroupEndpointsRequestModel>                    

Response Information

Resource Description

None. If successful, this API action does not return any data and the response status code will be 204 (No Content).