| .. |
| .. |
| .. 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-v2-deliveryservice-requests: |
| |
| **************************** |
| ``deliveryservice_requests`` |
| **************************** |
| |
| ``GET`` |
| ======= |
| Retrieves :ref:`ds_requests`. |
| |
| :Auth. Required: Yes |
| :Roles Required: None |
| :Response Type: Array |
| |
| Request Structure |
| ----------------- |
| .. table:: Request Query Parameters |
| |
| +-----------+----------+-----------------------------------------------------------------------------------------------------------------------------------------+ |
| | Name | Required | Description | |
| +===========+==========+=========================================================================================================================================+ |
| | assignee | no | Filter for :ref:`ds_requests` that are assigned to the user identified by this username. | |
| +-----------+----------+-----------------------------------------------------------------------------------------------------------------------------------------+ |
| | assigneeId| no | Filter for :ref:`ds_requests` that are assigned to the user identified by this integral, unique identifier | |
| +-----------+----------+-----------------------------------------------------------------------------------------------------------------------------------------+ |
| | author | no | Filter for :ref:`ds_requests` submitted by the user identified by this username | |
| +-----------+----------+-----------------------------------------------------------------------------------------------------------------------------------------+ |
| | authorId | no | Filter for :ref:`ds_requests` submitted by the user identified by this integral, unique identifier | |
| +-----------+----------+-----------------------------------------------------------------------------------------------------------------------------------------+ |
| | changeType| no | Filter for :ref:`ds_requests` of the change type specified. Can be ``create``, ``update``, or ``delete``. | |
| +-----------+----------+-----------------------------------------------------------------------------------------------------------------------------------------+ |
| | createdAt | no | Filter for :ref:`ds_requests` created on a certain date/time. Value must be :rfc:`3339` compliant. Eg. ``2019-09-19T19:35:38.828535Z`` | |
| +-----------+----------+-----------------------------------------------------------------------------------------------------------------------------------------+ |
| | id | no | Filter for the :ref:`Delivery Service Request <ds_requests>` identified by this integral, unique identifier. | |
| +-----------+----------+-----------------------------------------------------------------------------------------------------------------------------------------+ |
| | status | no | Filter for :ref:`ds_requests` whose status is the status specified. The status can be ``draft``, ``submitted``, ``pending``, | |
| | | | ``rejected``, or ``complete``. | |
| +-----------+----------+-----------------------------------------------------------------------------------------------------------------------------------------+ |
| | xmlId | no | Filter for :ref:`ds_requests` that have the given :ref:`ds-xmlid`. | |
| +-----------+----------+-----------------------------------------------------------------------------------------------------------------------------------------+ |
| | orderby | no | Choose the ordering of the results - must be the name of one of the fields of the objects in the ``response`` | |
| | | | array | |
| +-----------+----------+-----------------------------------------------------------------------------------------------------------------------------------------+ |
| | sortOrder | no | Changes the order of sorting. Either ascending (default or "asc") or descending ("desc") | |
| +-----------+----------+-----------------------------------------------------------------------------------------------------------------------------------------+ |
| | limit | no | Choose the maximum number of results to return | |
| +-----------+----------+-----------------------------------------------------------------------------------------------------------------------------------------+ |
| | offset | no | The number of results to skip before beginning to return results. Must use in conjunction with limit | |
| +-----------+----------+-----------------------------------------------------------------------------------------------------------------------------------------+ |
| | page | no | Return the n\ :sup:`th` page of results, where "n" is the value of this parameter, pages are ``limit`` long and the first page is 1. | |
| | | | If ``offset`` was defined, this query parameter has no effect. ``limit`` must be defined to make use of ``page``. | |
| +-----------+----------+-----------------------------------------------------------------------------------------------------------------------------------------+ |
| |
| .. versionadded:: ATCv6 |
| The ``createdAt`` query parameter was added to this in endpoint across all API versions in :abbr:`ATC (Apache Traffic Control)` version 6.0.0. |
| |
| .. code-block:: http |
| :caption: Request Example |
| |
| GET /api/2.0/deliveryservice_requests?status=draft HTTP/1.1 |
| User-Agent: python-requests/2.22.0 |
| Accept-Encoding: gzip, deflate |
| Accept: */* |
| Connection: keep-alive |
| Cookie: mojolicious=... |
| |
| Response Structure |
| ------------------ |
| :author: The username of the user who created the Delivery Service Request. |
| :authorId: The integral, unique identifier assigned to the author |
| :changeType: The change type of the :term:`DSR <Delivery Service Request>`. It can be ``create``, ``update``, or ``delete``.... |
| :createdAt: The date and time at which the :term:`DSR <Delivery Service Request>` was created, in :ref:`non-rfc-datetime`. |
| :deliveryService: The delivery service that the :term:`DSR <Delivery Service Request>` is requesting to update. |
| |
| :active: A boolean that defines :ref:`ds-active`. |
| :anonymousBlockingEnabled: A boolean that defines :ref:`ds-anonymous-blocking` |
| :cacheurl: A :ref:`ds-cacheurl` |
| |
| .. deprecated:: ATCv3.0 |
| This field has been deprecated in Traffic Control 3.x and is subject to removal in Traffic Control 4.x or later |
| |
| :ccrDnsTtl: The :ref:`ds-dns-ttl` - named "ccrDnsTtl" for legacy reasons |
| :cdnId: The integral, unique identifier of the :ref:`ds-cdn` to which the :term:`Delivery Service` belongs |
| :cdnName: Name of the :ref:`ds-cdn` to which the :term:`Delivery Service` belongs |
| :checkPath: A :ref:`ds-check-path` |
| :consistentHashQueryParams: An array of :ref:`ds-consistent-hashing-qparams` |
| :consistentHashRegex: A :ref:`ds-consistent-hashing-regex` |
| :deepCachingType: The :ref:`ds-deep-caching` setting for this :term:`Delivery Service` |
| :displayName: The :ref:`ds-display-name` |
| :dnsBypassCname: A :ref:`ds-dns-bypass-cname` |
| :dnsBypassIp: A :ref:`ds-dns-bypass-ip` |
| :dnsBypassIp6: A :ref:`ds-dns-bypass-ipv6` |
| :dnsBypassTtl: The :ref:`ds-dns-bypass-ttl` |
| :dscp: A :ref:`ds-dscp` to be used within the :term:`Delivery Service` |
| :ecsEnabled: A boolean that defines the :ref:`ds-ecs` setting on this :term:`Delivery Service` |
| :edgeHeaderRewrite: A set of :ref:`ds-edge-header-rw-rules` |
| :exampleURLs: An array of :ref:`ds-example-urls` |
| :fqPacingRate: The :ref:`ds-fqpr` |
| :geoLimit: An integer that defines the :ref:`ds-geo-limit` |
| :geoLimitCountries: A string containing a comma-separated list defining the :ref:`ds-geo-limit-countries`\ [#geolimit]_ |
| :geoLimitRedirectUrl: A :ref:`ds-geo-limit-redirect-url`\ [#geolimit]_ |
| :geoProvider: The :ref:`ds-geo-provider` |
| :globalMaxMbps: The :ref:`ds-global-max-mbps` |
| :globalMaxTps: The :ref:`ds-global-max-tps` |
| :httpBypassFqdn: A :ref:`ds-http-bypass-fqdn` |
| :id: An integral, unique identifier for this :term:`Delivery Service` |
| :infoUrl: An :ref:`ds-info-url` |
| :initialDispersion: The :ref:`ds-initial-dispersion` |
| :ipv6RoutingEnabled: A boolean that defines the :ref:`ds-ipv6-routing` setting on this :term:`Delivery Service` |
| :lastUpdated: The date and time at which this :term:`Delivery Service` was last updated, in :ref:`non-rfc-datetime` |
| :logsEnabled: A boolean that defines the :ref:`ds-logs-enabled` setting on this :term:`Delivery Service` |
| :longDesc: The :ref:`ds-longdesc` of this :term:`Delivery Service` |
| :longDesc1: An optional field containing the 2nd long description of this :term:`Delivery Service` |
| :longDesc2: An optional field containing the 3rd long description of this :term:`Delivery Service` |
| :matchList: The :term:`Delivery Service`'s :ref:`ds-matchlist` |
| |
| :pattern: A regular expression - the use of this pattern is dependent on the ``type`` field (backslashes are escaped) |
| :setNumber: An integer that provides explicit ordering of :ref:`ds-matchlist` items - this is used as a priority ranking by Traffic Router, and is not guaranteed to correspond to the ordering of items in the array. |
| :type: The type of match performed using ``pattern``. |
| |
| :maxDnsAnswers: The :ref:`ds-max-dns-answers` allowed for this :term:`Delivery Service` |
| :maxOriginConnections: The :ref:`ds-max-origin-connections` |
| :midHeaderRewrite: A set of :ref:`ds-mid-header-rw-rules` |
| :missLat: The :ref:`ds-geo-miss-default-latitude` used by this :term:`Delivery Service` |
| :missLong: The :ref:`ds-geo-miss-default-longitude` used by this :term:`Delivery Service` |
| :multiSiteOrigin: A boolean that defines the use of :ref:`ds-multi-site-origin` by this :term:`Delivery Service` |
| :orgServerFqdn: The :ref:`ds-origin-url` |
| :originShield: A :ref:`ds-origin-shield` string |
| :profileDescription: The :ref:`profile-description` of the :ref:`ds-profile` with which this :term:`Delivery Service` is associated |
| :profileId: An optional :ref:`profile-id` of a :ref:`ds-profile` with which this :term:`Delivery Service` shall be associated |
| :profileName: The :ref:`profile-name` of the :ref:`ds-profile` with which this :term:`Delivery Service` is associated |
| :protocol: An integral, unique identifier that corresponds to the :ref:`ds-protocol` used by this :term:`Delivery Service` |
| :qstringIgnore: An integral, unique identifier that corresponds to the :ref:`ds-qstring-handling` setting on this :term:`Delivery Service` |
| :rangeRequestHandling: An integral, unique identifier that corresponds to the :ref:`ds-range-request-handling` setting on this :term:`Delivery Service` |
| :regexRemap: A :ref:`ds-regex-remap` |
| :regionalGeoBlocking: A boolean defining the :ref:`ds-regionalgeo` setting on this :term:`Delivery Service` |
| :remapText: :ref:`ds-raw-remap` |
| :routingName: The :ref:`ds-routing-name` of this :term:`Delivery Service` |
| :signed: ``true`` if and only if ``signingAlgorithm`` is not ``null``, ``false`` otherwise |
| :signingAlgorithm: Either a :ref:`ds-signing-algorithm` or ``null`` to indicate URL/URI signing is not implemented on this :term:`Delivery Service` |
| :sslKeyVersion: This integer indicates the :ref:`ds-ssl-key-version` |
| :tenant: The name of the :term:`Tenant` who owns this :term:`Origin` |
| :tenantId: The integral, unique identifier of the :ref:`ds-tenant` who owns this :term:`Delivery Service` |
| :trRequestHeaders: If defined, this defines the :ref:`ds-tr-req-headers` used by Traffic Router for this :term:`Delivery Service` |
| :trResponseHeaders: If defined, this defines the :ref:`ds-tr-resp-headers` used by Traffic Router for this :term:`Delivery Service` |
| :type: The :ref:`ds-types` of this :term:`Delivery Service` |
| :typeId: The integral, unique identifier of the :ref:`ds-types` of this :term:`Delivery Service` |
| :xmlId: This :term:`Delivery Service`'s :ref:`ds-xmlid` |
| |
| :id: The integral, unique identifier assigned to the :term:`DSR <Delivery Service Request>` |
| :lastEditedBy: The username of user who last edited this :term:`DSR <Delivery Service Request>` |
| :lastEditedById: The integral, unique identifier assigned to the user who last edited this :term:`DSR <Delivery Service Request>` |
| :lastUpdated: The date and time at which the :term:`DSR <Delivery Service Request>` was last updated, in :ref:`non-rfc-datetime`. |
| :status: The status of the request. Can be "draft", "submitted", "rejected", "pending", or "complete". |
| |
| .. code-block:: http |
| :caption: Response Example |
| |
| HTTP/1.1 200 OK |
| Access-Control-Allow-Credentials: true |
| Access-Control-Allow-Headers: Origin, X-Requested-With, Content-Type, Accept, Set-Cookie, Cookie |
| Access-Control-Allow-Methods: POST,GET,OPTIONS,PUT,DELETE |
| Access-Control-Allow-Origin: * |
| Content-Encoding: gzip |
| Content-Type: application/json |
| Set-Cookie: mojolicious=...; Path=/; Expires=Mon, 24 Feb 2020 20:14:07 GMT; Max-Age=3600; HttpOnly |
| Whole-Content-Sha512: UBp3nklJr2x2cAW/TKbhXMVJH6+OduxUaEBGbX4P7IahDk3VkaTd9LsQj01zgFEnZLwHrikpwFfNlUO32RAZOA== |
| X-Server-Name: traffic_ops_golang/ |
| Date: Mon, 24 Feb 2020 19:14:07 GMT |
| Content-Length: 872 |
| |
| { |
| "response": [ |
| { |
| "authorId": 2, |
| "author": "admin", |
| "changeType": "update", |
| "createdAt": "2020-02-24 19:11:12+00", |
| "id": 1, |
| "lastEditedBy": "admin", |
| "lastEditedById": 2, |
| "lastUpdated": "2020-02-24 19:11:12+00", |
| "deliveryService": { |
| "active": false, |
| "anonymousBlockingEnabled": false, |
| "cacheurl": null, |
| "ccrDnsTtl": null, |
| "cdnId": 2, |
| "cdnName": "CDN-in-a-Box", |
| "checkPath": null, |
| "displayName": "Demo 1", |
| "dnsBypassCname": null, |
| "dnsBypassIp": null, |
| "dnsBypassIp6": null, |
| "dnsBypassTtl": null, |
| "dscp": 0, |
| "edgeHeaderRewrite": null, |
| "geoLimit": 0, |
| "geoLimitCountries": null, |
| "geoLimitRedirectURL": null, |
| "geoProvider": 0, |
| "globalMaxMbps": null, |
| "globalMaxTps": null, |
| "httpBypassFqdn": null, |
| "id": 1, |
| "infoUrl": null, |
| "initialDispersion": 1, |
| "ipv6RoutingEnabled": true, |
| "lastUpdated": "0001-01-01 00:00:00+00", |
| "logsEnabled": true, |
| "longDesc": "Apachecon North America 2018", |
| "longDesc1": null, |
| "longDesc2": null, |
| "matchList": [ |
| { |
| "type": "HOST_REGEXP", |
| "setNumber": 0, |
| "pattern": ".*\\.demo1\\..*" |
| } |
| ], |
| "maxDnsAnswers": null, |
| "midHeaderRewrite": null, |
| "missLat": 42, |
| "missLong": -88, |
| "multiSiteOrigin": false, |
| "originShield": null, |
| "orgServerFqdn": "http://origin.infra.ciab.test", |
| "profileDescription": null, |
| "profileId": null, |
| "profileName": null, |
| "protocol": 2, |
| "qstringIgnore": 0, |
| "rangeRequestHandling": 0, |
| "regexRemap": null, |
| "regionalGeoBlocking": false, |
| "remapText": null, |
| "routingName": "video", |
| "signed": false, |
| "sslKeyVersion": 1, |
| "tenantId": 1, |
| "type": "HTTP", |
| "typeId": 1, |
| "xmlId": "demo1", |
| "exampleURLs": [ |
| "http://video.demo1.mycdn.ciab.test", |
| "https://video.demo1.mycdn.ciab.test" |
| ], |
| "deepCachingType": "NEVER", |
| "fqPacingRate": null, |
| "signingAlgorithm": null, |
| "tenant": "root", |
| "trResponseHeaders": null, |
| "trRequestHeaders": null, |
| "consistentHashRegex": null, |
| "consistentHashQueryParams": [ |
| "abc", |
| "pdq", |
| "xxx", |
| "zyx" |
| ], |
| "maxOriginConnections": 0, |
| "ecsEnabled": false |
| }, |
| "status": "draft" |
| } |
| ] |
| } |
| |
| .. _to-api-v2-deliveryservice-requests-post: |
| |
| ``POST`` |
| ======== |
| |
| .. note:: This route does NOT do the same thing as :ref:`POST deliveryservices/request <to-api-v2-deliveryservices-request>`. |
| |
| Creates a new :term:`Delivery Service Request`. |
| |
| :Auth. Required: Yes |
| :Roles Required: "admin", "Federation", "operations", "Portal", or "Steering" |
| :Response Type: Object |
| |
| Request Structure |
| ----------------- |
| :changeType: The action that you want to perform on the delivery service. It can be "create", "update", or "delete". |
| :status: The status of your request. Can be "draft", "submitted", "rejected", "pending", or "complete". |
| :deliveryService: The :term:`Delivery Service` that you have submitted for review as part of this request. |
| |
| :active: A boolean that defines :ref:`ds-active`. |
| :anonymousBlockingEnabled: A boolean that defines :ref:`ds-anonymous-blocking` |
| :cacheurl: A :ref:`ds-cacheurl` |
| |
| .. deprecated:: ATCv3.0 |
| This field has been deprecated in Traffic Control 3.x and is subject to removal in Traffic Control 4.x or later |
| |
| :ccrDnsTtl: The :ref:`ds-dns-ttl` - named "ccrDnsTtl" for legacy reasons |
| :cdnId: The integral, unique identifier of the :ref:`ds-cdn` to which the :term:`Delivery Service` belongs |
| :cdnName: Name of the :ref:`ds-cdn` to which the :term:`Delivery Service` belongs |
| :checkPath: A :ref:`ds-check-path` |
| :consistentHashQueryParams: An array of :ref:`ds-consistent-hashing-qparams` |
| :consistentHashRegex: A :ref:`ds-consistent-hashing-regex` |
| :deepCachingType: The :ref:`ds-deep-caching` setting for this :term:`Delivery Service` |
| :displayName: The :ref:`ds-display-name` |
| :dnsBypassCname: A :ref:`ds-dns-bypass-cname` |
| :dnsBypassIp: A :ref:`ds-dns-bypass-ip` |
| :dnsBypassIp6: A :ref:`ds-dns-bypass-ipv6` |
| :dnsBypassTtl: The :ref:`ds-dns-bypass-ttl` |
| :dscp: A :ref:`ds-dscp` to be used within the :term:`Delivery Service` |
| :ecsEnabled: A boolean that defines the :ref:`ds-ecs` setting on this :term:`Delivery Service` |
| :edgeHeaderRewrite: A set of :ref:`ds-edge-header-rw-rules` |
| :exampleURLs: An array of :ref:`ds-example-urls` |
| :fqPacingRate: The :ref:`ds-fqpr` |
| :geoLimit: An integer that defines the :ref:`ds-geo-limit` |
| :geoLimitCountries: A string containing a comma-separated list defining the :ref:`ds-geo-limit-countries`\ [#geolimit]_ |
| :geoLimitRedirectUrl: A :ref:`ds-geo-limit-redirect-url`\ [#geolimit]_ |
| :geoProvider: The :ref:`ds-geo-provider` |
| :globalMaxMbps: The :ref:`ds-global-max-mbps` |
| :globalMaxTps: The :ref:`ds-global-max-tps` |
| :httpBypassFqdn: A :ref:`ds-http-bypass-fqdn` |
| :id: An integral, unique identifier for this :term:`Delivery Service` |
| :infoUrl: An :ref:`ds-info-url` |
| :initialDispersion: The :ref:`ds-initial-dispersion` |
| :ipv6RoutingEnabled: A boolean that defines the :ref:`ds-ipv6-routing` setting on this :term:`Delivery Service` |
| :lastUpdated: The date and time at which this :term:`Delivery Service` was last updated, in :ref:`non-rfc-datetime` |
| :logsEnabled: A boolean that defines the :ref:`ds-logs-enabled` setting on this :term:`Delivery Service` |
| :longDesc: The :ref:`ds-longdesc` of this :term:`Delivery Service` |
| :longDesc1: An optional field containing the 2nd long description of this :term:`Delivery Service` |
| :longDesc2: An optional field containing the 3rd long description of this :term:`Delivery Service` |
| :matchList: The :term:`Delivery Service`'s :ref:`ds-matchlist` |
| |
| :pattern: A regular expression - the use of this pattern is dependent on the ``type`` field (backslashes are escaped) |
| :setNumber: An integer that provides explicit ordering of :ref:`ds-matchlist` items - this is used as a priority ranking by Traffic Router, and is not guaranteed to correspond to the ordering of items in the array. |
| :type: The type of match performed using ``pattern``. |
| |
| :maxDnsAnswers: The :ref:`ds-max-dns-answers` allowed for this :term:`Delivery Service` |
| :maxOriginConnections: The :ref:`ds-max-origin-connections` |
| :midHeaderRewrite: A set of :ref:`ds-mid-header-rw-rules` |
| :missLat: The :ref:`ds-geo-miss-default-latitude` used by this :term:`Delivery Service` |
| :missLong: The :ref:`ds-geo-miss-default-longitude` used by this :term:`Delivery Service` |
| :multiSiteOrigin: A boolean that defines the use of :ref:`ds-multi-site-origin` by this :term:`Delivery Service` |
| :orgServerFqdn: The :ref:`ds-origin-url` |
| :originShield: A :ref:`ds-origin-shield` string |
| :profileDescription: The :ref:`profile-description` of the :ref:`ds-profile` with which this :term:`Delivery Service` is associated |
| :profileId: An optional :ref:`profile-id` of a :ref:`ds-profile` with which this :term:`Delivery Service` shall be associated |
| :profileName: The :ref:`profile-name` of the :ref:`ds-profile` with which this :term:`Delivery Service` is associated |
| :protocol: An integral, unique identifier that corresponds to the :ref:`ds-protocol` used by this :term:`Delivery Service` |
| :qstringIgnore: An integral, unique identifier that corresponds to the :ref:`ds-qstring-handling` setting on this :term:`Delivery Service` |
| :rangeRequestHandling: An integral, unique identifier that corresponds to the :ref:`ds-range-request-handling` setting on this :term:`Delivery Service` |
| :regexRemap: A :ref:`ds-regex-remap` |
| :regionalGeoBlocking: A boolean defining the :ref:`ds-regionalgeo` setting on this :term:`Delivery Service` |
| :remapText: :ref:`ds-raw-remap` |
| :routingName: The :ref:`ds-routing-name` of this :term:`Delivery Service` |
| :signed: ``true`` if and only if ``signingAlgorithm`` is not ``null``, ``false`` otherwise |
| :signingAlgorithm: Either a :ref:`ds-signing-algorithm` or ``null`` to indicate URL/URI signing is not implemented on this :term:`Delivery Service` |
| :sslKeyVersion: This integer indicates the :ref:`ds-ssl-key-version` |
| :tenant: The name of the :term:`Tenant` who owns this :term:`Origin` |
| :tenantId: The integral, unique identifier of the :ref:`ds-tenant` who owns this :term:`Delivery Service` |
| :trRequestHeaders: If defined, this defines the :ref:`ds-tr-req-headers` used by Traffic Router for this :term:`Delivery Service` |
| :trResponseHeaders: If defined, this defines the :ref:`ds-tr-resp-headers` used by Traffic Router for this :term:`Delivery Service` |
| :type: The :ref:`ds-types` of this :term:`Delivery Service` |
| :typeId: The integral, unique identifier of the :ref:`ds-types` of this :term:`Delivery Service` |
| :xmlId: This :term:`Delivery Service`'s :ref:`ds-xmlid` |
| |
| .. code-block:: http |
| :caption: Request Example |
| |
| POST /api/2.0/deliveryservice_requests HTTP/1.1 |
| User-Agent: python-requests/2.22.0 |
| Accept-Encoding: gzip, deflate |
| Accept: */* |
| Connection: keep-alive |
| Cookie: mojolicious=... |
| Content-Length: 1979 |
| |
| { |
| "changeType": "update", |
| "status": "draft", |
| "deliveryService": { |
| "active": false, |
| "anonymousBlockingEnabled": false, |
| "cacheurl": null, |
| "ccrDnsTtl": null, |
| "cdnId": 2, |
| "cdnName": "CDN-in-a-Box", |
| "checkPath": null, |
| "displayName": "Demo 1", |
| "dnsBypassCname": null, |
| "dnsBypassIp": null, |
| "dnsBypassIp6": null, |
| "dnsBypassTtl": null, |
| "dscp": 0, |
| "edgeHeaderRewrite": null, |
| "geoLimit": 0, |
| "geoLimitCountries": null, |
| "geoLimitRedirectURL": null, |
| "geoProvider": 0, |
| "globalMaxMbps": null, |
| "globalMaxTps": null, |
| "httpBypassFqdn": null, |
| "id": 1, |
| "infoUrl": null, |
| "initialDispersion": 1, |
| "ipv6RoutingEnabled": true, |
| "lastUpdated": "2020-02-13 16:43:54+00", |
| "logsEnabled": true, |
| "longDesc": "Apachecon North America 2018", |
| "longDesc1": null, |
| "longDesc2": null, |
| "matchList": [ |
| { |
| "type": "HOST_REGEXP", |
| "setNumber": 0, |
| "pattern": ".*\\.demo1\\..*" |
| } |
| ], |
| "maxDnsAnswers": null, |
| "midHeaderRewrite": null, |
| "missLat": 42, |
| "missLong": -88, |
| "multiSiteOrigin": false, |
| "originShield": null, |
| "orgServerFqdn": "http://origin.infra.ciab.test", |
| "profileDescription": null, |
| "profileId": null, |
| "profileName": null, |
| "protocol": 2, |
| "qstringIgnore": 0, |
| "rangeRequestHandling": 0, |
| "regexRemap": null, |
| "regionalGeoBlocking": false, |
| "remapText": null, |
| "routingName": "video", |
| "signed": false, |
| "sslKeyVersion": 1, |
| "tenantId": 1, |
| "type": "HTTP", |
| "typeId": 1, |
| "xmlId": "demo1", |
| "exampleURLs": [ |
| "http://video.demo1.mycdn.ciab.test", |
| "https://video.demo1.mycdn.ciab.test" |
| ], |
| "deepCachingType": "NEVER", |
| "fqPacingRate": null, |
| "signingAlgorithm": null, |
| "tenant": "root", |
| "trResponseHeaders": null, |
| "trRequestHeaders": null, |
| "consistentHashRegex": null, |
| "consistentHashQueryParams": [ |
| "abc", |
| "pdq", |
| "xxx", |
| "zyx" |
| ], |
| "maxOriginConnections": 0, |
| "ecsEnabled": false |
| } |
| } |
| |
| |
| Response Structure |
| ------------------ |
| :author: The username of the user who created the Delivery Service Request. |
| :authorId: The integral, unique identifier assigned to the author |
| :changeType: The change type of the :term:`DSR <Delivery Service Request>`. It can be ``create``, ``update``, or ``delete``.... |
| :createdAt: The date and time at which the :term:`DSR <Delivery Service Request>` was created, in :ref:`non-rfc-datetime`. |
| :deliveryService: The delivery service that the :term:`DSR <Delivery Service Request>` is requesting to update. |
| |
| :active: A boolean that defines :ref:`ds-active`. |
| :anonymousBlockingEnabled: A boolean that defines :ref:`ds-anonymous-blocking` |
| :cacheurl: A :ref:`ds-cacheurl` |
| |
| .. deprecated:: ATCv3.0 |
| This field has been deprecated in Traffic Control 3.x and is subject to removal in Traffic Control 4.x or later |
| |
| :ccrDnsTtl: The :ref:`ds-dns-ttl` - named "ccrDnsTtl" for legacy reasons |
| :cdnId: The integral, unique identifier of the :ref:`ds-cdn` to which the :term:`Delivery Service` belongs |
| :cdnName: Name of the :ref:`ds-cdn` to which the :term:`Delivery Service` belongs |
| :checkPath: A :ref:`ds-check-path` |
| :consistentHashQueryParams: An array of :ref:`ds-consistent-hashing-qparams` |
| :consistentHashRegex: A :ref:`ds-consistent-hashing-regex` |
| :deepCachingType: The :ref:`ds-deep-caching` setting for this :term:`Delivery Service` |
| :displayName: The :ref:`ds-display-name` |
| :dnsBypassCname: A :ref:`ds-dns-bypass-cname` |
| :dnsBypassIp: A :ref:`ds-dns-bypass-ip` |
| :dnsBypassIp6: A :ref:`ds-dns-bypass-ipv6` |
| :dnsBypassTtl: The :ref:`ds-dns-bypass-ttl` |
| :dscp: A :ref:`ds-dscp` to be used within the :term:`Delivery Service` |
| :ecsEnabled: A boolean that defines the :ref:`ds-ecs` setting on this :term:`Delivery Service` |
| :edgeHeaderRewrite: A set of :ref:`ds-edge-header-rw-rules` |
| :exampleURLs: An array of :ref:`ds-example-urls` |
| :fqPacingRate: The :ref:`ds-fqpr` |
| :geoLimit: An integer that defines the :ref:`ds-geo-limit` |
| :geoLimitCountries: A string containing a comma-separated list defining the :ref:`ds-geo-limit-countries`\ [#geolimit]_ |
| :geoLimitRedirectUrl: A :ref:`ds-geo-limit-redirect-url`\ [#geolimit]_ |
| :geoProvider: The :ref:`ds-geo-provider` |
| :globalMaxMbps: The :ref:`ds-global-max-mbps` |
| :globalMaxTps: The :ref:`ds-global-max-tps` |
| :httpBypassFqdn: A :ref:`ds-http-bypass-fqdn` |
| :id: An integral, unique identifier for this :term:`Delivery Service` |
| :infoUrl: An :ref:`ds-info-url` |
| :initialDispersion: The :ref:`ds-initial-dispersion` |
| :ipv6RoutingEnabled: A boolean that defines the :ref:`ds-ipv6-routing` setting on this :term:`Delivery Service` |
| :lastUpdated: The date and time at which this :term:`Delivery Service` was last updated, in :ref:`non-rfc-datetime` |
| :logsEnabled: A boolean that defines the :ref:`ds-logs-enabled` setting on this :term:`Delivery Service` |
| :longDesc: The :ref:`ds-longdesc` of this :term:`Delivery Service` |
| :longDesc1: An optional field containing the 2nd long description of this :term:`Delivery Service` |
| :longDesc2: An optional field containing the 3rd long description of this :term:`Delivery Service` |
| :matchList: The :term:`Delivery Service`'s :ref:`ds-matchlist` |
| |
| :pattern: A regular expression - the use of this pattern is dependent on the ``type`` field (backslashes are escaped) |
| :setNumber: An integer that provides explicit ordering of :ref:`ds-matchlist` items - this is used as a priority ranking by Traffic Router, and is not guaranteed to correspond to the ordering of items in the array. |
| :type: The type of match performed using ``pattern``. |
| |
| :maxDnsAnswers: The :ref:`ds-max-dns-answers` allowed for this :term:`Delivery Service` |
| :maxOriginConnections: The :ref:`ds-max-origin-connections` |
| :midHeaderRewrite: A set of :ref:`ds-mid-header-rw-rules` |
| :missLat: The :ref:`ds-geo-miss-default-latitude` used by this :term:`Delivery Service` |
| :missLong: The :ref:`ds-geo-miss-default-longitude` used by this :term:`Delivery Service` |
| :multiSiteOrigin: A boolean that defines the use of :ref:`ds-multi-site-origin` by this :term:`Delivery Service` |
| :orgServerFqdn: The :ref:`ds-origin-url` |
| :originShield: A :ref:`ds-origin-shield` string |
| :profileDescription: The :ref:`profile-description` of the :ref:`ds-profile` with which this :term:`Delivery Service` is associated |
| :profileId: An optional :ref:`profile-id` of a :ref:`ds-profile` with which this :term:`Delivery Service` shall be associated |
| :profileName: The :ref:`profile-name` of the :ref:`ds-profile` with which this :term:`Delivery Service` is associated |
| :protocol: An integral, unique identifier that corresponds to the :ref:`ds-protocol` used by this :term:`Delivery Service` |
| :qstringIgnore: An integral, unique identifier that corresponds to the :ref:`ds-qstring-handling` setting on this :term:`Delivery Service` |
| :rangeRequestHandling: An integral, unique identifier that corresponds to the :ref:`ds-range-request-handling` setting on this :term:`Delivery Service` |
| :regexRemap: A :ref:`ds-regex-remap` |
| :regionalGeoBlocking: A boolean defining the :ref:`ds-regionalgeo` setting on this :term:`Delivery Service` |
| :remapText: :ref:`ds-raw-remap` |
| :routingName: The :ref:`ds-routing-name` of this :term:`Delivery Service` |
| :signed: ``true`` if and only if ``signingAlgorithm`` is not ``null``, ``false`` otherwise |
| :signingAlgorithm: Either a :ref:`ds-signing-algorithm` or ``null`` to indicate URL/URI signing is not implemented on this :term:`Delivery Service` |
| :sslKeyVersion: This integer indicates the :ref:`ds-ssl-key-version` |
| :tenant: The name of the :term:`Tenant` who owns this :term:`Origin` |
| :tenantId: The integral, unique identifier of the :ref:`ds-tenant` who owns this :term:`Delivery Service` |
| :trRequestHeaders: If defined, this defines the :ref:`ds-tr-req-headers` used by Traffic Router for this :term:`Delivery Service` |
| :trResponseHeaders: If defined, this defines the :ref:`ds-tr-resp-headers` used by Traffic Router for this :term:`Delivery Service` |
| :type: The :ref:`ds-types` of this :term:`Delivery Service` |
| :typeId: The integral, unique identifier of the :ref:`ds-types` of this :term:`Delivery Service` |
| :xmlId: This :term:`Delivery Service`'s :ref:`ds-xmlid` |
| |
| :id: The integral, unique identifier assigned to the :term:`DSR <Delivery Service Request>` |
| :lastEditedBy: The username of user who last edited this :term:`DSR <Delivery Service Request>` |
| :lastEditedById: The integral, unique identifier assigned to the user who last edited this :term:`DSR <Delivery Service Request>` |
| :lastUpdated: The date and time at which the :term:`DSR <Delivery Service Request>` was last updated, in :ref:`non-rfc-datetime`. |
| :status: The status of the request. Can be "draft", "submitted", "rejected", "pending", or "complete". |
| |
| .. code-block:: http |
| :caption: Response Example |
| |
| HTTP/1.1 200 OK |
| Access-Control-Allow-Credentials: true |
| Access-Control-Allow-Headers: Origin, X-Requested-With, Content-Type, Accept, Set-Cookie, Cookie |
| Access-Control-Allow-Methods: POST,GET,OPTIONS,PUT,DELETE |
| Access-Control-Allow-Origin: * |
| Content-Encoding: gzip |
| Content-Type: application/json |
| Set-Cookie: mojolicious=...; Path=/; Expires=Mon, 24 Feb 2020 20:11:12 GMT; Max-Age=3600; HttpOnly |
| Whole-Content-Sha512: aWIrFTwUGnLq56WNZPL/FgOi/NwAVUtOy4iqjFPwx4gj7RMZ6+nd++bQKIiasBl8ytAY0WmFvNnmm30Fq9mLpA== |
| X-Server-Name: traffic_ops_golang/ |
| Date: Mon, 24 Feb 2020 19:11:12 GMT |
| Content-Length: 901 |
| |
| { |
| "alerts": [ |
| { |
| "text": "deliveryservice_request was created.", |
| "level": "success" |
| } |
| ], |
| "response": { |
| "authorId": 2, |
| "author": null, |
| "changeType": "update", |
| "createdAt": null, |
| "id": 1, |
| "lastEditedBy": null, |
| "lastEditedById": 2, |
| "lastUpdated": "2020-02-24 19:11:12+00", |
| "deliveryService": { |
| "active": false, |
| "anonymousBlockingEnabled": false, |
| "cacheurl": null, |
| "ccrDnsTtl": null, |
| "cdnId": 2, |
| "cdnName": "CDN-in-a-Box", |
| "checkPath": null, |
| "displayName": "Demo 1", |
| "dnsBypassCname": null, |
| "dnsBypassIp": null, |
| "dnsBypassIp6": null, |
| "dnsBypassTtl": null, |
| "dscp": 0, |
| "edgeHeaderRewrite": null, |
| "geoLimit": 0, |
| "geoLimitCountries": null, |
| "geoLimitRedirectURL": null, |
| "geoProvider": 0, |
| "globalMaxMbps": null, |
| "globalMaxTps": null, |
| "httpBypassFqdn": null, |
| "id": 1, |
| "infoUrl": null, |
| "initialDispersion": 1, |
| "ipv6RoutingEnabled": true, |
| "lastUpdated": "0001-01-01 00:00:00+00", |
| "logsEnabled": true, |
| "longDesc": "Apachecon North America 2018", |
| "longDesc1": null, |
| "longDesc2": null, |
| "matchList": [ |
| { |
| "type": "HOST_REGEXP", |
| "setNumber": 0, |
| "pattern": ".*\\.demo1\\..*" |
| } |
| ], |
| "maxDnsAnswers": null, |
| "midHeaderRewrite": null, |
| "missLat": 42, |
| "missLong": -88, |
| "multiSiteOrigin": false, |
| "originShield": null, |
| "orgServerFqdn": "http://origin.infra.ciab.test", |
| "profileDescription": null, |
| "profileId": null, |
| "profileName": null, |
| "protocol": 2, |
| "qstringIgnore": 0, |
| "rangeRequestHandling": 0, |
| "regexRemap": null, |
| "regionalGeoBlocking": false, |
| "remapText": null, |
| "routingName": "video", |
| "signed": false, |
| "sslKeyVersion": 1, |
| "tenantId": 1, |
| "type": "HTTP", |
| "typeId": 1, |
| "xmlId": "demo1", |
| "exampleURLs": [ |
| "http://video.demo1.mycdn.ciab.test", |
| "https://video.demo1.mycdn.ciab.test" |
| ], |
| "deepCachingType": "NEVER", |
| "fqPacingRate": null, |
| "signingAlgorithm": null, |
| "tenant": "root", |
| "trResponseHeaders": null, |
| "trRequestHeaders": null, |
| "consistentHashRegex": null, |
| "consistentHashQueryParams": [ |
| "abc", |
| "pdq", |
| "xxx", |
| "zyx" |
| ], |
| "maxOriginConnections": 0, |
| "ecsEnabled": false |
| }, |
| "status": "draft" |
| } |
| } |
| |
| ``PUT`` |
| ======= |
| |
| Updates an existing :ref:`Delivery Service Request <ds_requests>`. |
| |
| :Auth. Required: Yes |
| :Roles Required: "admin", "Federation", "operations", "Portal", or "Steering" |
| :Response Type: Object |
| |
| Request Structure |
| ----------------- |
| :author: The username of the user who created the Delivery Service Request. |
| :authorId: The integral, unique identifier assigned to the author |
| :changeType: The change type of the :term:`DSR <Delivery Service Request>`. It can be ``create``, ``update``, or ``delete``.... |
| :deliveryService: The delivery service that the :term:`DSR <Delivery Service Request>` is requesting to update. |
| |
| :active: A boolean that defines :ref:`ds-active`. |
| :anonymousBlockingEnabled: A boolean that defines :ref:`ds-anonymous-blocking` |
| :cacheurl: A :ref:`ds-cacheurl` |
| |
| .. deprecated:: ATCv3.0 |
| This field has been deprecated in Traffic Control 3.x and is subject to removal in Traffic Control 4.x or later |
| |
| :ccrDnsTtl: The :ref:`ds-dns-ttl` - named "ccrDnsTtl" for legacy reasons |
| :cdnId: The integral, unique identifier of the :ref:`ds-cdn` to which the :term:`Delivery Service` belongs |
| :cdnName: Name of the :ref:`ds-cdn` to which the :term:`Delivery Service` belongs |
| :checkPath: A :ref:`ds-check-path` |
| :consistentHashQueryParams: An array of :ref:`ds-consistent-hashing-qparams` |
| :consistentHashRegex: A :ref:`ds-consistent-hashing-regex` |
| :deepCachingType: The :ref:`ds-deep-caching` setting for this :term:`Delivery Service` |
| :displayName: The :ref:`ds-display-name` |
| :dnsBypassCname: A :ref:`ds-dns-bypass-cname` |
| :dnsBypassIp: A :ref:`ds-dns-bypass-ip` |
| :dnsBypassIp6: A :ref:`ds-dns-bypass-ipv6` |
| :dnsBypassTtl: The :ref:`ds-dns-bypass-ttl` |
| :dscp: A :ref:`ds-dscp` to be used within the :term:`Delivery Service` |
| :ecsEnabled: A boolean that defines the :ref:`ds-ecs` setting on this :term:`Delivery Service` |
| :edgeHeaderRewrite: A set of :ref:`ds-edge-header-rw-rules` |
| :exampleURLs: An array of :ref:`ds-example-urls` |
| :fqPacingRate: The :ref:`ds-fqpr` |
| :geoLimit: An integer that defines the :ref:`ds-geo-limit` |
| :geoLimitCountries: A string containing a comma-separated list defining the :ref:`ds-geo-limit-countries`\ [#geolimit]_ |
| :geoLimitRedirectUrl: A :ref:`ds-geo-limit-redirect-url`\ [#geolimit]_ |
| :geoProvider: The :ref:`ds-geo-provider` |
| :globalMaxMbps: The :ref:`ds-global-max-mbps` |
| :globalMaxTps: The :ref:`ds-global-max-tps` |
| :httpBypassFqdn: A :ref:`ds-http-bypass-fqdn` |
| :id: An integral, unique identifier for this :term:`Delivery Service` |
| :infoUrl: An :ref:`ds-info-url` |
| :initialDispersion: The :ref:`ds-initial-dispersion` |
| :ipv6RoutingEnabled: A boolean that defines the :ref:`ds-ipv6-routing` setting on this :term:`Delivery Service` |
| :lastUpdated: The date and time at which this :term:`Delivery Service` was last updated, in :ref:`non-rfc-datetime` |
| :logsEnabled: A boolean that defines the :ref:`ds-logs-enabled` setting on this :term:`Delivery Service` |
| :longDesc: The :ref:`ds-longdesc` of this :term:`Delivery Service` |
| :longDesc1: An optional field containing the 2nd long description of this :term:`Delivery Service` |
| :longDesc2: An optional field containing the 3rd long description of this :term:`Delivery Service` |
| :matchList: The :term:`Delivery Service`'s :ref:`ds-matchlist` |
| |
| :pattern: A regular expression - the use of this pattern is dependent on the ``type`` field (backslashes are escaped) |
| :setNumber: An integer that provides explicit ordering of :ref:`ds-matchlist` items - this is used as a priority ranking by Traffic Router, and is not guaranteed to correspond to the ordering of items in the array. |
| :type: The type of match performed using ``pattern``. |
| |
| :maxDnsAnswers: The :ref:`ds-max-dns-answers` allowed for this :term:`Delivery Service` |
| :maxOriginConnections: The :ref:`ds-max-origin-connections` |
| :midHeaderRewrite: A set of :ref:`ds-mid-header-rw-rules` |
| :missLat: The :ref:`ds-geo-miss-default-latitude` used by this :term:`Delivery Service` |
| :missLong: The :ref:`ds-geo-miss-default-longitude` used by this :term:`Delivery Service` |
| :multiSiteOrigin: A boolean that defines the use of :ref:`ds-multi-site-origin` by this :term:`Delivery Service` |
| :orgServerFqdn: The :ref:`ds-origin-url` |
| :originShield: A :ref:`ds-origin-shield` string |
| :profileDescription: The :ref:`profile-description` of the :ref:`ds-profile` with which this :term:`Delivery Service` is associated |
| :profileId: An optional :ref:`profile-id` of a :ref:`ds-profile` with which this :term:`Delivery Service` shall be associated |
| :profileName: The :ref:`profile-name` of the :ref:`ds-profile` with which this :term:`Delivery Service` is associated |
| :protocol: An integral, unique identifier that corresponds to the :ref:`ds-protocol` used by this :term:`Delivery Service` |
| :qstringIgnore: An integral, unique identifier that corresponds to the :ref:`ds-qstring-handling` setting on this :term:`Delivery Service` |
| :rangeRequestHandling: An integral, unique identifier that corresponds to the :ref:`ds-range-request-handling` setting on this :term:`Delivery Service` |
| :regexRemap: A :ref:`ds-regex-remap` |
| :regionalGeoBlocking: A boolean defining the :ref:`ds-regionalgeo` setting on this :term:`Delivery Service` |
| :remapText: :ref:`ds-raw-remap` |
| :routingName: The :ref:`ds-routing-name` of this :term:`Delivery Service` |
| :signed: ``true`` if and only if ``signingAlgorithm`` is not ``null``, ``false`` otherwise |
| :signingAlgorithm: Either a :ref:`ds-signing-algorithm` or ``null`` to indicate URL/URI signing is not implemented on this :term:`Delivery Service` |
| :sslKeyVersion: This integer indicates the :ref:`ds-ssl-key-version` |
| :tenant: The name of the :term:`Tenant` who owns this :term:`Origin` |
| :tenantId: The integral, unique identifier of the :ref:`ds-tenant` who owns this :term:`Delivery Service` |
| :trRequestHeaders: If defined, this defines the :ref:`ds-tr-req-headers` used by Traffic Router for this :term:`Delivery Service` |
| :trResponseHeaders: If defined, this defines the :ref:`ds-tr-resp-headers` used by Traffic Router for this :term:`Delivery Service` |
| :type: The :ref:`ds-types` of this :term:`Delivery Service` |
| :typeId: The integral, unique identifier of the :ref:`ds-types` of this :term:`Delivery Service` |
| :xmlId: This :term:`Delivery Service`'s :ref:`ds-xmlid` |
| |
| :id: The integral, unique identifier assigned to the :term:`DSR <Delivery Service Request>` |
| :status: The status of the request. Can be "draft", "submitted", "rejected", "pending", or "complete". |
| |
| .. table:: Request Query Parameters |
| |
| +-----------+----------+------------------------------------------------------------------------------------------+ |
| | Name | Required | Description | |
| +===========+==========+==========================================================================================+ |
| | id | yes | The integral, unique identifier of the :ref:`Delivery Service Request <ds_requests>` that| |
| | | | you want to update. | |
| +-----------+----------+------------------------------------------------------------------------------------------+ |
| |
| .. code-block:: http |
| :caption: Request Example |
| |
| PUT /api/2.0/deliveryservice_requests?id=1 HTTP/1.1 |
| User-Agent: python-requests/2.22.0 |
| Accept-Encoding: gzip, deflate |
| Accept: */* |
| Connection: keep-alive |
| Cookie: mojolicious=... |
| Content-Length: 2256 |
| |
| { |
| "authorId": 2, |
| "author": "admin", |
| "changeType": "update", |
| "createdAt": "2020-02-24 19:11:12+00", |
| "id": 1, |
| "lastEditedBy": "admin", |
| "lastEditedById": 2, |
| "lastUpdated": "2020-02-24 19:33:26+00", |
| "deliveryService": { |
| "active": false, |
| "anonymousBlockingEnabled": false, |
| "cacheurl": null, |
| "ccrDnsTtl": null, |
| "cdnId": 2, |
| "cdnName": "CDN-in-a-Box", |
| "checkPath": null, |
| "displayName": "Demo 1", |
| "dnsBypassCname": null, |
| "dnsBypassIp": null, |
| "dnsBypassIp6": null, |
| "dnsBypassTtl": null, |
| "dscp": 0, |
| "edgeHeaderRewrite": null, |
| "geoLimit": 0, |
| "geoLimitCountries": null, |
| "geoLimitRedirectURL": null, |
| "geoProvider": 0, |
| "globalMaxMbps": null, |
| "globalMaxTps": null, |
| "httpBypassFqdn": null, |
| "id": 1, |
| "infoUrl": null, |
| "initialDispersion": 1, |
| "ipv6RoutingEnabled": true, |
| "lastUpdated": "0001-01-01 00:00:00+00", |
| "logsEnabled": true, |
| "longDesc": "Apachecon North America 2018", |
| "longDesc1": null, |
| "longDesc2": null, |
| "matchList": [ |
| { |
| "type": "HOST_REGEXP", |
| "setNumber": 0, |
| "pattern": ".*\\.demo1\\..*" |
| } |
| ], |
| "maxDnsAnswers": null, |
| "midHeaderRewrite": null, |
| "missLat": 42, |
| "missLong": -88, |
| "multiSiteOrigin": false, |
| "originShield": null, |
| "orgServerFqdn": "http://origin.infra.ciab.test", |
| "profileDescription": null, |
| "profileId": null, |
| "profileName": null, |
| "protocol": 2, |
| "qstringIgnore": 0, |
| "rangeRequestHandling": 0, |
| "regexRemap": null, |
| "regionalGeoBlocking": false, |
| "remapText": null, |
| "routingName": "video", |
| "signed": false, |
| "sslKeyVersion": 1, |
| "tenantId": 1, |
| "type": "HTTP", |
| "typeId": 1, |
| "xmlId": "demo1", |
| "exampleURLs": [ |
| "http://video.demo1.mycdn.ciab.test", |
| "https://video.demo1.mycdn.ciab.test" |
| ], |
| "deepCachingType": "NEVER", |
| "fqPacingRate": null, |
| "signingAlgorithm": null, |
| "tenant": "root", |
| "trResponseHeaders": "", |
| "trRequestHeaders": null, |
| "consistentHashRegex": null, |
| "consistentHashQueryParams": [ |
| "abc", |
| "pdq", |
| "xxx", |
| "zyx" |
| ], |
| "maxOriginConnections": 0, |
| "ecsEnabled": false |
| }, |
| "status": "submitted" |
| } |
| |
| Response Structure |
| ------------------ |
| :author: The username of the user who created the Delivery Service Request. |
| :authorId: The integral, unique identifier assigned to the author |
| :changeType: The change type of the :term:`DSR <Delivery Service Request>`. It can be ``create``, ``update``, or ``delete``.... |
| :createdAt: The date and time at which the :term:`DSR <Delivery Service Request>` was created, in :ref:`non-rfc-datetime`. |
| :deliveryService: The delivery service that the :term:`DSR <Delivery Service Request>` is requesting to update. |
| |
| :active: A boolean that defines :ref:`ds-active`. |
| :anonymousBlockingEnabled: A boolean that defines :ref:`ds-anonymous-blocking` |
| :cacheurl: A :ref:`ds-cacheurl` |
| |
| .. deprecated:: ATCv3.0 |
| This field has been deprecated in Traffic Control 3.x and is subject to removal in Traffic Control 4.x or later |
| |
| :ccrDnsTtl: The :ref:`ds-dns-ttl` - named "ccrDnsTtl" for legacy reasons |
| :cdnId: The integral, unique identifier of the :ref:`ds-cdn` to which the :term:`Delivery Service` belongs |
| :cdnName: Name of the :ref:`ds-cdn` to which the :term:`Delivery Service` belongs |
| :checkPath: A :ref:`ds-check-path` |
| :consistentHashQueryParams: An array of :ref:`ds-consistent-hashing-qparams` |
| :consistentHashRegex: A :ref:`ds-consistent-hashing-regex` |
| :deepCachingType: The :ref:`ds-deep-caching` setting for this :term:`Delivery Service` |
| :displayName: The :ref:`ds-display-name` |
| :dnsBypassCname: A :ref:`ds-dns-bypass-cname` |
| :dnsBypassIp: A :ref:`ds-dns-bypass-ip` |
| :dnsBypassIp6: A :ref:`ds-dns-bypass-ipv6` |
| :dnsBypassTtl: The :ref:`ds-dns-bypass-ttl` |
| :dscp: A :ref:`ds-dscp` to be used within the :term:`Delivery Service` |
| :ecsEnabled: A boolean that defines the :ref:`ds-ecs` setting on this :term:`Delivery Service` |
| :edgeHeaderRewrite: A set of :ref:`ds-edge-header-rw-rules` |
| :exampleURLs: An array of :ref:`ds-example-urls` |
| :fqPacingRate: The :ref:`ds-fqpr` |
| :geoLimit: An integer that defines the :ref:`ds-geo-limit` |
| :geoLimitCountries: A string containing a comma-separated list defining the :ref:`ds-geo-limit-countries`\ [#geolimit]_ |
| :geoLimitRedirectUrl: A :ref:`ds-geo-limit-redirect-url`\ [#geolimit]_ |
| :geoProvider: The :ref:`ds-geo-provider` |
| :globalMaxMbps: The :ref:`ds-global-max-mbps` |
| :globalMaxTps: The :ref:`ds-global-max-tps` |
| :httpBypassFqdn: A :ref:`ds-http-bypass-fqdn` |
| :id: An integral, unique identifier for this :term:`Delivery Service` |
| :infoUrl: An :ref:`ds-info-url` |
| :initialDispersion: The :ref:`ds-initial-dispersion` |
| :ipv6RoutingEnabled: A boolean that defines the :ref:`ds-ipv6-routing` setting on this :term:`Delivery Service` |
| :lastUpdated: The date and time at which this :term:`Delivery Service` was last updated, in :ref:`non-rfc-datetime` |
| :logsEnabled: A boolean that defines the :ref:`ds-logs-enabled` setting on this :term:`Delivery Service` |
| :longDesc: The :ref:`ds-longdesc` of this :term:`Delivery Service` |
| :longDesc1: An optional field containing the 2nd long description of this :term:`Delivery Service` |
| :longDesc2: An optional field containing the 3rd long description of this :term:`Delivery Service` |
| :matchList: The :term:`Delivery Service`'s :ref:`ds-matchlist` |
| |
| :pattern: A regular expression - the use of this pattern is dependent on the ``type`` field (backslashes are escaped) |
| :setNumber: An integer that provides explicit ordering of :ref:`ds-matchlist` items - this is used as a priority ranking by Traffic Router, and is not guaranteed to correspond to the ordering of items in the array. |
| :type: The type of match performed using ``pattern``. |
| |
| :maxDnsAnswers: The :ref:`ds-max-dns-answers` allowed for this :term:`Delivery Service` |
| :maxOriginConnections: The :ref:`ds-max-origin-connections` |
| :midHeaderRewrite: A set of :ref:`ds-mid-header-rw-rules` |
| :missLat: The :ref:`ds-geo-miss-default-latitude` used by this :term:`Delivery Service` |
| :missLong: The :ref:`ds-geo-miss-default-longitude` used by this :term:`Delivery Service` |
| :multiSiteOrigin: A boolean that defines the use of :ref:`ds-multi-site-origin` by this :term:`Delivery Service` |
| :orgServerFqdn: The :ref:`ds-origin-url` |
| :originShield: A :ref:`ds-origin-shield` string |
| :profileDescription: The :ref:`profile-description` of the :ref:`ds-profile` with which this :term:`Delivery Service` is associated |
| :profileId: An optional :ref:`profile-id` of a :ref:`ds-profile` with which this :term:`Delivery Service` shall be associated |
| :profileName: The :ref:`profile-name` of the :ref:`ds-profile` with which this :term:`Delivery Service` is associated |
| :protocol: An integral, unique identifier that corresponds to the :ref:`ds-protocol` used by this :term:`Delivery Service` |
| :qstringIgnore: An integral, unique identifier that corresponds to the :ref:`ds-qstring-handling` setting on this :term:`Delivery Service` |
| :rangeRequestHandling: An integral, unique identifier that corresponds to the :ref:`ds-range-request-handling` setting on this :term:`Delivery Service` |
| :regexRemap: A :ref:`ds-regex-remap` |
| :regionalGeoBlocking: A boolean defining the :ref:`ds-regionalgeo` setting on this :term:`Delivery Service` |
| :remapText: :ref:`ds-raw-remap` |
| :routingName: The :ref:`ds-routing-name` of this :term:`Delivery Service` |
| :signed: ``true`` if and only if ``signingAlgorithm`` is not ``null``, ``false`` otherwise |
| :signingAlgorithm: Either a :ref:`ds-signing-algorithm` or ``null`` to indicate URL/URI signing is not implemented on this :term:`Delivery Service` |
| :sslKeyVersion: This integer indicates the :ref:`ds-ssl-key-version` |
| :tenant: The name of the :term:`Tenant` who owns this :term:`Origin` |
| :tenantId: The integral, unique identifier of the :ref:`ds-tenant` who owns this :term:`Delivery Service` |
| :trRequestHeaders: If defined, this defines the :ref:`ds-tr-req-headers` used by Traffic Router for this :term:`Delivery Service` |
| :trResponseHeaders: If defined, this defines the :ref:`ds-tr-resp-headers` used by Traffic Router for this :term:`Delivery Service` |
| :type: The :ref:`ds-types` of this :term:`Delivery Service` |
| :typeId: The integral, unique identifier of the :ref:`ds-types` of this :term:`Delivery Service` |
| :xmlId: This :term:`Delivery Service`'s :ref:`ds-xmlid` |
| |
| :id: The integral, unique identifier assigned to the :term:`DSR <Delivery Service Request>` |
| :lastEditedBy: The username of user who last edited this :term:`DSR <Delivery Service Request>` |
| :lastEditedById: The integral, unique identifier assigned to the user who last edited this :term:`DSR <Delivery Service Request>` |
| :lastUpdated: The date and time at which the :term:`DSR <Delivery Service Request>` was last updated, in :ref:`non-rfc-datetime`. |
| :status: The status of the request. Can be "draft", "submitted", "rejected", "pending", or "complete". |
| |
| .. code-block:: http |
| :caption: Response Example |
| |
| HTTP/1.1 200 OK |
| Access-Control-Allow-Credentials: true |
| Access-Control-Allow-Headers: Origin, X-Requested-With, Content-Type, Accept, Set-Cookie, Cookie |
| Access-Control-Allow-Methods: POST,GET,OPTIONS,PUT,DELETE |
| Access-Control-Allow-Origin: * |
| Content-Encoding: gzip |
| Content-Type: application/json |
| Set-Cookie: mojolicious=...; Path=/; Expires=Mon, 24 Feb 2020 20:36:16 GMT; Max-Age=3600; HttpOnly |
| Whole-Content-Sha512: +W0vFm96yFkZUJqa0GAX7uzIpRKh/ohyBm0uH3egpiERTcxy5OfVVtoP3h8Ee2teLu8KFooDYXJ6rpQg6UhbNQ== |
| X-Server-Name: traffic_ops_golang/ |
| Date: Mon, 24 Feb 2020 19:36:16 GMT |
| Content-Length: 913 |
| |
| { |
| "alerts": [ |
| { |
| "text": "deliveryservice_request was updated.", |
| "level": "success" |
| } |
| ], |
| "response": { |
| "authorId": 0, |
| "author": "admin", |
| "changeType": "update", |
| "createdAt": "0001-01-01 00:00:00+00", |
| "id": 1, |
| "lastEditedBy": "admin", |
| "lastEditedById": 2, |
| "lastUpdated": "2020-02-24 19:36:16+00", |
| "deliveryService": { |
| "active": false, |
| "anonymousBlockingEnabled": false, |
| "cacheurl": null, |
| "ccrDnsTtl": null, |
| "cdnId": 2, |
| "cdnName": "CDN-in-a-Box", |
| "checkPath": null, |
| "displayName": "Demo 1", |
| "dnsBypassCname": null, |
| "dnsBypassIp": null, |
| "dnsBypassIp6": null, |
| "dnsBypassTtl": null, |
| "dscp": 0, |
| "edgeHeaderRewrite": null, |
| "geoLimit": 0, |
| "geoLimitCountries": null, |
| "geoLimitRedirectURL": null, |
| "geoProvider": 0, |
| "globalMaxMbps": null, |
| "globalMaxTps": null, |
| "httpBypassFqdn": null, |
| "id": 1, |
| "infoUrl": null, |
| "initialDispersion": 1, |
| "ipv6RoutingEnabled": true, |
| "lastUpdated": "0001-01-01 00:00:00+00", |
| "logsEnabled": true, |
| "longDesc": "Apachecon North America 2018", |
| "longDesc1": null, |
| "longDesc2": null, |
| "matchList": [ |
| { |
| "type": "HOST_REGEXP", |
| "setNumber": 0, |
| "pattern": ".*\\.demo1\\..*" |
| } |
| ], |
| "maxDnsAnswers": null, |
| "midHeaderRewrite": null, |
| "missLat": 42, |
| "missLong": -88, |
| "multiSiteOrigin": false, |
| "originShield": null, |
| "orgServerFqdn": "http://origin.infra.ciab.test", |
| "profileDescription": null, |
| "profileId": null, |
| "profileName": null, |
| "protocol": 2, |
| "qstringIgnore": 0, |
| "rangeRequestHandling": 0, |
| "regexRemap": null, |
| "regionalGeoBlocking": false, |
| "remapText": null, |
| "routingName": "video", |
| "signed": false, |
| "sslKeyVersion": 1, |
| "tenantId": 1, |
| "type": "HTTP", |
| "typeId": 1, |
| "xmlId": "demo1", |
| "exampleURLs": [ |
| "http://video.demo1.mycdn.ciab.test", |
| "https://video.demo1.mycdn.ciab.test" |
| ], |
| "deepCachingType": "NEVER", |
| "fqPacingRate": null, |
| "signingAlgorithm": null, |
| "tenant": "root", |
| "trResponseHeaders": "", |
| "trRequestHeaders": null, |
| "consistentHashRegex": null, |
| "consistentHashQueryParams": [ |
| "abc", |
| "pdq", |
| "xxx", |
| "zyx" |
| ], |
| "maxOriginConnections": 0, |
| "ecsEnabled": false |
| }, |
| "status": "submitted" |
| } |
| } |
| |
| |
| ``DELETE`` |
| ========== |
| Deletes a :term:`Delivery Service Request`. |
| |
| :Auth. Required: Yes |
| :Roles Required: "admin", "Federation", "operations", "Portal", or "Steering" |
| :Response Type: ``undefined`` |
| |
| Request Structure |
| ----------------- |
| .. table:: Request Query Parameters |
| |
| +-----------+----------+------------------------------------------------------------------------------------------+ |
| | Name | Required | Description | |
| +===========+==========+==========================================================================================+ |
| | id | yes | The integral, unique identifier of the :ref:`Delivery Service Request <ds_requests>` that| |
| | | | you want to delete. | |
| +-----------+----------+------------------------------------------------------------------------------------------+ |
| |
| .. code-block:: http |
| :caption: Request Example |
| |
| DELETE /api/2.0/deliveryservice_requests?id=1 HTTP/1.1 |
| User-Agent: python-requests/2.22.0 |
| Accept-Encoding: gzip, deflate |
| Accept: */* |
| Connection: keep-alive |
| Cookie: mojolicious=... |
| Content-Length: 0 |
| |
| Response Structure |
| ------------------ |
| |
| .. code-block:: http |
| :caption: Response Example |
| |
| HTTP/1.1 200 OK |
| Access-Control-Allow-Credentials: true |
| Access-Control-Allow-Headers: Origin, X-Requested-With, Content-Type, Accept, Set-Cookie, Cookie |
| Access-Control-Allow-Methods: POST,GET,OPTIONS,PUT,DELETE |
| Access-Control-Allow-Origin: * |
| Content-Encoding: gzip |
| Content-Type: application/json |
| Set-Cookie: mojolicious=...; Path=/; Expires=Mon, 24 Feb 2020 20:48:55 GMT; Max-Age=3600; HttpOnly |
| Whole-Content-Sha512: jNCbNo8Tw+JMMaWpAYQgntSXPq2Xuj+n2zSEVRaDQFWMV1SYbT9djes6SPdwiBoKq6W0lNE04hOE92jBVcjtEw== |
| X-Server-Name: traffic_ops_golang/ |
| Date: Mon, 24 Feb 2020 19:48:55 GMT |
| Content-Length: 96 |
| |
| { |
| "alerts": [ |
| { |
| "text": "deliveryservice_request was deleted.", |
| "level": "success" |
| } |
| ] |
| } |
| |
| .. [#geoLimit] These fields must be defined if and only if ``geoLimit`` is non-zero |
