| .. |
| .. |
| .. Licensed under the Apache License, Version 2.0 (the "License"); |
| .. you may not use this file except in compliance with the License. |
| .. You may obtain a copy of the License at |
| .. |
| .. http://www.apache.org/licenses/LICENSE-2.0 |
| .. |
| .. Unless required by applicable law or agreed to in writing, software |
| .. distributed under the License is distributed on an "AS IS" BASIS, |
| .. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| .. See the License for the specific language governing permissions and |
| .. limitations under the License. |
| .. |
| |
| .. _to-api-v12-job: |
| |
| Jobs |
| ==== |
| |
| .. _to-api-v12-job-route: |
| |
| /api/1.2/jobs |
| ++++++++++++++++++ |
| |
| **GET /api/1.2/jobs** |
| |
| Get all jobs (currently limited to invalidate content (PURGE) jobs) sorted by start time (descending). |
| |
| Authentication Required: Yes |
| |
| Role(s) Required: Operations or Admin |
| |
| **Request Query Parameters** |
| |
| +-----------------+----------+---------------------------------------------------+ |
| | Name | Required | Description | |
| +=================+==========+===================================================+ |
| | ``dsId`` | no | Filter jobs by Delivery Service ID. | |
| +-----------------+----------+---------------------------------------------------+ |
| | ``userId`` | no | Filter jobs by User ID. | |
| +-----------------+----------+---------------------------------------------------+ |
| |
| **Response Properties** |
| |
| +----------------------+--------+-------------------------------------------------+ |
| | Parameter | Type | Description | |
| +======================+========+=================================================+ |
| |``id`` | int | Job id | |
| +----------------------+--------+-------------------------------------------------+ |
| |``assetUrl`` | string | URL of the asset to invalidate. | |
| +----------------------+--------+-------------------------------------------------+ |
| |``deliveryService`` | string | Unique identifier of the job's DS. | |
| +----------------------+--------+-------------------------------------------------+ |
| |``keyword`` | string | Job keyword (PURGE) | |
| +----------------------+--------+-------------------------------------------------+ |
| |``parameters`` | string | Parameters associated with the job. | |
| +----------------------+--------+-------------------------------------------------+ |
| |``startTime`` | string | Start time of the job. | |
| +----------------------+--------+-------------------------------------------------+ |
| |``createdBy`` | string | Username that initiated the job. | |
| +----------------------+--------+-------------------------------------------------+ |
| |
| **Response Example** :: |
| |
| { |
| "response": [ |
| { |
| "id": 1 |
| "assetUrl": "http:\/\/foo-bar.domain.net\/taco.html", |
| "deliveryService": "foo-bar", |
| "keyword": "PURGE", |
| "parameters": "TTL:48h", |
| "startTime": "2015-05-14 08:56:36-06", |
| "createdBy": "jdog24" |
| }, |
| { |
| "id": 2 |
| "assetUrl": "http:\/\/foo-bar.domain.net\/bell.html", |
| "deliveryService": "foo-bar", |
| "keyword": "PURGE", |
| "parameters": "TTL:72h", |
| "startTime": "2015-05-16 08:56:36-06", |
| "createdBy": "jdog24" |
| } |
| ] |
| } |
| |
| | |
| |
| |
| **GET /api/1.2/jobs/:id** |
| |
| Get a job by ID (currently limited to invalidate content (PURGE) jobs). |
| |
| Authentication Required: Yes |
| |
| Role(s) Required: Operations or Admin |
| |
| **Response Properties** |
| |
| +----------------------+--------+-------------------------------------------------+ |
| | Parameter | Type | Description | |
| +======================+========+=================================================+ |
| |``id`` | int | Job id | |
| +----------------------+--------+-------------------------------------------------+ |
| |``assetUrl`` | string | URL of the asset to invalidate. | |
| +----------------------+--------+-------------------------------------------------+ |
| |``deliveryService`` | string | Unique identifier of the job's DS. | |
| +----------------------+--------+-------------------------------------------------+ |
| |``keyword`` | string | Job keyword (PURGE) | |
| +----------------------+--------+-------------------------------------------------+ |
| |``parameters`` | string | Parameters associated with the job. | |
| +----------------------+--------+-------------------------------------------------+ |
| |``startTime`` | string | Start time of the job. | |
| +----------------------+--------+-------------------------------------------------+ |
| |``createdBy`` | string | Username that initiated the job. | |
| +----------------------+--------+-------------------------------------------------+ |
| |
| **Response Example** :: |
| |
| { |
| "response": [ |
| { |
| "id": 1 |
| "assetUrl": "http:\/\/foo-bar.domain.net\/taco.html", |
| "deliveryService": "foo-bar", |
| "keyword": "PURGE", |
| "parameters": "TTL:48h", |
| "startTime": "2015-05-14 08:56:36-06", |
| "createdBy": "jdog24" |
| } |
| ] |
| } |
| |
| | |