You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@trafficcontrol.apache.org by oc...@apache.org on 2020/12/04 17:58:00 UTC

[trafficcontrol] branch master updated: Add a page that addresses migrating from Traffic Ops API v1 for each endpoint (#5344)

This is an automated email from the ASF dual-hosted git repository.

ocket8888 pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/trafficcontrol.git


The following commit(s) were added to refs/heads/master by this push:
     new ce046c1  Add a page that addresses migrating from Traffic Ops API v1 for each endpoint (#5344)
ce046c1 is described below

commit ce046c1d471f52333e2c1799c79daee1886b0804
Author: Zach Hoffman <zr...@apache.org>
AuthorDate: Fri Dec 4 10:57:48 2020 -0700

    Add a page that addresses migrating from Traffic Ops API v1 for each endpoint (#5344)
    
    * Add a page that addresses migrating from Traffic Ops API v1 for each
    endpoint
    
    * Add color and emphasis to "Same route"/"No v3 equivalent"
    
    * Use :atc-godoc: role to link to godoc
    
    * Remove link to PyPI
---
 CHANGELOG.md                            |   2 +
 docs/source/_static/theme_overrides.css |  10 +
 docs/source/api/index.rst               |  10 +
 docs/source/api/migrating-from-v1.rst   | 668 ++++++++++++++++++++++++++++++++
 4 files changed, 690 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 386fa5b..573b1a9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,8 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
 
 ## [unreleased]
+### Added
+- #5344 - Add a page that addresses migrating from Traffic Ops API v1 for each endpoint
 
 ## [5.0.0] - 2020-10-20
 ### Added
diff --git a/docs/source/_static/theme_overrides.css b/docs/source/_static/theme_overrides.css
index 619f23a..af3f5c5 100644
--- a/docs/source/_static/theme_overrides.css
+++ b/docs/source/_static/theme_overrides.css
@@ -79,3 +79,13 @@ abbr {
 html, html body {
   overflow-x: auto;
 }
+
+.same {
+    font-weight: 700;
+    color: #050;
+}
+
+.none {
+    font-weight: 700;
+    color: #800;
+}
diff --git a/docs/source/api/index.rst b/docs/source/api/index.rst
index 04f84d8..844e3e7 100644
--- a/docs/source/api/index.rst
+++ b/docs/source/api/index.rst
@@ -325,3 +325,13 @@ TrafficOps Native Client Libraries
 TrafficOps client libraries are available in Java, Go and Python. You can read (very little) more about them in `the client README <https://github.com/apache/trafficcontrol/tree/master/traffic_control/clients>`_.
 
 .. [1] A cookie obtained by logging in through Traffic Portal can be used to access API endpoints under the Traffic Portal domain name - since it will proxy such requests back to Traffic Ops. This is not recommended in actual deployments, however, because it will involve an extra network connection which could be avoided by simply using the Traffic Ops domain itself.
+
+Migrating from API V1
+=====================
+
+.. toctree::
+	:hidden:
+
+	migrating-from-v1
+
+See the :ref:`to-migrating` page for help migrating existing code from API v1 to a new API version.
diff --git a/docs/source/api/migrating-from-v1.rst b/docs/source/api/migrating-from-v1.rst
new file mode 100644
index 0000000..0325fb9
--- /dev/null
+++ b/docs/source/api/migrating-from-v1.rst
@@ -0,0 +1,668 @@
+..
+..
+.. 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-migrating:
+
+*********************
+Migrating from API V1
+*********************
+
+Versions 1.0, 1.1, 1.2, 1.3, 1.4, and 1.5 of the :ref:`to-api` have been deprecated since Apache Traffic Control version 4.0.0 and will be removed in Apache Traffic Control version 6.0.0. Any remaining users of 1.x endpoints of the Traffic Ops API are advised to upgrade to API version 3.0.
+
+Upgrading your Traffic Ops client
+=================================
+
+The easiest way to switch to a new API version is to use the latest version of a Traffic Ops client.
+
+Golang
+------
+
+If you are using the ``github.com/apache/trafficcontrol/traffic_ops/client`` package, use the :atc-godoc:`traffic_ops/v3-client` package instead.
+
+Python
+______
+
+Update to a newer version of the Apache-TrafficControl Python package.
+
+Updating endpoints manually
+============================
+
+If your code performs HTTP requests to a Traffic Ops API directly, it may be necessary to change which endpoint your code uses, in addition to simply changing the API version. The table below shows the easiest non-deprecated endpoint to use for each deprecated endpoint.
+
+.. role:: same
+.. |same| replace:: :same:`Same route`
+
+.. role:: none
+.. |none| replace:: :none:`No v3 equivalent`
+
+.. |atstccfg| replace:: Generated by :ref:`atstccfg`
+
+.. _to-migration-table:
+
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| HTTP method | v1 (deprecated) API route                                                   | v3 API route                                                                                   |
++=============+=============================================================================+================================================================================================+
+| ``GET``     | :ref:`to-api-v3-about`                                                      | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-api_capabilities`                                           | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-asns`                                                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-asns`                                                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-asns-id`                                                    | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-asns-id`                                                    | :ref:`to-api-asns`?id={{id}}                                                                   |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-asns-id`                                                    | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-asns`                                                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-asns`                                                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-cachegroupparameters-id-parameterID`                        | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cachegroupparameters`                                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-cachegroupparameters`                                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cachegroups`                                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-cachegroups-id`                                             | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-cachegroups-id-deliveryservices`                            | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cachegroups-id`                                             | :ref:`to-api-cachegroups`?id={{ID}}                                                            |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cachegroups-id-parameters`                                  | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-cachegroups-id`                                             | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-cachegroups-id-queue_update`                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cachegroups-id-unassigned_parameters`                       | :ref:`to-api-cachegroupparameters` and :ref:`to-api-parameters`?id={{id}}                      |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-cachegroups`                                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cachegroups-trimmed`                                        | :ref:`to-api-cachegroups`                                                                      |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-caches-stats`                                               | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cache_stats`                                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-capabilities`                                               | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-capabilities`                                               | |none|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cdns-capacity`                                              | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cdns-name-configs-monitoring`                               | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | cdns/{{cdn-name-or-id}}/configfiles/ats/bg_fetch.config                     | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | cdns/{{cdn-name-or-id}}/configfiles/ats/cacheurl{{filename}}.config         | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | cdns/{{cdn-name-or-id}}/configfiles/ats/hdr_rw_mid_{{xml-id}}.config        | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | cdns/{{cdn-name-or-id}}/configfiles/ats/hdr_rw_{{xml-id}}.config            | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | cdns/{{cdn-name-or-id}}/configfiles/ats/regex_remap_{{ds-name}}.config      | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | cdns/{{cdn-name-or-id}}/configfiles/ats/regex_revalidate.config             | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | cdns/{{cdn-name-or-id}}/configfiles/ats/set_dscp_{{dscp}}.config            | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | cdns/{{cdn-name-or-id}}/configfiles/ats/ssl_multicert.config                | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cdns-id-snapshot`                                           | :ref:`to-api-cdns-name-snapshot`                                                               |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cdns-name-snapshot`                                         | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cdns-name-snapshot-new`                                     | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cdns-config`                                                | :ref:`to-api-cdns`                                                                             |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v3-cdns-dnsseckeys-generate`                                   | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cdns-dnsseckeys-refresh`                                    | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cdns-domains`                                               | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cdns`                                                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cdns-health`                                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-cdns-id`                                                    | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cdns-id`                                                    | :ref:`to-api-cdns`?id={{ID}}                                                                   |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-cdns-id`                                                    | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-cdns-id-queue_update`                                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-cdns-id-snapshot`                                           | :ref:`to-api-snapshot`?cdnID={{ID}}                                                            |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cdns-metric_types-metric-start_date-start-end_date-end`     | :ref:`to-api-deliveryservices-id-server_types-type-metric_types-start_date-start-end_date-end` |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-cdns-name-dnsseckeys-ksk-generate`                          | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cdns-name-federations`                                      | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-cdns-name-federations-id`                                   | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cdns-name-federations-id`                                   | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-cdns-name-federations-id`                                   | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-cdns-name-federations`                                      | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cdns-name-health`                                           | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-cdns-name-name`                                             | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cdns-name-name-dnsseckeys-delete`                           | ``DELETE`` :ref:`to-api-cdns-name-name-dnsseckeys`                                             |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cdns-name-name-dnsseckeys`                                  | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cdns-name-name`                                             | :ref:`to-api-cdns`?name={{name}}                                                               |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cdns-name-name-sslkeys`                                     | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-cdns`                                                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-cdns-routing`                                               | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-consistenthash`                                             | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-coordinates`                                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-coordinates`                                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-coordinates`                                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-coordinates`                                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-current-stats`                                              | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-dbdump`                                                     | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | deliveryservice_matches                                                     | :ref:`to-api-deliveryservices_regexes`                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v3-deliveryservice_request_comments`                           | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v3-deliveryservice_request_comments`                           | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v3-deliveryservice_request_comments`                           | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v3-deliveryservice_request_comments`                           | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v3-deliveryservice-requests`                                   | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v3-deliveryservice-requests`                                   | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v3-deliveryservice_requests-id-assign`                         | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v3-deliveryservice_requests-id-status`                         | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v3-deliveryservice-requests`                                   | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v3-deliveryservice-requests`                                   | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-deliveryservices-id-regexes`                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-deliveryservices-id-regexes`                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-deliveryservices-id-regexes`                                | :ref:`to-api-deliveryservices-id-regexes-rid`                                                  |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-deliveryservices-id-regexes`                                | :ref:`to-api-deliveryservices-id-regexes-rid`                                                  |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-deliveryservices-id-regexes-rid`                            | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-deliveryservices-id-regexes-rid`                            | :ref:`to-api-deliveryservices-id-regexes`?id={{rID}}                                           |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-deliveryservices-id-regexes-rid`                            | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-deliveryservice_server-dsid-serverid`                       | :ref:`to-api-deliveryserviceserver-dsid-serverid`                                              |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-deliveryserviceserver`                                      | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-deliveryserviceserver`                                      | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-deliveryservices`                                           | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-deliveryservices-hostname-name-sslkeys`                     | :ref:`to-api-deliveryservices-xmlid-xmlid-sslkeys`                                             |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-deliveryservices-id-capacity`                               | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-deliveryservices-id`                                        | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-deliveryservices-id`                                        | :ref:`to-api-deliveryservices`?id={{ID}}                                                       |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-deliveryservices-id-health`                                 | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-deliveryservices-id`                                        | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-deliveryservices-id-routing`                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-deliveryservices-id-safe`                                   | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-deliveryservices-id-servers-eligible`                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-deliveryservices-id-servers`                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-deliveryservices-id-unassigned_servers`                     | |none|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v3-deliveryservices-id-urlkeys`                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-deliveryservices`                                           | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-deliveryservices_regexes`                                   | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-deliveryservices-request`                                   | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-deliveryservices-required-capabilities`                     | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-deliveryservices-required-capabilities`                     | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-deliveryservices-required-capabilities`                     | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-deliveryservices-sslkeys-add`                               | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-deliveryservices-sslkeys-generate-letsencrypt`              | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-deliveryservices-sslkeys-generate`                          | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-deliveryservice_stats`                                      | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-deliveryservices-xmlid-xml_id-urlkeys-copyFrom_xml_id`      | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-deliveryservices-xmlid-xmlid-urlkeys-generate`              | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-deliveryservices-xmlid-xmlid-urlkeys`                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-deliveryservices-xmlid-servers`                             | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-deliveryservices-xmlid-urisignkeys`                         | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-deliveryservices-xmlid-urisignkeys`                         | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-deliveryservices-xmlid-urisignkeys`                         | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-deliveryservices-xmlid-urisignkeys`                         | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-deliveryservices-xmlid-xmlid-sslkeys-delete`                | :ref:`to-api-deliveryservices-xmlid-xmlid-sslkeys`                                             |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-deliveryservices-xmlid-xmlid-sslkeys`                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-divisions`                                                  | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-divisions-id`                                               | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-divisions-id`                                               | :ref:`to-api-divisions`?id={{ID}}                                                              |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-divisions-id`                                               | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | divisions/name/{{name}}                                                     | :ref:`to-api-divisions`?name={{name}}                                                          |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-divisions`                                                  | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-federation_resolvers`                                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-federation_resolvers`                                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-federation_resolvers-id`                                    | :ref:`to-api-federation_resolvers`?id={{ID}}                                                   |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-federation_resolvers`                                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v3-federations-all`                                            | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-federations`                                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-federations`                                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-federations-id-deliveryservices-id`                         | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-federations-id-deliveryservices`                            | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-federations-id-deliveryservices`                            | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-federations-id-federation_resolvers`                        | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-federations-id-federation_resolvers`                        | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-federations-id-users`                                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-federations-id-users`                                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-federations-id-users-id`                                    | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-federations`                                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-federations`                                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-hwinfo`                                                     | |none|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-jobs`                                                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-jobs`                                                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-jobs-id`                                                    | :ref:`to-api-jobs`?id={{ID}}                                                                   |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-jobs`                                                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-jobs`                                                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-keys-ping`                                                     | :ref:`to-api-vault-ping`                                                                       |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-letsencrypt-autorenew`                                      | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-letsencrypt-dnsrecord`                                      | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-logs-days-days`                                             | :ref:`to-api-logs`?days={{days}}                                                               |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-logs`                                                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-logs-newcount`                                              | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-origins`                                                    | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-origins`                                                    | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-origins`                                                    | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-origins`                                                    | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-osversions`                                                 | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-parameterprofile`                                           | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-parameters`                                                 | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-parameters-id`                                              | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-parameters-id`                                              | :ref:`to-api-parameters`?id={{ID}}                                                             |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-parameters-id`                                              | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-parameters`                                                 | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-parameters-profile-name`                                    | :ref:`to-api-profiles-name-name-parameters`                                                    |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-phys_locations`                                             | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-phys_locations-id`                                          | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-phys_locations-id`                                          | :ref:`to-api-phys_locations`?id={{ID}}                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-phys_locations-id`                                          | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-phys_locations`                                             | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-phys_locations-trimmed`                                     | :ref:`to-api-phys_locations`                                                                   |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v3-ping`                                                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-profileparameter`                                           | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-profileparameters`                                          | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-profileparameters`                                          | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-profileparameters-profileID-parameterID`                    | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-profiles`                                                   | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-profiles-id`                                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-profiles-id-export`                                         | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-profiles-id`                                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-profiles-id-parameters`                                     | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-profiles-id-parameters`                                     | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-profiles-id`                                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-profiles-id-unassigned_parameters`                          | |none|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-profiles-import`                                            | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-profiles-name-name-parameters`                              | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-profiles-name-name-parameters`                              | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-profiles-name-name-copy-copy`                               | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-profiles`                                                   | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | profiles/{{profile-name-or-id}}/configfiles/ats/12m_facts                   | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | profiles/{{profile-name-or-id}}/configfiles/ats/50-ats.rules                | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | profiles/{{profile-name-or-id}}/configfiles/ats/astats.config               | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | profiles/{{profile-name-or-id}}/configfiles/ats/cache.config                | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | profiles/{{profile-name-or-id}}/configfiles/ats/drop_qstring.config         | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | profiles/{{profile-name-or-id}}/configfiles/ats/{{file}}                    | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | profiles/{{profile-name-or-id}}/configfiles/ats/logging.config              | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | profiles/{{profile-name-or-id}}/configfiles/ats/logging.yaml                | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | profiles/{{profile-name-or-id}}/configfiles/ats/logs_xml.config             | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | profiles/{{profile-name-or-id}}/configfiles/ats/plugin.config               | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | profiles/{{profile-name-or-id}}/configfiles/ats/records.config              | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | profiles/{{profile-name-or-id}}/configfiles/ats/storage.config              | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | profiles/{{profile-name-or-id}}/configfiles/ats/sysctl.conf                 | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | profiles/{{profile-name-or-id}}/configfiles/ats/uri_signing_{{file}}.config | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | profiles/{{profile-name-or-id}}/configfiles/ats/url_sig_{{file}}.config     | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | profiles/{{profile-name-or-id}}/configfiles/ats/volume.config               | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-profiles-trimmed`                                           | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-regions`                                                    | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-regions`                                                    | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-regions-id`                                                 | :ref:`to-api-regions`?id={{ID}}                                                                |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-regions-id`                                                 | :ref:`to-api-regions`?id={{ID}}                                                                |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-regions-id`                                                 | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | regions/name/{{name}}                                                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | regions/name/{{name}}                                                       | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-regions`                                                    | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-riak-bucket-bucket-key-key-values`                             | :ref:`to-api-vault-bucket-bucket-key-key-values`                                               |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-riak-ping`                                                  | :ref:`to-api-vault-ping`                                                                       |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-roles`                                                      | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-roles`                                                      | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-roles`                                                      | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-roles`                                                      | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-server_capabilities`                                        | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-server_capabilities`                                        | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-server_capabilities`                                        | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-servercheck`                                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-servers-checks`                                             | :ref:`to-api-servercheck`                                                                      |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-servers-details`                                               | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-server-server-capabilities`                                 | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-server-server-capabilities`                                 | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-server-server-capabilities`                                 | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-servers`                                                    | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-servers-hostname-name-details`                              | :ref:`to-api-servers-details`?hostName={{name}}                                                |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-servers-hostname-update_status`                             | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-servers-id`                                                 | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | servers/{{ID}}/deliveryservice                                              | servers/{{ID}}/deliveryservices                                                                |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-servers-id-deliveryservices`                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-servers-id-deliveryservices`                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-servers-id`                                                 | :ref:`to-api-servers`?id={{ID}}                                                                |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | servers/{{id-or-host}}/configfiles/ats/cache.config                         | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | servers/{{id-or-host}}/configfiles/ats/chkconfig                            | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | servers/{{id-or-host}}/configfiles/ats/{{file}}                             | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | servers/{{id-or-host}}/configfiles/ats/hosting.config                       | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | servers/{{id-or-host}}/configfiles/ats/packages                             | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-servers-id`                                                 | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-servers-id-queue_update`                                    | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-servers-id-status`                                          | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-servers`                                                    | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | servers/{{server-name-or-id}}/configfiles/ats                               | |atstccfg|                                                                                     |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-servers-status`                                             | :ref:`to-api-servers`                                                                          |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-servers-totals`                                             | |none|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-snapshot-name`                                              | :ref:`to-api-snapshot`                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-staticdnsentries`                                           | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-staticdnsentries`                                           | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-staticdnsentries`                                           | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-staticdnsentries`                                           | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-stats-summary`                                              | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-stats-summary`                                              | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-statuses`                                                   | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-statuses-id`                                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-statuses-id`                                                | :ref:`to-api-statuses`?id={{ID}}                                                               |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-statuses-id`                                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-statuses`                                                   | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-steering-id-targets`                                        | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-steering-id-targets`                                        | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-steering-id-targets-targetID`                               | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-steering-id-targets-targetID`                               | :ref:`to-api-steering-id-targets`?target={{targetID}}                                          |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-steering-id-targets-targetID`                               | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v3-steering`                                                   | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-system-info`                                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-tenants`                                                    | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-tenants-id`                                                 | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-tenants-id`                                                 | :ref:`to-api-tenants`?id={{ID}}                                                                |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-tenants-id`                                                 | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-tenants`                                                    | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-to_extensions`                                              | :ref:`to-api-servercheck_extensions`                                                           |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-to_extensions-id-delete`                                    | :ref:`to-api-servercheck_extensions-id`                                                        |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-to_extensions`                                              | :ref:`to-api-servercheck_extensions`                                                           |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-types`                                                      | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``DELETE``  | :ref:`to-api-v1-types-id`                                                   | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-types-id`                                                   | :ref:`to-api-types`?id={{ID}}                                                                  |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-types-id`                                                   | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-types`                                                      | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-types-trimmed`                                              | :ref:`to-api-types`                                                                            |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-user-current`                                               | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-user-current-jobs`                                          | :ref:`to-api-jobs`?userId={{ID}}                                                               |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-user-current-jobs`                                          | :ref:`to-api-jobs`                                                                             |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-user-current`                                               | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-user-id-deliveryservices-available`                         | :ref:`to-api-deliveryservices`?accessibleTo={{tenantID}}                                       |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-user-login-oauth`                                           | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-user-login`                                                 | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-user-login-token`                                           | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-user-logout`                                                | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-user-reset_password`                                        | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-users`                                                      | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-users-id-deliveryservices`                                  | :ref:`to-api-deliveryservices`?accessibleTo={{tenantID}}                                       |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``GET``     | :ref:`to-api-v1-users-id`                                                   | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``PUT``     | :ref:`to-api-v1-users-id`                                                   | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-users`                                                      | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+
+| ``POST``    | :ref:`to-api-v1-users-register`                                             | |same|                                                                                         |
++-------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+