Layer groups

A layer group is a grouping of layers and styles that can be accessed as a single layer in a WMS GetMap request. A layer group is sometimes referred to as a “base map”.

/layergroups[.<format>]

Controls all layer groups.

Method	Action	Status code	Formats	Default Format
GET	Return all layer groups	200	HTML, XML, JSON	HTML
POST	Add a new layer group	201, with Location header	XML,JSON
PUT		405
DELETE		405

/layergroups/<lg>[.<format>]

Controls a particular layer group.

Method	Action	Status code	Formats	Default Format	Parameters
GET	Return layer group lg	200	HTML, XML, JSON	HTML	quietOnNotFound
POST		405
PUT	Modify layer group lg	200	XML,JSON
DELETE	Delete layer group lg	200

Exceptions

Exception	Status code
GET for a layer group that does not exist	404
POST that specifies layer group with no layers	400
PUT that changes name of layer group	403

Parameters

quietOnNotFound

The quietOnNotFound parameter avoids to log an Exception when the layergroup is not present. Note that 404 status code will be returned anyway.

/workspaces/<ws>/layergroups[.<format>]

Controls all layer groups in a given workspace.

Method	Action	Status code	Formats	Default Format
GET	Return all layer groups within workspace ws	200	HTML, XML, JSON	HTML
POST	Add a new layer group within workspace ws	201, with Location header	XML,JSON
PUT		405
DELETE		405

/workspaces/<ws>/layergroups/<lg>[.<format>]

Controls a particular layer group in a given workspace.

Method	Action	Status code	Formats	Default Format
GET	Return layer group lg within workspace ws	200	HTML, XML, JSON	HTML	quietOnNotFound
POST		405
PUT	Modify layer group lg within workspace ws	200	XML,JSON
DELETE	Delete layer group lg within workspace ws	200

Exceptions

Exception	Status code
GET for a layer group that does not exist for that workspace	404