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

Previous: Layers
Next: Fonts