deliveryservice_requests/{{ID}}/status

Get or set the status of a Delivery Service Request.

GET

Gets the status of a DSR.

Auth. Required:

Yes

Roles Required:

“admin”, “Federation”, “operations”, “Portal”, or “Steering”

Permissions Required:

DS-REQUEST:READ

Response Type:

Object (string)

Request Structure

Table 490 Request Path Parameters

Name	Description
ID	The integral, unique identifier of the Delivery Service Request being inspected

#1217 Request Example

GET /api/5.0/deliveryservice_requests/1/status HTTP/1.1
User-Agent: python-requests/2.24.0
Accept-Encoding: gzip, deflate
Accept: */*
Connection: keep-alive
Cookie: mojolicious=...

Response Structure

The response is the status of the requested DSR.

#1218 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=Tue, 02 Feb 2021 22:56:47 GMT; Max-Age=3600; HttpOnly
Vary: Accept-Encoding
X-Server-Name: traffic_ops_golang/
Date: Tue, 02 Feb 2021 21:56:47 GMT
Content-Length: 45

{ "response": "draft" }

PUT

Auth. Required:

Yes

Roles Required:

“admin”, “Federation”, “operations”, “Portal”, or “Steering”

Permissions Required:

DS-REQUEST:UPDATE, DS-REQUEST:READ

Response Type:

Object

Request Structure

Table 491 Request Path Parameters

Name	Description
ID	The integral, unique identifier of the Delivery Service Request being modified

status:

The status of the DSR. Can be “draft”, “submitted”, “rejected”, “pending”, or “complete”.

#1219 Request Example

PUT /api/5.0/deliveryservice_requests/1/status HTTP/1.1
User-Agent: python-requests/2.25.1
Accept-Encoding: gzip, deflate
Accept: */*
Connection: keep-alive
Cookie: access_token=...; mojolicious=...
Content-Length: 23
Content-Type: application/json

{"status": "submitted"}

Response Structure

The response is a full representation of the modified DSR.

Changed in version 5.0: Prior to version 5.0 of the API, the lastUpdated field was in Traffic Ops’s Custom Date/Time Format.

#1220 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
Permissions-Policy: interest-cohort=()
Set-Cookie: mojolicious=...; Path=/; Expires=Thu, 29 Sep 2022 23:21:02 GMT; Max-Age=3600; HttpOnly, access_token=...; Path=/; Expires=Thu, 29 Sep 2022 23:21:02 GMT; Max-Age=3600; HttpOnly
Vary: Accept-Encoding
X-Server-Name: traffic_ops_golang/
Date: Thu, 29 Sep 2022 22:21:02 GMT
Content-Length: 1174

