`deliveryservice_request_comments`

`GET`

Gets delivery service request comments.

Auth. Required:: Yes
Roles Required:: None
Response Type:: Array

Request Structure

Table 135 Request Query Parameters
Name	Required	Description
author	no	Filter for Delivery Service Request comments submitted by the user identified by this username
authorId	no	Filter for Delivery Service Request comments submitted by the user identified by this integral, unique identifier
deliveryServiceRequestId	no	Filter for Delivery Service Request comments submitted for the delivery service identified by this integral, unique identifier
id	no	Filter for the Delivery Service Request comment identified by this integral, unique identifier

#277 Request Example

GET /api/3.0/deliveryservice_request_comments 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 comment.
authorId:: The integral, unique identifier of the user who created the comment.
deliveryServiceRequestId:: The integral, unique identifier of the Delivery Service Request that the comment was posted on.
id:: The integral, unique identifier of the DSR comment.
lastUpdated:: The date and time at which the user was last modified, in Traffic Ops’s Custom Date/Time Format
value:: The text of the comment that was posted.
xmlId:: This is the xmlId value that you provided in the request.

#278 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 21:00:26 GMT; Max-Age=3600; HttpOnly
Whole-Content-Sha512: RaJZS1XFJ4oIxVKyyDjTuoQY7gPOmm5EuIL4AgHpyQpuaaNviw0XhGC4V/AKf/Ws6zXLgIUc4OyvMsTxnrilww==
X-Server-Name: traffic_ops_golang/
Date: Mon, 24 Feb 2020 20:00:26 GMT
Content-Length: 207

{
    "response": [
        {
            "authorId": 2,
            "author": "admin",
            "deliveryServiceRequestId": 2,
            "id": 3,
            "lastUpdated": "2020-02-24 19:59:46+00",
            "value": "Changing to a different origin for now.",
            "xmlId": "demo1"
        },
        {
            "authorId": 2,
            "author": "admin",
            "deliveryServiceRequestId": 2,
            "id": 4,
            "lastUpdated": "2020-02-24 19:59:55+00",
            "value": "Using HTTPS.",
            "xmlId": "demo1"
        }
    ]
}

`POST`

Allows user to create a Delivery Service Request comment.

Auth. Required:: Yes
Roles Required:: “admin”, “Federation”, “operations”, “Portal”, or “Steering”
Response Type:: Object

Request Structure

deliveryServiceRequestId:: The integral, unique identifier of the delivery service that you are commenting on.
value:: The comment text itself.
xmlId:: This can be any string. It is not validated or used, though it is returned in the response.

#279 Request Example

POST /api/3.0/deliveryservice_request_comments HTTP/1.1
User-Agent: python-requests/2.22.0
Accept-Encoding: gzip, deflate
Accept: */*
Connection: keep-alive
Cookie: mojolicious=...
Content-Length: 111

{
    "deliveryServiceRequestId": 2,
    "value": "Does anyone have time to review my delivery service request?"
}

Response Structure

author:: The username of the user who created the comment.
authorId:: The integral, unique identifier of the user who created the comment.
deliveryServiceRequestId:: The integral, unique identifier of the Delivery Service Request that the comment was posted on.
id:: The integral, unique identifier of the DSR comment.
lastUpdated:: The date and time at which the user was last modified, in Traffic Ops’s Custom Date/Time Format
value:: The text of the comment that was posted.
xmlId:: This is the xmlId value that you provided in the request.

#280 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 21:02:20 GMT; Max-Age=3600; HttpOnly
Whole-Content-Sha512: LiakFP6L7PrnFO5kLXftx7WQoKn3bGpIJT5N15PvNG2sHridRMV3k23eRJM66ET0LcRfMOrQgRiydE+XgA8h0A==
X-Server-Name: traffic_ops_golang/
Date: Mon, 24 Feb 2020 20:02:20 GMT
Content-Length: 223

{
    "alerts": [
        {
            "text": "deliveryservice_request_comment was created.",
            "level": "success"
        }
    ],
    "response": {
        "authorId": 2,
        "author": null,
        "deliveryServiceRequestId": 2,
        "id": 6,
        "lastUpdated": "2020-02-24 20:02:20+00",
        "value": "Does anyone have time to review my delivery service request?",
        "xmlId": null
    }
}

`PUT`

Updates a delivery service request comment.

Auth. Required:: Yes
Roles Required:: “admin”, “Federation”, “operations”, “Portal”, or “Steering”
Response Type:: Object

Request Structure

deliveryServiceRequestId:: The integral, unique identifier of the Delivery Service Request that the comment was posted on.
value:: The comment text itself.
xmlId:: This can be any string. It is not validated or used, though it is returned in the response.

Table 136 Request Query Parameters
Parameter	Required	Description
id	yes	The integral, unique identifier of the Delivery Service Request comment that you wish to update.

#281 Request Example

PUT /api/3.0/deliveryservice_request_comments?id=6 HTTP/1.1
User-Agent: python-requests/2.22.0
Accept-Encoding: gzip, deflate
Accept: */*
Connection: keep-alive
Cookie: mojolicious=...
Content-Length: 166

