| .. |
| .. |
| .. 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-v13-origin: |
| |
| Origin |
| ====== |
| |
| .. _to-api-v13-origin-route: |
| |
| /api/1.3/origins |
| ++++++++++++++++ |
| |
| **GET /api/1.3/origins** |
| |
| Get Origins. |
| |
| Authentication Required: Yes |
| |
| Role(s) Required: None |
| |
| **Request Query Parameters** |
| |
| +-------------------------+-----------------+---------------------------------------------------+ |
| | Name | Required | Description | |
| +=========================+=================+===================================================+ |
| | ``cachegroup`` | no | Filter Origins by cachegroup ID. | |
| +-------------------------+-----------------+---------------------------------------------------+ |
| | ``coordinate`` | no | Filter Origins by coordinate ID. | |
| +-------------------------+-----------------+---------------------------------------------------+ |
| | ``deliveryservice`` | no | Filter Origins by deliveryservice ID. | |
| +-------------------------+-----------------+---------------------------------------------------+ |
| | ``id`` | no | Filter Origins by ID. | |
| +-------------------------+-----------------+---------------------------------------------------+ |
| | ``name`` | no | Filter Origins by name. | |
| +-------------------------+-----------------+---------------------------------------------------+ |
| | ``profileId`` | no | Filter Origins by profile ID. | |
| +-------------------------+-----------------+---------------------------------------------------+ |
| | ``primary`` | no | Filter Origins by isPrimary. | |
| +-------------------------+-----------------+---------------------------------------------------+ |
| | ``tenant`` | no | Filter Origins by tenant ID. | |
| +-------------------------+-----------------+---------------------------------------------------+ |
| |
| **Response Properties** |
| |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | Parameter | Type | Description | |
| +===================================+===================+==========================================================================+ |
| | ``cachegroup`` | string | Name of the Origin's cachegroup | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``cachegroupId`` | int | ID of the Origin's cachegroup | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``coordinate`` | string | Name of the Origin's coordinate | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``coordinateID`` | int | ID of the Origin's coordinate | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``deliveryService`` | string | XML_ID of the Origin's delivery service | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``deliveryServiceId`` | int | ID of the Origin's delivery service | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``fqdn`` | string | The FQDN of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``id`` | int | Local unique identifier for the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``ip6Address`` | string | IPv6 address of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``ipAddress`` | string | IPv4 address of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``isPrimary`` | boolean | Whether or not this is the primary Origin for the delivery service | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``lastUpdated`` | string | The Time / Date this entry was last updated | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``name`` | string | The name of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``port`` | int | The TCP port on which the Origin listens | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``profile`` | string | The profile name of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``profileId`` | int | The profile ID of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``protocol`` | string | The protocol of the Origin's URL (http or https) | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``tenant`` | string | The tenant name of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``tenantId`` | int | The tenant ID of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| |
| **Response Example** :: |
| |
| { |
| "response": [ |
| { |
| "cachegroup": "cg1", |
| "cachegroupId": 1, |
| "coordinate": "coordinate1", |
| "coordinateId": 1, |
| "deliveryService": "myds", |
| "deliveryServiceId": 1, |
| "fqdn": "example.com", |
| "id": 1, |
| "ip6Address": "cafe:dead:d0d0::42", |
| "ipAddress": "10.2.3.4", |
| "isPrimary": false, |
| "lastUpdated": "2018-05-08 19:33:18+00", |
| "name": "my-origin", |
| "port": 443, |
| "profile": "my-origins", |
| "profileId": 1, |
| "protocol": "https", |
| "tenant": "tenantA", |
| "tenantId": 3 |
| }, |
| { |
| "cachegroup": null, |
| "cachegroupId": null, |
| "coordinate": null, |
| "coordinateId": null, |
| "deliveryService": null, |
| "deliveryServiceId": null, |
| "fqdn": "foo.example.com", |
| "id": 2, |
| "ip6Address": null, |
| "ipAddress": null, |
| "isPrimary": false, |
| "lastUpdated": "2018-05-08 19:35:12+00", |
| "name": "origin2", |
| "port": null, |
| "profile": null, |
| "profileId": null, |
| "protocol": "http", |
| "tenant": null, |
| "tenantId": null |
| } |
| ] |
| } |
| |
| | |
| |
| **POST /api/1.3/origins** |
| |
| Create Origin. |
| |
| Authentication Required: Yes |
| |
| Role(s) Required: admin or oper |
| |
| **Request Parameters** |
| |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | Name | Required | Description | |
| +===================================+===================+==========================================================================+ |
| | ``cachegroupId`` | no | ID of the Origin's cachegroup | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``coordinateID`` | no | ID of the Origin's coordinate | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``deliveryServiceId`` | yes | ID of the Origin's delivery service | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``fqdn`` | yes | The FQDN of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``ip6Address`` | no | IPv6 address of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``ipAddress`` | no | IPv4 address of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``name`` | yes | The name of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``port`` | no | The TCP port on which the Origin listens | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``profileId`` | no | The profile ID of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``protocol`` | yes | The protocol of the Origin's URL (http or https) | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``tenantId`` | no | The tenant ID of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| |
| **Request Example** :: |
| |
| { |
| "cachegroupId": 1, |
| "coordinateId": 1, |
| "deliveryServiceId": 1, |
| "fqdn": "foo.example.com", |
| "ip6Address": "cafe:dead:d0d0::42", |
| "ipAddress": "10.2.3.4", |
| "name": "origin1", |
| "port": 443, |
| "profileId": 1, |
| "protocol": "https", |
| "tenantId": 1 |
| } |
| |
| **Response Properties** |
| |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | Parameter | Type | Description | |
| +===================================+===================+==========================================================================+ |
| | ``cachegroup`` | string | Name of the Origin's cachegroup | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``cachegroupId`` | int | ID of the Origin's cachegroup | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``coordinate`` | string | Name of the Origin's coordinate | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``coordinateID`` | int | ID of the Origin's coordinate | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``deliveryService`` | string | XML_ID of the Origin's delivery service | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``deliveryServiceId`` | int | ID of the Origin's delivery service | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``fqdn`` | string | The FQDN of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``id`` | int | Local unique identifier for the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``ip6Address`` | string | IPv6 address of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``ipAddress`` | string | IPv4 address of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``isPrimary`` | boolean | Whether or not this is the primary Origin for the delivery service | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``lastUpdated`` | string | The Time / Date this entry was last updated | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``name`` | string | The name of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``port`` | int | The TCP port on which the Origin listens | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``profile`` | string | The profile name of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``profileId`` | int | The profile ID of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``protocol`` | string | The protocol of the Origin's URL (http or https) | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``tenant`` | string | The tenant name of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``tenantId`` | int | The tenant ID of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``alerts`` | array | A collection of alert messages. | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``>level`` | string | Success, info, warning or error. | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``>text`` | string | Alert message. | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| |
| **Response Example** :: |
| |
| { |
| "alerts": [ |
| { |
| "level": "success", |
| "text": "origin was created." |
| } |
| ], |
| "response": { |
| "cachegroup": null, |
| "cachegroupId": 1, |
| "coordinate": null, |
| "coordinateId": 1, |
| "deliveryService": null, |
| "deliveryServiceId": 1, |
| "fqdn": "foo.example.com", |
| "id": 1, |
| "ip6Address": "cafe:dead:d0d0::42", |
| "ipAddress": "10.2.3.4", |
| "isPrimary": false, |
| "lastUpdated": "2018-05-08 20:30:27+00", |
| "name": "origin1", |
| "port": 443, |
| "profile": null, |
| "profileId": 1, |
| "protocol": "https", |
| "tenant": null, |
| "tenantId": 1 |
| } |
| } |
| |
| | |
| |
| **PUT /api/1.3/origins** |
| |
| Update origin. |
| |
| Authentication Required: Yes |
| |
| Role(s) Required: admin or oper |
| |
| **Request Query Parameters** |
| |
| +------+----------+------------------------------------+ |
| | Name | Required | Description | |
| +======+==========+====================================+ |
| | id | yes | The id of the coordinate to edit. | |
| +------+----------+------------------------------------+ |
| |
| **Request Parameters** |
| |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | Name | Required | Description | |
| +===================================+===================+==========================================================================+ |
| | ``cachegroupId`` | no | ID of the Origin's cachegroup | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``coordinateID`` | no | ID of the Origin's coordinate | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``deliveryServiceId`` | yes | ID of the Origin's delivery service | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``fqdn`` | yes | The FQDN of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``id`` | yes | The ID of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``ip6Address`` | no | IPv6 address of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``ipAddress`` | no | IPv4 address of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``name`` | yes | The name of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``port`` | no | The TCP port on which the Origin listens | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``profileId`` | no | The profile ID of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``protocol`` | yes | The protocol of the Origin's URL (http or https) | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``tenantId`` | no | The tenant ID of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| |
| **Request Example** :: |
| |
| { |
| "cachegroupId": 1, |
| "coordinateId": 1, |
| "deliveryServiceId": 1, |
| "fqdn": "foo.example.com", |
| "id": 1, |
| "ip6Address": "cafe:dead:d0d0::42", |
| "ipAddress": "10.2.3.4", |
| "name": "origin1", |
| "port": 443, |
| "profileId": 1, |
| "protocol": "https", |
| "tenantId": 1 |
| } |
| |
| **Response Properties** |
| |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | Parameter | Type | Description | |
| +===================================+===================+==========================================================================+ |
| | ``cachegroup`` | string | Name of the Origin's cachegroup | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``cachegroupId`` | int | ID of the Origin's cachegroup | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``coordinate`` | string | Name of the Origin's coordinate | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``coordinateID`` | int | ID of the Origin's coordinate | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``deliveryService`` | string | XML_ID of the Origin's delivery service | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``deliveryServiceId`` | int | ID of the Origin's delivery service | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``fqdn`` | string | The FQDN of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``id`` | int | Local unique identifier for the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``ip6Address`` | string | IPv6 address of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``ipAddress`` | string | IPv4 address of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``isPrimary`` | boolean | Whether or not this is the primary Origin for the delivery service | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``lastUpdated`` | string | The Time / Date this entry was last updated | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``name`` | string | The name of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``port`` | int | The TCP port on which the Origin listens | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``profile`` | string | The profile name of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``profileId`` | int | The profile ID of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``protocol`` | string | The protocol of the Origin's URL (http or https) | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``tenant`` | string | The tenant name of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``tenantId`` | int | The tenant ID of the Origin | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``alerts`` | array | A collection of alert messages. | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``>level`` | string | Success, info, warning or error. | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| | ``>text`` | string | Alert message. | |
| +-----------------------------------+-------------------+--------------------------------------------------------------------------+ |
| |
| **Response Example** :: |
| |
| { |
| "alerts": [ |
| { |
| "level": "success", |
| "text": "origin was updated." |
| } |
| ], |
| "response": { |
| "cachegroup": null, |
| "cachegroupId": 1, |
| "coordinate": null, |
| "coordinateId": 1, |
| "deliveryService": null, |
| "deliveryServiceId": 1, |
| "fqdn": "foo.example.com", |
| "id": 1, |
| "ip6Address": "cafe:dead:d0d0::42", |
| "ipAddress": "10.2.3.4", |
| "isPrimary": false, |
| "lastUpdated": "2018-05-08 20:30:27+00", |
| "name": "origin1", |
| "port": 443, |
| "profile": null, |
| "profileId": 1, |
| "protocol": "https", |
| "tenant": null, |
| "tenantId": 1 |
| } |
| } |
| |
| | |
| |
| **DELETE /api/1.3/origin** |
| |
| Delete origin. |
| |
| Authentication Required: Yes |
| |
| Role(s) Required: admin or oper |
| |
| **Request Query Parameters** |
| |
| +------+----------+--------------------------------------+ |
| | Name | Required | Description | |
| +======+==========+======================================+ |
| | id | yes | The id of the origin to delete. | |
| +------+----------+--------------------------------------+ |
| |
| **Response Properties** |
| |
| +-------------+--------+----------------------------------+ |
| | Parameter | Type | Description | |
| +=============+========+==================================+ |
| | ``alerts`` | array | A collection of alert messages. | |
| +-------------+--------+----------------------------------+ |
| | ``>level`` | string | Success, info, warning or error. | |
| +-------------+--------+----------------------------------+ |
| | ``>text`` | string | Alert message. | |
| +-------------+--------+----------------------------------+ |
| |
| **Response Example** :: |
| |
| { |
| "alerts": [ |
| { |
| "level": "success", |
| "text": "origin was deleted" |
| } |
| ] |
| } |
| |
| | |
| |