{ "alerts": [{
    "text": "Changed status of 'demo1' Delivery Service Request from 'draft' to 'submitted'",
    "level": "success"
}],
"response": {
    "assignee": null,
    "author": "admin",
    "changeType": "update",
    "createdAt": "2022-09-29T22:07:15.008503-6:00",
    "id": 1,
    "lastEditedBy": "admin",
    "lastUpdated": "2022-09-29T22:21:02.144598-6:00",
    "original": {
        "active": "ACTIVE",
        "anonymousBlockingEnabled": false,
        "ccrDnsTtl": null,
        "cdnId": 2,
        "cdnName": "CDN-in-a-Box",
        "checkPath": null,
        "consistentHashQueryParams": [
            "abc",
            "pdq",
            "xxx",
            "zyx"
        ],
        "consistentHashRegex": null,
        "deepCachingType": "NEVER",
        "displayName": "Demo 1",
        "dnsBypassCname": null,
        "dnsBypassIp": null,
        "dnsBypassIp6": null,
        "dnsBypassTtl": null,
        "dscp": 0,
        "ecsEnabled": false,
        "edgeHeaderRewrite": null,
        "exampleURLs": [
            "http://video.demo1.mycdn.ciab.test",
            "https://video.demo1.mycdn.ciab.test"
        ],
        "firstHeaderRewrite": null,
        "fqPacingRate": null,
        "geoLimit": 0,
        "geoLimitCountries": null,
        "geoLimitRedirectURL": null,
        "geoProvider": 0,
        "globalMaxMbps": null,
        "globalMaxTps": null,
        "httpBypassFqdn": null,
        "id": 1,
        "infoUrl": null,
        "initialDispersion": 1,
        "innerHeaderRewrite": null,
        "ipv6RoutingEnabled": true,
        "lastHeaderRewrite": null,
        "lastUpdated": "2022-09-29T20:58:53.07251-6:00",
        "logsEnabled": true,
        "longDesc": "Apachecon North America 2018",
        "matchList": [
            {
                "type": "HOST_REGEXP",
                "setNumber": 0,
                "pattern": ".*\\.demo1\\..*"
            }
        ],
        "maxDnsAnswers": null,
        "maxOriginConnections": 0,
        "maxRequestHeaderBytes": 0,
        "midHeaderRewrite": null,
        "missLat": 42,
        "missLong": -88,
        "multiSiteOrigin": true,
        "originShield": null,
        "orgServerFqdn": "http://origin.infra.ciab.test",
        "profileDescription": null,
        "profileId": null,
        "profileName": null,
        "protocol": 2,
        "qstringIgnore": 0,
        "rangeRequestHandling": 0,
        "rangeSliceBlockSize": null,
        "regexRemap": null,
        "regional": false,
        "regionalGeoBlocking": false,
        "remapText": null,
        "routingName": "video",
        "serviceCategory": null,
        "signed": false,
        "signingAlgorithm": null,
        "sslKeyVersion": 1,
        "tenant": "root",
        "tenantId": 1,
        "tlsVersions": null,
        "topology": "demo1-top",
        "trResponseHeaders": null,
        "trRequestHeaders": null,
        "type": "HTTP",
        "typeId": 1,
        "xmlId": "demo1"
    },
    "requested": {
        "active": "INACTIVE",
        "anonymousBlockingEnabled": false,
        "ccrDnsTtl": 30,
        "cdnId": 2,
        "cdnName": null,
        "checkPath": null,
        "consistentHashQueryParams": null,
        "consistentHashRegex": null,
        "deepCachingType": "NEVER",
        "displayName": "Demo 1 but I modified the DSR",
        "dnsBypassCname": null,
        "dnsBypassIp": null,
        "dnsBypassIp6": null,
        "dnsBypassTtl": null,
        "dscp": 0,
        "ecsEnabled": false,
        "edgeHeaderRewrite": null,
        "exampleURLs": null,
        "firstHeaderRewrite": null,
        "fqPacingRate": null,
        "geoLimit": 0,
        "geoLimitCountries": null,
        "geoLimitRedirectURL": null,
        "geoProvider": 0,
        "globalMaxMbps": null,
        "globalMaxTps": null,
        "httpBypassFqdn": null,
        "id": 1,
        "infoUrl": null,
        "initialDispersion": 3,
        "innerHeaderRewrite": null,
        "ipv6RoutingEnabled": null,
        "lastHeaderRewrite": null,
        "lastUpdated": "2022-09-29T20:58:53-6:00",
        "logsEnabled": false,
        "longDesc": "long desc",
        "matchList": null,
        "maxDnsAnswers": null,
        "maxOriginConnections": 0,
        "maxRequestHeaderBytes": 0,
        "midHeaderRewrite": null,
        "missLat": null,
        "missLong": null,
        "multiSiteOrigin": false,
        "originShield": null,
        "orgServerFqdn": null,
        "profileDescription": null,
        "profileId": null,
        "profileName": null,
        "protocol": null,
        "qstringIgnore": null,
        "rangeRequestHandling": null,
        "rangeSliceBlockSize": null,
        "regexRemap": null,
        "regional": false,
        "regionalGeoBlocking": false,
        "remapText": null,
        "routingName": "cdn",
        "serviceCategory": null,
        "signed": false,
        "signingAlgorithm": null,
        "sslKeyVersion": null,
        "tenant": null,
        "tenantId": 1,
        "tlsVersions": null,
        "topology": null,
        "trResponseHeaders": null,
        "trRequestHeaders": null,
        "type": null,
        "typeId": 8,
        "xmlId": "demo1"
    },
    "status": "submitted"
}}