{
    "deliveryServiceRequestId": 2,
    "value": "Update: We no longer need this, feel free to reject.\n\nDoes anyone have time to review my delivery service request?"
}

Response Structure

author:: The username of the user who created the comment.
authorId:: The integral, unique identifier of the user who created the comment.
deliveryServiceRequestId:: The integral, unique identifier of the Delivery Service Request that the comment was posted on.
id:: The integral, unique identifier of the DSR comment.
lastUpdated:: The date and time at which the user was last modified, in Traffic Ops’s Custom Date/Time Format
value:: The text of the comment that was posted.
xmlId:: This is the xmlId value that you provided in the request.

#282 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 21:05:46 GMT; Max-Age=3600; HttpOnly
Whole-Content-Sha512: RalS34imPw7c42nlnu5eTuv6FSxuGcAvxEdeIyNma1zpE3ZojAMFbhj8qi1s+hOVDYybfFPzMz82c+xc1qrMHg==
X-Server-Name: traffic_ops_golang/
Date: Mon, 24 Feb 2020 20:05:46 GMT
Content-Length: 255

{
    "alerts": [
        {
            "text": "deliveryservice_request_comment was updated.",
            "level": "success"
        }
    ],
    "response": {
        "authorId": null,
        "author": null,
        "deliveryServiceRequestId": 2,
        "id": 6,
        "lastUpdated": "2020-02-24 20:05:46+00",
        "value": "Update: We no longer need this, feel free to reject.\n\nDoes anyone have time to review my delivery service request?",
        "xmlId": null
    }
}

`DELETE`

Deletes a delivery service request comment.

Auth. Required:: Yes
Roles Required:: “admin”, “Federation”, “operations”, “Portal”, or “Steering”
Response Type:: undefined

Request Structure

Table 137 Request Query Parameters
Parameter	Required	Description
id	yes	The integral, unique identifier of the Delivery Service Request comment that you wish to delete.

#283 Request Example

DELETE /api/3.0/deliveryservice_request_comments?id=6 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

#284 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 21:07:40 GMT; Max-Age=3600; HttpOnly
Whole-Content-Sha512: lOpGzqeIh/1JAx85mz3MI/5A1i1g5beTSLtfvgcfQmCjNKQvOMs/4TLviuVzOCRrEIPmNcjy35tmvfxwlv7RMQ==
X-Server-Name: traffic_ops_golang/
Date: Mon, 24 Feb 2020 20:07:40 GMT
Content-Length: 101

{
    "alerts": [
        {
            "text": "deliveryservice_request_comment was deleted.",
            "level": "success"
        }
    ]
}

deliveryservice_request_comments

GET

Request Structure

Response Structure

POST

Request Structure

Response Structure

PUT

Request Structure

Response Structure

DELETE

Request Structure

Response Structure

`deliveryservice_request_comments`

`GET`

`POST`

`PUT`

`DELETE`