123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190 |
- .. _rest_api_layergroups:
- 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.
- .. list-table::
- :header-rows: 1
- * - 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.
- .. list-table::
- :header-rows: 1
- * - Method
- - Action
- - Status code
- - Formats
- - Default Format
- - Parameters
- * - GET
- - Return layer group ``lg``
- - 200
- - HTML, XML, JSON
- - HTML
- - :ref:`quietOnNotFound <rest_api_layergroups_quietOnNotFound>`
- * - POST
- -
- - 405
- -
- -
- -
- * - PUT
- - Modify layer group ``lg``
- - 200
- - XML,JSON
- -
- -
- * - DELETE
- - Delete layer group ``lg``
- - 200
- -
- -
- -
- Exceptions
- ~~~~~~~~~~
- .. list-table::
- :header-rows: 1
- * - 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
- ~~~~~~~~~~
-
- .. _rest_api_layergroups_quietOnNotFound:
- ``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.
-
- .. list-table::
- :header-rows: 1
- * - 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.
- .. list-table::
- :header-rows: 1
- * - Method
- - Action
- - Status code
- - Formats
- - Default Format
- -
- * - GET
- - Return layer group ``lg`` within workspace ``ws``
- - 200
- - HTML, XML, JSON
- - HTML
- - :ref:`quietOnNotFound <rest_api_layergroups_quietOnNotFound>`
- * - POST
- -
- - 405
- -
- -
- -
- * - PUT
- - Modify layer group ``lg`` within workspace ``ws``
- - 200
- - XML,JSON
- -
- -
- * - DELETE
- - Delete layer group ``lg`` within workspace ``ws``
- - 200
- -
- -
- -
- Exceptions
- ~~~~~~~~~~
- .. list-table::
- :header-rows: 1
- * - Exception
- - Status code
- * - GET for a layer group that does not exist for that workspace
- - 404
|