Skip to content

Resources¶

`/resource</path/to/resource>`¶

Method	Action	Status code	Parameters
GET	Download a resource, list contents of directory, or show formatted resource metadata.	200	operation (default
HEAD	Show resource metadata in HTTP headers.	200
PUT	Upload/move/copy a resource, create directories on the fly (overwrite if exists). For move/copy operations, place source path in body. Copying is not supported for directories.	200 (exists) 201 (new)	operation (default
DELETE	Delete a resource (recursively if directory)	200

Exceptions¶

Exception	Status code
GET or DELETE for a resource that does not exist	404
PUT to directory	405
PUT method=copy with source directory	405
PUT with source path that doesn't exist	404
POST	405

Headers¶

Header	Description
Last-Modified	When resource was last modified.
Content-Type	Will guess mime-type from extension or content.
Resource-Type (custom)	directory
Resource-Parent (custom)	Path to parent

Format¶

Examples are given in XML. The JSON and HTML formats are analogue.

Metadata¶

<ResourceMetaData>
   <name> nameOfFile </name>
   <parent> <path> path/to/parent </path>
        <atom:link xmlns:atom="http://www.w3.org/2005/Atom" rel="alternate"
   href="http://localhost:8080/geoserver/rest/resource/path/to/parent?operation=metadata&format=xml" 
         type="application/xml"/>
   </parent>
   <lastModified> date </lastModified>
   <type> undefined | resource | directory </type>
</ResourceMetaData>

Directories¶

<ResourceDirectory>`
   <name> nameOfDirectory </name>
   <parent> <path> path/to/parent </path>
        <atom:link xmlns:atom="http://www.w3.org/2005/Atom" rel="alternate"
   href="http://localhost:8080/geoserver/rest/resource/path/to/parent?operation=metadata&format=xml" 
         type="application/xml"/>
   </parent>
   <lastModified> date </lastModified>
   <children>
       <child>
               <name> ... </name>
               <atom:link xmlns:atom="http://www.w3.org/2005/Atom" rel="alternate"
                href="http://localhost:8080/geoserver/rest/resource/path/to/child"/>
       </child>
       <child>
               ...
       </child>
       ...
   </children>` 
</ResourceDirectory>