ocket8888 commented on a change in pull request #4444: Document undocumented
Traffic Ops routes
URL: https://github.com/apache/trafficcontrol/pull/4444#discussion_r384067169
##########
File path: docs/source/api/v2/servers_id_deliveryservices.rst
##########
@@ -239,3 +239,81 @@ Response Structure
.. [#tenancy] Only the :term:`Delivery Services` visible to the requesting
user's :term:`Tenant` will appear, regardless of their :term:`Role` or the
:term:`Delivery Services`' actual 'server assignment' status.
+
+``POST``
+========
+Assign an arbitrary number of delivery services to a single server.
+
+:Auth. Required: Yes
+:Roles Required: "admin" or "operations"
+:Response Type: Object
+
+Request Structure
+-----------------
+.. table:: Request Path Parameters
+
+
+------+----------+---------------------------------------------------------------------------------------------+
+ | Name | Required | Description
|
+
+------+----------+---------------------------------------------------------------------------------------------+
+ | id | Yes | The integral, unique identifier of the server that
you want to assign delivery services to. |
+
+------+----------+---------------------------------------------------------------------------------------------+
+
+.. table:: Request Query Parameters
+
+
+---------+----------+------------------------------------------------------------------------------------------+
+ | Name | Required | Description
|
+
+=========+==========+==========================================================================================+
+ | replace | Yes | Must be a 1, true, 0, or false. Although this
query parameter is required, it is unused. |
+
+---------+----------+------------------------------------------------------------------------------------------+
+
+The request body is an array of IDs of delivery services that you want to
assign to the server. The array can be empty, but it must be provided.
+
+.. code-block:: http
+ :caption: Request Example
+
+ POST /api/2.0/servers/6/deliveryservices?replace=1 HTTP/1.1
+ User-Agent: python-requests/2.22.0
+ Accept-Encoding: gzip, deflate
+ Accept: */*
+ Connection: keep-alive
+ Cookie: mojolicious=...
+ Content-Length: 3
+
+ [
+ 1
+ ]
+
+Response Structure
+------------------
+
Review comment:
Response field definitions?
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
With regards,
Apache Git Services
