wpsdownload.yaml 3.3 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495
  1. ---
  2. swagger: '2.0'
  3. info:
  4. version: 1.0.0
  5. title: WPS download configuration
  6. description: The WPS download module allows to perform large data, map and animation downloads sing asynchronous requests
  7. contact:
  8. name: GeoServer
  9. email: 'geoserver-users@osgeo.org'
  10. url: 'https://geoserver.org/comm/'
  11. host: localhost:8080
  12. basePath: /geoserver/rest
  13. paths:
  14. /services/wps/download:
  15. get:
  16. operationId: getDownloadServiceConfiguration
  17. tags:
  18. - "WPS"
  19. description: Retrieves the WPS Download configuration.
  20. produces:
  21. - application/xml
  22. - application/json
  23. responses:
  24. 200:
  25. description: OK
  26. schema:
  27. $ref: "#/definitions/DownloadServiceConfiguration"
  28. examples:
  29. application/xml: |
  30. <?xml version="1.0" encoding="UTF-8"?><DownloadServiceConfiguration>
  31. <maxFeatures>100000</maxFeatures>
  32. <rasterSizeLimits>64000000</rasterSizeLimits>
  33. <writeLimits>64000000</writeLimits>
  34. <hardOutputLimit>52428800</hardOutputLimit>
  35. <compressionLevel>4</compressionLevel>
  36. <maxAnimationFrames>1000</maxAnimationFrames>
  37. </DownloadServiceConfiguration>
  38. application/json: |
  39. {"DownloadServiceConfiguration": {
  40. "maxFeatures": 123,
  41. "rasterSizeLimits": 456000,
  42. "writeLimits": 789000,
  43. "hardOutputLimit": 123456,
  44. "compressionLevel": 8,
  45. "maxAnimationFrames": 56
  46. }}
  47. put:
  48. operationId: getDownloadServiceConfiguration
  49. tags:
  50. - "WPS"
  51. description: Retrieves the WPS Download configuration.
  52. parameters:
  53. - name: getDownloadServiceConfigurationBody
  54. in: body
  55. description: Body of the WPS download configuration
  56. required: true
  57. schema:
  58. $ref: "#/definitions/DownloadServiceConfiguration"
  59. consumes:
  60. - application/xml
  61. - application/json
  62. responses:
  63. 200:
  64. description: Updated
  65. definitions:
  66. DownloadServiceConfiguration:
  67. xml:
  68. name: DownloaServiceConfiguration
  69. type: object
  70. properties:
  71. maxFeatures:
  72. type: number
  73. description: maximum number of features to download
  74. rasterSizeLimits:
  75. type: number
  76. description: maximum pixel size of the Raster to read
  77. writeLimits:
  78. type: number
  79. description: maximum raw raster size in bytes (a limit of how much space can a raster take in memory). For a given raster, its raw size in bytes is calculated by multiplying pixel number (raster_width x raster_height) with the accumulated sum of each band’s pixel sample_type size in bytes, for all bands
  80. hardOutputLimit:
  81. type: number
  82. description: maximum file size to download
  83. compressionLevel:
  84. type: integer
  85. description: compression level for the output zip file
  86. maxAnimationFrames:
  87. type: integer
  88. description: maximum number of frames allowed (if no limit, the maximum execution time limits will still apply and stop the process in case there are too many)