trafficcontrol-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From hbea...@apache.org
Subject [36/51] [partial] incubator-trafficcontrol-website git commit: adds 2.1.x documentation
Date Mon, 22 Jan 2018 15:57:44 GMT
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/24ff8964/docs/2.1.x/_sources/development/traffic_ops_api/v12/phys_location.rst.txt
----------------------------------------------------------------------
diff --git a/docs/2.1.x/_sources/development/traffic_ops_api/v12/phys_location.rst.txt b/docs/2.1.x/_sources/development/traffic_ops_api/v12/phys_location.rst.txt
new file mode 100644
index 0000000..67359e5
--- /dev/null
+++ b/docs/2.1.x/_sources/development/traffic_ops_api/v12/phys_location.rst.txt
@@ -0,0 +1,456 @@
+.. 
+.. 
+.. Licensed under the Apache License, Version 2.0 (the "License");
+.. you may not use this file except in compliance with the License.
+.. You may obtain a copy of the License at
+.. 
+..     http://www.apache.org/licenses/LICENSE-2.0
+.. 
+.. Unless required by applicable law or agreed to in writing, software
+.. distributed under the License is distributed on an "AS IS" BASIS,
+.. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+.. See the License for the specific language governing permissions and
+.. limitations under the License.
+.. 
+
+.. _to-api-v12-phys-loc:
+
+Physical Location
+=================
+
+.. _to-api-v12-phys-loc-route:
+
+/api/1.2/phys_locations
++++++++++++++++++++++++
+
+**GET /api/1.2/phys_locations**
+
+  Authentication Required: Yes
+
+  Role(s) Required: None
+
+  **Request Query Parameters**
+
+  +--------------+----------+---------------------------------------------+
+  |   Name       | Required |                Description                  |
+  +==============+==========+=============================================+
+  |  ``region``  | no       | Filter by Region ID.                        |
+  +--------------+----------+---------------------------------------------+
+
+  **Response Properties**
+
+  +----------------------+--------+------------------------------------------------+
+  | Parameter            | Type   | Description                                    |
+  +======================+========+================================================+
+  |``address``           | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``city``              | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``comments``          | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``email``             | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``id``                | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``lastUpdated``       | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``name``              | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``phone``             | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``poc``               | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``region``            | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``regionId``          | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``shortName``         | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``state``             | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``zip``               | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+
+  **Response Example** ::
+
+    {
+     "response": [
+        {
+           "region": "Mile High",
+           "region": "4",
+           "poc": "Jane Doe",
+           "lastUpdated": "2014-10-02 08:22:43",
+           "name": "Albuquerque",
+           "comments": "Albuquerque",
+           "phone": "(123) 555-1111",
+           "state": "NM",
+           "email": "jane.doe@email.com",
+           "city": "Albuquerque",
+           "zip": "87107",
+           "id": "2",
+           "address": "123 East 3rd St",
+           "shortName": "Albuquerque"
+        },
+        {
+           "region": "Mile High",
+           "region": "4",
+           "poc": "Jane Doe",
+           "lastUpdated": "2014-10-02 08:22:43",
+           "name": "Albuquerque",
+           "comments": "Albuquerque",
+           "phone": "(123) 555-1111",
+           "state": "NM",
+           "email": "jane.doe@email.com",
+           "city": "Albuquerque",
+           "zip": "87107",
+           "id": "2",
+           "address": "123 East 3rd St",
+           "shortName": "Albuquerque"
+        }
+     ]
+    }
+
+|
+
+**GET /api/1.2/phys_locations/trimmed.json**
+
+  Authentication Required: Yes
+
+  Role(s) Required: None
+
+  **Response Properties**
+
+  +----------------------+---------+------------------------------------------------+
+  | Parameter            | Type    | Description                                    |
+  +======================+=========+================================================+
+  |``name``              | string  |                                                |
+  +----------------------+---------+------------------------------------------------+
+
+  **Response Example** ::
+
+    {
+     "response": [
+        {
+           "name": "Albuquerque"
+        },
+        {
+           "name": "Ashburn"
+        }
+     ]
+    }
+
+|
+
+
+**GET /api/1.2/phys_locations/:id**
+
+  Authentication Required: Yes
+
+  Role(s) Required: None
+
+  **Request Route Parameters**
+
+  +-----------+----------+---------------------------------------------+
+  |   Name    | Required |                Description                  |
+  +===========+==========+=============================================+
+  | ``id``    | yes      | Physical location ID.                       |
+  +-----------+----------+---------------------------------------------+
+
+  **Response Properties**
+
+  +----------------------+--------+------------------------------------------------+
+  | Parameter            | Type   | Description                                    |
+  +======================+========+================================================+
+  |``address``           | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``city``              | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``comments``          | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``email``             | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``id``                | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``lastUpdated``       | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``name``              | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``phone``             | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``poc``               | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``region``            | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``regionId``          | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``shortName``         | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``state``             | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``zip``               | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+
+  **Response Example** ::
+
+    {
+     "response": [
+        {
+           "region": "Mile High",
+           "region": "4",
+           "poc": "Jane Doe",
+           "lastUpdated": "2014-10-02 08:22:43",
+           "name": "Albuquerque",
+           "comments": "Albuquerque",
+           "phone": "(123) 555-1111",
+           "state": "NM",
+           "email": "jane.doe@email.com",
+           "city": "Albuquerque",
+           "zip": "87107",
+           "id": "2",
+           "address": "123 East 3rd St",
+           "shortName": "Albuquerque"
+        }
+     ]
+    }
+
+|
+
+**PUT /api/1.2/phys_locations/:id**
+  Update a physical location
+
+  Authentication Required: Yes
+
+  Role(s) Required: admin or oper
+
+  **Request Route Parameters**
+
+  +-------------------+----------+------------------------------------------------+
+  | Name              |   Type   |                 Description                    |
+  +===================+==========+================================================+
+  | ``id``            | int      | Physical location id.                          |
+  +-------------------+----------+------------------------------------------------+
+
+  **Request Properties**
+
+  +-------------------+----------+------------------------------------------------+
+  | Parameter         | Required | Description                                    |
+  +===================+==========+================================================+
+  | ``address``       |    yes   | Physical location address.                     |
+  +-------------------+----------+------------------------------------------------+
+  | ``city``          |    yes   | Physical location city.                        |
+  +-------------------+----------+------------------------------------------------+
+  | ``comments``      |    no    | Physical location comments.                    |
+  +-------------------+----------+------------------------------------------------+
+  | ``email``         |    no    | Physical location email.                       |
+  +-------------------+----------+------------------------------------------------+
+  | ``name``          |    yes   | Physical location name.                        |
+  +-------------------+----------+------------------------------------------------+
+  | ``phone``         |    no    | Physical location phone.                       |
+  +-------------------+----------+------------------------------------------------+
+  | ``poc``           |    no    | Physical location point of contact.            |
+  +-------------------+----------+------------------------------------------------+
+  | ``regionId``      |    no    | Physical location region ID.                   |
+  +-------------------+----------+------------------------------------------------+
+  | ``shortName``     |    yes   | Physical location short name.                  |
+  +-------------------+----------+------------------------------------------------+
+  | ``state``         |    yes   | Physical location state.                       |
+  +-------------------+----------+------------------------------------------------+
+  | ``zip``           |    yes   | Physical location zip.                         |
+  +-------------------+----------+------------------------------------------------+
+
+  **Request Example** ::
+
+     {
+        "regionId": "1",
+        "poc": "Jane Doesssss",
+        "name": "Albuquerque",
+        "comments": "Albuquerque",
+        "phone": "(123) 555-1111",
+        "state": "NM",
+        "email": "jane.doe@email.com",
+        "city": "Albuquerque",
+        "zip": "87107",
+        "address": "123 East 9rd St",
+        "shortName": "Albuquerque"
+     }
+
+|
+
+
+  **Response Properties**
+
+  +----------------------+--------+------------------------------------------------+
+  | Parameter            | Type   | Description                                    |
+  +======================+========+================================================+
+  |``address``           | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``city``              | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``comments``          | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``email``             | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``id``                | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``lastUpdated``       | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``name``              | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``phone``             | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``poc``               | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``region``            | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``regionId``          | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``shortName``         | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``state``             | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``zip``               | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+
+
+  **Response Example** ::
+
+    {
+     "alerts": [
+        {
+            "level": "success",
+            "text": "Physical location update was successful."
+        }
+      ],
+     "response": [
+        {
+           "region": "Mile High",
+           "region": "4",
+           "poc": "Jane Doe",
+           "lastUpdated": "2014-10-02 08:22:43",
+           "name": "Albuquerque",
+           "comments": "Albuquerque",
+           "phone": "(123) 555-1111",
+           "state": "NM",
+           "email": "jane.doe@email.com",
+           "city": "Albuquerque",
+           "zip": "87107",
+           "id": "2",
+           "address": "123 East 3rd St",
+           "shortName": "Albuquerque"
+        }
+     ]
+    }
+
+|
+
+
+**POST /api/1.2/regions/:region_name/phys_locations**
+  Create physical location.
+
+  Authentication Required: Yes
+
+  Role(s) Required: admin or oper
+
+  region_name: the name of the region to create physical location into.
+
+  **Request Route Parameters**
+
+  +-----------------+----------+-----------------------------------+
+  | Name            | Required | Description                       |
+  +=================+==========+===================================+
+  | ``region_name`` | yes      | The name of the physical location |
+  +-----------------+----------+-----------------------------------+
+
+  **Request Properties**
+  
+  +-----------------+----------+---------------------------------------------------+
+  | Parameter       | Required | Description                                       |
+  +=================+==========+===================================================+
+  | ``name``        | yes      | The name of the location                          |
+  +-----------------+----------+---------------------------------------------------+
+  | ``shortName``   | yes      | The short name of the location                    |
+  +-----------------+----------+---------------------------------------------------+
+  | ``address``     | yes      |                                                   |
+  +-----------------+----------+---------------------------------------------------+
+  | ``city``        | yes      |                                                   |
+  +-----------------+----------+---------------------------------------------------+
+  | ``state``       | yes      |                                                   |
+  +-----------------+----------+---------------------------------------------------+
+  | ``zip``         | yes      |                                                   |
+  +-----------------+----------+---------------------------------------------------+
+  | ``phone``       | no       |                                                   |
+  +-----------------+----------+---------------------------------------------------+
+  | ``poc``         | no       | Point of contact                                  |
+  +-----------------+----------+---------------------------------------------------+
+  | ``email``       | no       |                                                   |
+  +-----------------+----------+---------------------------------------------------+
+  | ``comments``    | no       |                                                   |
+  +-----------------+----------+---------------------------------------------------+
+
+  **Request Example** ::
+
+    {
+        "name" : "my physical location1",
+        "shortName" : "myphylocation1",
+        "address" : "",
+        "city" : "Shanghai",
+        "state": "SH",
+        "zip": "200000",
+        "comments": "this is physical location1"
+    }
+   
+|
+
+  **Response Properties**
+
+  +-----------------+--------+---------------------------------------------------+
+  | Parameter       | Type   | Description                                       |
+  +=================+========+===================================================+
+  | ``id``          | string | The id of the physical location created.          |
+  +-----------------+--------+---------------------------------------------------+
+  | ``name``        | string | The name of the location                          |
+  +-----------------+--------+---------------------------------------------------+
+  | ``shortName``   | string | The short name of the location                    |
+  +-----------------+--------+---------------------------------------------------+
+  | ``regionName``  | string | The region name the physical location belongs to. |
+  +-----------------+--------+---------------------------------------------------+
+  | ``regionId``    | string |                                                   |
+  +-----------------+--------+---------------------------------------------------+
+  | ``address``     | string |                                                   |
+  +-----------------+--------+---------------------------------------------------+
+  | ``city``        | string |                                                   |
+  +-----------------+--------+---------------------------------------------------+
+  | ``state``       | string |                                                   |
+  +-----------------+--------+---------------------------------------------------+
+  | ``zip``         | string |                                                   |
+  +-----------------+--------+---------------------------------------------------+
+  | ``phone``       | string |                                                   |
+  +-----------------+--------+---------------------------------------------------+
+  | ``poc``         | string | Point of contact                                  |
+  +-----------------+--------+---------------------------------------------------+
+  | ``email``       | string |                                                   |
+  +-----------------+--------+---------------------------------------------------+
+  | ``comments``    | string |                                                   |
+  +-----------------+--------+---------------------------------------------------+
+
+  **Response Example** ::
+
+    {
+      "response": {
+        'shortName': 'myphylocati',
+        'regionName': 'myregion1',
+        'name': 'my physical location1',
+        'poc': '',
+        'phone': '',
+        'comments': 'this is physical location1',
+        'state': 'SH',
+        'email': '',
+        'zip': '20000',
+        'region_id': '20',
+        'city': 'Shanghai',
+        'address': '',
+        'id': '200'
+     }
+   }
+
+|

http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/24ff8964/docs/2.1.x/_sources/development/traffic_ops_api/v12/profile.rst.txt
----------------------------------------------------------------------
diff --git a/docs/2.1.x/_sources/development/traffic_ops_api/v12/profile.rst.txt b/docs/2.1.x/_sources/development/traffic_ops_api/v12/profile.rst.txt
new file mode 100644
index 0000000..ae9fcda
--- /dev/null
+++ b/docs/2.1.x/_sources/development/traffic_ops_api/v12/profile.rst.txt
@@ -0,0 +1,393 @@
+.. 
+.. 
+.. Licensed under the Apache License, Version 2.0 (the "License");
+.. you may not use this file except in compliance with the License.
+.. You may obtain a copy of the License at
+.. 
+..     http://www.apache.org/licenses/LICENSE-2.0
+.. 
+.. Unless required by applicable law or agreed to in writing, software
+.. distributed under the License is distributed on an "AS IS" BASIS,
+.. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+.. See the License for the specific language governing permissions and
+.. limitations under the License.
+.. 
+
+.. _to-api-v12-profile:
+
+
+Profiles
+========
+
+.. _to-api-v12-profiles-route:
+
+/api/1.2/profiles
++++++++++++++++++
+
+**GET /api/1.2/profiles**
+
+	Authentication Required: Yes
+
+	Role(s) Required: None
+
+	**Request Query Parameters**
+
+	+---------------+----------+----------------------------------------------------+
+	|    Name       | Required |                    Description                     |
+	+===============+==========+====================================================+
+	| ``param``     |   no     | Used to filter profiles by parameter ID.           |
+	+---------------+----------+----------------------------------------------------+
+	| ``cdn``       |   no     | Used to filter profiles by CDN ID.                 |
+	+---------------+----------+----------------------------------------------------+
+
+	**Response Properties**
+
+	+-----------------+--------+----------------------------------------------------+
+	|    Parameter    |  Type  |                    Description                     |
+	+=================+========+====================================================+
+	| ``id``          | string | Primary key                                        |
+	+-----------------+--------+----------------------------------------------------+
+	| ``name``        | string | The name for the profile                           |
+	+-----------------+--------+----------------------------------------------------+
+	| ``description`` | string | The description for the profile                    |
+	+-----------------+--------+----------------------------------------------------+
+	| ``cdn``         |  int   | The CDN ID                                         |
+	+-----------------+--------+----------------------------------------------------+
+	| ``cdnName``     | string | The CDN name                                       |
+	+-----------------+--------+----------------------------------------------------+
+	| ``type``        | string | Profile type                                       |
+	+-----------------+--------+----------------------------------------------------+
+	| ``lastUpdated`` | array  | The Time / Date this server entry was last updated |
+	+-----------------+--------+----------------------------------------------------+
+
+  **Response Example** ::
+
+    {
+     "response": [
+        {
+            "id": "8",
+            "name": "EDGE_27_PROFILE",
+            "description": "A profile with all the Foo parameters"
+            "cdn": 1
+            "cdnName": "cdn1"
+            "type": "ATS_PROFILE"
+            "lastUpdated": "2012-10-08 19:34:45",
+        }
+     ]
+    }
+
+|
+
+**GET /api/1.2/profiles/trimmed**
+
+	Authentication Required: Yes
+
+	Role(s) Required: None
+
+	**Response Properties**
+
+	+-----------------+--------+----------------------------------------------------+
+	|    Parameter    |  Type  |                    Description                     |
+	+=================+========+====================================================+
+	| ``name``        | string | The name for the profile                           |
+	+-----------------+--------+----------------------------------------------------+
+
+  **Response Example** ::
+
+    {
+     "response": [
+        {
+            "name": "EDGE_27_PROFILE"
+        }
+     ]
+    }
+
+|
+
+**GET /api/1.2/profiles/:id**
+
+	Authentication Required: Yes
+
+	Role(s) Required: None
+
+	**Request Route Parameters**
+
+	+-----------------+------------+------------------------------------------------+
+	|    Parameter    |  Required  |                    Description                 |
+	+=================+============+================================================+
+	| ``id``          |    yes     | The ID of the profile.                         |
+	+-----------------+------------+------------------------------------------------+
+
+	**Response Properties**
+
+	+-----------------+--------+----------------------------------------------------+
+	|    Parameter    |  Type  |                    Description                     |
+	+=================+========+====================================================+
+	| ``id``          | string | Primary key                                        |
+	+-----------------+--------+----------------------------------------------------+
+	| ``name``        | string | The name for the profile                           |
+	+-----------------+--------+----------------------------------------------------+
+	| ``description`` | string | The description for the profile                    |
+	+-----------------+--------+----------------------------------------------------+
+	| ``cdn``         |  int   | The CDN ID                                         |
+	+-----------------+--------+----------------------------------------------------+
+	| ``cdnName``     | string | The CDN name                                       |
+	+-----------------+--------+----------------------------------------------------+
+	| ``type``        | string | Profile type                                       |
+	+-----------------+--------+----------------------------------------------------+
+	| ``lastUpdated`` | array  | The Time / Date this server entry was last updated |
+	+-----------------+--------+----------------------------------------------------+
+
+  **Response Example** ::
+
+    {
+     "response": [
+        {
+            "id": "8",
+            "name": "EDGE_27_PROFILE",
+            "description": "A profile with all the Foo parameters"
+            "cdn": 1
+            "cdnName": "cdn1"
+            "type": "ATS_PROFILE"
+            "lastUpdated": "2012-10-08 19:34:45",
+        }
+     ]
+    }
+
+|
+
+
+**POST /api/1.2/profiles**
+    Create a new empty profile.
+
+	Authentication Required: Yes
+
+	Role(s) Required: admin or oper
+
+	**Request Properties**
+
+	+-----------------------+--------+----------+-----------------------------------------+
+	|  Parameter            |  Type  | Required |           Description                   |
+	+=======================+========+==========+=========================================+
+	| ``name``              | string | yes      | Profile name                            |
+	+-----------------------+--------+----------+-----------------------------------------+
+	| ``description``       | string | yes      | Profile description                     |
+	+-----------------------+--------+----------+-----------------------------------------+
+	| ``cdn``               |  int   | no       | CDN ID                                  |
+	+-----------------------+--------+----------+-----------------------------------------+
+	| ``type``              | string | yes      | Profile type                            |
+	+-----------------------+--------+----------+-----------------------------------------+
+
+
+  **Request Example** ::
+
+    {
+      "name": "EDGE_28_PROFILE",
+      "description": "EDGE_28_PROFILE description",
+      "cdn": 1,
+      "type": "ATS_PROFILE"
+    }
+
+|
+
+	**Response Properties**
+
+	+-----------------------+--------+----------------------------------------------------+
+	|    Parameter          |  Type  |                    Description                     |
+	+=======================+========+====================================================+
+	| ``id``                | string | Profile ID                                         |
+	+-----------------------+--------+----------------------------------------------------+
+	| ``name``              | string | Profile name                                       |
+	+-----------------------+--------+----------------------------------------------------+
+	| ``description``       | string | Profile description                                |
+	+-----------------------+--------+----------------------------------------------------+
+	| ``cdn``               |  int   | CDN ID                                             |
+	+-----------------------+--------+----------------------------------------------------+
+	| ``type``              | string | Profile type                                       |
+	+-----------------------+--------+----------------------------------------------------+
+
+  **Response Example** ::
+
+    {
+     "response": [
+        {
+            "id": "66",
+            "name": "EDGE_28_PROFILE",
+            "description": "EDGE_28_PROFILE description",
+		  	"cdn": 1,
+      		"type": "ATS_PROFILE"
+        }
+     ]
+    }
+
+|
+
+**POST /api/1.2/profiles/name/:profile_name/copy/:profile_copy_from**
+    Copy profile to a new profile. The new profile name must not exist. 
+
+	Authentication Required: Yes
+
+	Role(s) Required: admin or oper
+
+	**Request Route Parameters**
+   
+	+-----------------------+----------+-------------------------------+
+	| Name                  | Required | Description                   |
+	+=======================+==========+===============================+
+	| ``profile_name``      | yes      | The name of profile to copy   |
+	+-----------------------+----------+-------------------------------+
+	| ``profile_copy_from`` | yes      | The name of profile copy from |
+	+-----------------------+----------+-------------------------------+
+
+
+	**Response Properties**
+
+	+-----------------------+--------+----------------------------------------------------+
+	|    Parameter          |  Type  |                    Description                     |
+	+=======================+========+====================================================+
+	| ``id``                | string | Id of the new profile                              |
+	+-----------------------+--------+----------------------------------------------------+
+	| ``name``              | string | The name of the new profile                        |
+	+-----------------------+--------+----------------------------------------------------+
+	| ``profileCopyFrom``   | string | The name of profile to copy                        |
+	+-----------------------+--------+----------------------------------------------------+
+	| ``idCopyFrom``        | string | The id of profile to copy                          |
+	+-----------------------+--------+----------------------------------------------------+
+	| ``description``       | string | new profile's description (copied)                 |
+	+-----------------------+--------+----------------------------------------------------+
+
+  **Response Example** ::
+
+    {
+     "response": [
+        {
+            "id": "66",
+            "name": "CCR_COPY",
+            "profileCopyFrom": "CCR1",
+            "description": "CCR_COPY description",
+            "idCopyFrom": "3"
+        }
+     ]
+    }
+
+|
+
+**PUT /api/1.2/profiles/{:id}**
+
+    Allows user to edit a profile.
+
+	Authentication Required: Yes
+
+	Role(s) Required:  admin or oper
+
+	**Request Route Parameters**
+
+	+-----------------+----------+---------------------------------------------------+
+	| Name            | Required | Description                                       |
+	+=================+==========+===================================================+
+	| ``id``          | yes      | profile id.                                       |
+	+-----------------+----------+---------------------------------------------------+
+
+	**Request Properties**
+
+	+-----------------------+--------+----------+-----------------------------------------+
+	|  Parameter            |  Type  | Required |           Description                   |
+	+=======================+========+==========+=========================================+
+	| ``name``              | string | yes      | Profile name                            |
+	+-----------------------+--------+----------+-----------------------------------------+
+	| ``description``       | string | yes      | Profile description                     |
+	+-----------------------+--------+----------+-----------------------------------------+
+	| ``cdn``               |  int   | no       | CDN ID - must use the same ID as any    |
+	|                       |        |          | servers assigned to the profile.        |
+	+-----------------------+--------+----------+-----------------------------------------+
+	| ``type``              | string | yes      | Profile type                            |
+	+-----------------------+--------+----------+-----------------------------------------+
+
+  **Request Example** ::
+
+    {
+      "name": "EDGE_28_PROFILE",
+      "description": "EDGE_28_PROFILE description",
+      "cdn": 1,
+      "type": "ATS_PROFILE"
+    }
+
+ 	**Response Properties**
+
+	+-----------------------+--------+----------------------------------------------------+
+	|    Parameter          |  Type  |                    Description                     |
+	+=======================+========+====================================================+
+	| ``id``                | string | Profile ID                                         |
+	+-----------------------+--------+----------------------------------------------------+
+	| ``name``              | string | Profile name                                       |
+	+-----------------------+--------+----------------------------------------------------+
+	| ``description``       | string | Profile description                                |
+	+-----------------------+--------+----------------------------------------------------+
+	| ``cdn``               |  int   | CDN ID                                             |
+	+-----------------------+--------+----------------------------------------------------+
+	| ``type``              | string | Profile type                                       |
+	+-----------------------+--------+----------------------------------------------------+
+
+  **Response Example** ::
+
+    {
+      "response":{
+        "id": "219",
+        "name": "EDGE_28_PROFILE",
+        "description": "EDGE_28_PROFILE description"
+        "cdn": 1
+        "type": "ATS_PROFILE"
+      }
+      "alerts":[
+        {
+          "level": "success",
+          "text": "Profile was updated: 219"
+        }
+      ]
+    }
+
+|
+
+**DELETE /api/1.2/profiles/{:id}**
+
+  Allows user to delete a profile.
+
+	Authentication Required: Yes
+
+	Role(s) Required:  admin or oper
+
+	**Request Route Parameters**
+
+	+-----------------+----------+----------------------------+
+	| Name            | Required | Description                |
+	+=================+==========+============================+
+	| ``id``          | yes      | profile id.                |
+	+-----------------+----------+----------------------------+
+
+ 	**Response Properties**
+
+	+-------------+--------+----------------------------------+
+	|  Parameter  |  Type  |           Description            |
+	+=============+========+==================================+
+	| ``alerts``  | array  | A collection of alert messages.  |
+	+-------------+--------+----------------------------------+
+	| ``>level``  | string | success, info, warning or error. |
+	+-------------+--------+----------------------------------+
+	| ``>text``   | string | Alert message.                   |
+	+-------------+--------+----------------------------------+
+	| ``version`` | string |                                  |
+	+-------------+--------+----------------------------------+
+
+  **Response Example** ::
+
+    {
+      "alerts": [
+        {
+          "level": "success",
+          "text": "Profile was deleted."
+        }
+      ]
+    }
+
+|
+

http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/24ff8964/docs/2.1.x/_sources/development/traffic_ops_api/v12/profile_parameter.rst.txt
----------------------------------------------------------------------
diff --git a/docs/2.1.x/_sources/development/traffic_ops_api/v12/profile_parameter.rst.txt b/docs/2.1.x/_sources/development/traffic_ops_api/v12/profile_parameter.rst.txt
new file mode 100644
index 0000000..31b5789
--- /dev/null
+++ b/docs/2.1.x/_sources/development/traffic_ops_api/v12/profile_parameter.rst.txt
@@ -0,0 +1,457 @@
+.. 
+.. 
+.. Licensed under the Apache License, Version 2.0 (the "License");
+.. you may not use this file except in compliance with the License.
+.. You may obtain a copy of the License at
+.. 
+..     http://www.apache.org/licenses/LICENSE-2.0
+.. 
+.. Unless required by applicable law or agreed to in writing, software
+.. distributed under the License is distributed on an "AS IS" BASIS,
+.. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+.. See the License for the specific language governing permissions and
+.. limitations under the License.
+.. 
+
+.. _to-api-v12-profileparameters:
+
+
+Profile parameters
+==================
+
+.. _to-api-v12-profileparameters-route:
+
+/api/1.2/profileparameters
+++++++++++++++++++++++++++
+
+**POST /api/1.2/profileparameters**
+
+    Associate parameter to profile.
+
+	Authentication Required: Yes
+
+	Role(s) Required:  admin or oper
+
+	**Request Properties**
+	This accept two formats: single profile-parameter, profile-parameter array.
+
+	Single profile-parameter format:
+
+	+------------------+----------+----------------------------------------------------+
+	| Parameter        | Required | Description                                        |
+	+==================+==========+====================================================+
+	| ``profileId``    | yes      | profile id.                                        |
+	+------------------+----------+----------------------------------------------------+
+	| ``parameterId``  | yes      | parameter id.                                      |
+	+------------------+----------+----------------------------------------------------+
+
+	Profile-parameter array format:
+
+	+------------------+----------+----------------------------------------------------+
+	| Parameter        | Required | Description                                        |
+	+==================+==========+====================================================+
+	|                  | yes      | profile-parameter array.                           |
+	+------------------+----------+----------------------------------------------------+
+	| ``>profileId``   | yes      | profile id.                                        |
+	+------------------+----------+----------------------------------------------------+
+	| ``>parameterId`` | yes      | parameter id.                                      |
+	+------------------+----------+----------------------------------------------------+
+
+  **Request Example** ::
+
+    Single profile-parameter format:
+
+    {
+      "profileId": 2,
+      "parameterId": 6
+    }
+
+    Profile-parameter array format:
+
+    [
+        {
+          "profileId": 2,
+          "parameterId": 6
+        },
+        {
+          "profileId": 2,
+          "parameterId": 7
+        },
+        {
+          "profileId": 3,
+          "parameterId": 6
+        }
+    ]
+
+ 	**Response Properties**
+
+	+-------------------+---------+-----------------------------------------------------+
+	|  Parameter        |  Type   |           Description                               |
+	+===================+=========+=====================================================+
+	| ``response``      | array   | Profile-parameter associations.                     |
+	+-------------------+---------+-----------------------------------------------------+
+	| ``>profileId``    | string  | Profile id.                                         |
+	+-------------------+---------+-----------------------------------------------------+
+	| ``>parameterId``  | string  | Parameter id.                                       |
+	+-------------------+---------+-----------------------------------------------------+
+	| ``alerts``        | array   | A collection of alert messages.                     |
+	+-------------------+---------+-----------------------------------------------------+
+	| ``>level``        | string  | success, info, warning or error.                    |
+	+-------------------+---------+-----------------------------------------------------+
+	| ``>text``         | string  | Alert message.                                      |
+	+-------------------+---------+-----------------------------------------------------+
+	| ``version``       | string  |                                                     |
+	+-------------------+---------+-----------------------------------------------------+
+
+  **Response Example** ::
+
+    {
+      "response":[
+        {
+          "profileId": "2",
+          "parameterId": "6"
+        },
+        {
+          "profileId": "2",
+          "parameterId": "7"
+        },
+        {
+          "profileId": "3",
+          "parameterId": "6"
+        }
+      ]
+      "alerts":[
+        {
+          "level": "success",
+          "text": "Profile parameter associations were created."
+        }
+      ]
+    }
+
+|
+
+**DELETE /api/1.2/profileparameters/{:profile_id}/{:parameter_id}**
+
+    Delete a profile parameter association.
+
+	Authentication Required: Yes
+
+	Role(s) Required:  admin or oper
+
+	**Request Route Parameters**
+
+	+------------------+----------+----------------------------------------------------+
+	| Name             | Required | Description                                        |
+	+==================+==========+====================================================+
+	| ``profile_id``   | yes      | profile id.                                        |
+	+------------------+----------+----------------------------------------------------+
+	| ``parameter_id`` | yes      | parameter id.                                      |
+	+------------------+----------+----------------------------------------------------+
+
+ 	**Response Properties**
+
+	+-------------------+--------+-----------------------------------------------------+
+	|  Parameter        |  Type  |           Description                               |
+	+===================+========+=====================================================+
+	| ``alerts``        | array  | A collection of alert messages.                     |
+	+-------------------+--------+-----------------------------------------------------+
+	| ``>level``        | string | success, info, warning or error.                    |
+	+-------------------+--------+-----------------------------------------------------+
+	| ``>text``         | string | Alert message.                                      |
+	+-------------------+--------+-----------------------------------------------------+
+	| ``version``       | string |                                                     |
+	+-------------------+--------+-----------------------------------------------------+
+
+  **Response Example** ::
+
+    {
+      "alerts":[
+        {
+          "level": "success",
+          "text": "Profile parameter association was deleted."
+        }
+      ]
+    }
+
+|
+
+**POST /api/1.2/profiles/name/{:name}/parameters**
+
+    Associate parameters to a profile. If the parameter does not exist, create it and associate to the profile. If the parameter already exists, associate it to the profile. If the parameter already associate the profile, keep the association.
+    If the profile does not exist, the API returns fail.
+
+    Authentication Required: Yes
+
+    Role(s) Required:  admin or oper. If there is parameter's secure equals 1 in the request properties, need admin role. 
+
+	**Request Route Parameters**
+
+	+------------+----------+----------------------------------------------------+
+	| Name       | Required | Description                                        |
+	+============+==========+====================================================+
+	| ``name``   | yes      | profile name.                                      |
+	+------------+----------+----------------------------------------------------+
+
+    **Request Properties**
+    The request properties accept 2 formats, both single paramter and parameters array formats are acceptable.
+
+    single parameter format:
+
+    +-----------------+----------+---------+--------------------------------------------------------------------------------------+
+    | Name            | Required | Type    | Description                                                                          |
+    +=================+==========+=========+======================================================================================+
+    | ``name``        | yes      | string  | parameter name                                                                       |
+    +-----------------+----------+---------+--------------------------------------------------------------------------------------+
+    | ``configFile``  | yes      | string  | parameter config_file                                                                |
+    +-----------------+----------+---------+--------------------------------------------------------------------------------------+
+    | ``value``       | yes      | string  | parameter value                                                                      |
+    +-----------------+----------+---------+--------------------------------------------------------------------------------------+
+    | ``secure``      | yes      | integer | secure flag, when 1, the parameter is accessible only by admin users. Defaults to 0. |
+    +-----------------+----------+---------+--------------------------------------------------------------------------------------+
+
+    array parameters format:
+
+    +-----------------+----------+---------+--------------------------------------------------------------------------------------+
+    | Name            | Required | Type    | Description                                                                          |
+    +=================+==========+=========+======================================================================================+
+    |                 | yes      | array   | parameters array                                                                     |
+    +-----------------+----------+---------+--------------------------------------------------------------------------------------+
+    | ``>name``       | yes      | string  | parameter name                                                                       |
+    +-----------------+----------+---------+--------------------------------------------------------------------------------------+
+    | ``>configFile`` | yes      | string  | parameter config_file                                                                |
+    +-----------------+----------+---------+--------------------------------------------------------------------------------------+
+    | ``>value``      | yes      | string  | parameter value                                                                      |
+    +-----------------+----------+---------+--------------------------------------------------------------------------------------+
+    | ``>secure``     | yes      | integer | secure flag, when 1, the parameter is accessible only by admin users. Defaults to 0. |
+    +-----------------+----------+---------+--------------------------------------------------------------------------------------+
+
+  **Request Example** ::
+
+    1. single parameter format exampe:  
+    {
+        "name":"param1", 
+        "configFile":"configFile1",  
+        "value":"value1",   
+        "secure":0,  
+    }
+
+    2. array format example:  
+    [
+      {
+          "name":"param1",
+          "configFile":"configFile1",
+          "value":"value1",
+          "secure":0,
+      },
+      {
+          "name":"param2",
+          "configFile":"configFile2",
+          "value":"value2",
+          "secure":1,
+      }
+    ]
+
+
+  **Response Properties** ::
+
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | Name             | Type    | Description                                                                          |
+    +==================+=========+======================================================================================+
+    | ``response``     |         | Parameters associated with the profile.                                              |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | ``>profileName`` | string  | profile name                                                                         |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | ``>profileId``   | integer | profile index                                                                        |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | ``>parameters``  | array   | parameters array                                                                     |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | ``>>id``         | integer | parameter index                                                                      |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | ``>>name``       | string  | parameter name                                                                       |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | ``>>configFile`` | string  | parameter config_file                                                                |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | ``>>value``      | string  | parameter value                                                                      |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | ``>>secure``     | integer | secure flag, when 1, the parameter is accessible only by admin users. Defaults to 0. |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | ``alerts``       | array   | A collection of alert messages.                                                      |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | ``>level``       | string  | success, info, warning or error.                                                     |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | ``>text``        | string  | Alert message.                                                                       |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | ``version``      | string  |                                                                                      |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+
+  **Response Example** ::
+
+    {
+      "response":{
+        "profileName": "CCR1",
+        "profileId" : "12",
+        "parameters":[
+            {
+                "name":"param1",
+                "configFile":"configFile1"
+                "value":"value1",
+                "secure":"0",
+            },
+            {
+                "name":"param2",
+                "configFile":"configFile2"
+                "value":"value2",
+                "secure":"1",
+            }
+        ]
+      }
+      "alerts":[
+        {
+          "level": "success",
+          "text": ""Assign parameters successfully to profile CCR1"
+        }
+      ]
+    }
+
+|
+
+**POST /api/1.2/profiles/id/{:id}/parameters**
+
+    Associate parameters to a profile. If the parameter does not exist, create it and associate to the profile. If the parameter already exists, associate it to the profile. If the parameter already associate the profile, keep the association.
+    If the profile does not exist, the API returns fail.
+
+    Authentication Required: Yes
+
+    Role(s) Required:  admin or oper. If there is parameter's secure equals 1 in the request properties, need admin role. 
+
+	**Request Route Parameters**
+
+	+------------+----------+----------------------------------------------------+
+	| Name       | Required | Description                                        |
+	+============+==========+====================================================+
+	| ``id``     | yes      | profile name.                                      |
+	+------------+----------+----------------------------------------------------+
+
+    **Request Properties**
+    The request properties accept 2 formats, both single paramter and parameters array formats are acceptable.
+
+    single parameter format:
+
+    +-----------------+----------+---------+--------------------------------------------------------------------------------------+
+    | Name            | Required | Type    | Description                                                                          |
+    +=================+==========+=========+======================================================================================+
+    | ``name``        | yes      | string  | parameter name                                                                       |
+    +-----------------+----------+---------+--------------------------------------------------------------------------------------+
+    | ``configFile``  | yes      | string  | parameter config_file                                                                |
+    +-----------------+----------+---------+--------------------------------------------------------------------------------------+
+    | ``value``       | yes      | string  | parameter value                                                                      |
+    +-----------------+----------+---------+--------------------------------------------------------------------------------------+
+    | ``secure``      | yes      | integer | secure flag, when 1, the parameter is accessible only by admin users. Defaults to 0. |
+    +-----------------+----------+---------+--------------------------------------------------------------------------------------+
+
+    array parameters format:
+
+    +-----------------+----------+---------+--------------------------------------------------------------------------------------+
+    | Name            | Required | Type    | Description                                                                          |
+    +=================+==========+=========+======================================================================================+
+    |                 | yes      | array   | parameters array                                                                     |
+    +-----------------+----------+---------+--------------------------------------------------------------------------------------+
+    | ``>name``       | yes      | string  | parameter name                                                                       |
+    +-----------------+----------+---------+--------------------------------------------------------------------------------------+
+    | ``>configFile`` | yes      | string  | parameter config_file                                                                |
+    +-----------------+----------+---------+--------------------------------------------------------------------------------------+
+    | ``>value``      | yes      | string  | parameter value                                                                      |
+    +-----------------+----------+---------+--------------------------------------------------------------------------------------+
+    | ``>secure``     | yes      | integer | secure flag, when 1, the parameter is accessible only by admin users. Defaults to 0. |
+    +-----------------+----------+---------+--------------------------------------------------------------------------------------+
+
+  **Request Example** ::
+
+    1. single parameter format exampe:  
+    {
+        "name":"param1", 
+        "configFile":"configFile1",  
+        "value":"value1",   
+        "secure":0,  
+    }
+
+    2. array format example:  
+    [
+      {
+          "name":"param1",
+          "configFile":"configFile1",
+          "value":"value1",
+          "secure":0,
+      },
+      {
+          "name":"param2",
+          "configFile":"configFile2",
+          "value":"value2",
+          "secure":1,
+      }
+    ]
+
+
+  **Response Properties** ::
+
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | Name             | Type    | Description                                                                          |
+    +==================+=========+======================================================================================+
+    | ``response``     |         | Parameters associated with the profile.                                              |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | ``>profileName`` | string  | profile name                                                                         |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | ``>profileId``   | integer | profile index                                                                        |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | ``>parameters``  | array   | parameters array                                                                     |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | ``>>id``         | integer | parameter index                                                                      |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | ``>>name``       | string  | parameter name                                                                       |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | ``>>configFile`` | string  | parameter config_file                                                                |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | ``>>value``      | string  | parameter value                                                                      |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | ``>>secure``     | integer | secure flag, when 1, the parameter is accessible only by admin users. Defaults to 0. |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | ``alerts``       | array   | A collection of alert messages.                                                      |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | ``>level``       | string  | success, info, warning or error.                                                     |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | ``>text``        | string  | Alert message.                                                                       |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+    | ``version``      | string  |                                                                                      |
+    +------------------+---------+--------------------------------------------------------------------------------------+
+
+  **Response Example** ::
+
+    {
+      "response":{
+        "profileName": "CCR1",
+        "profileId" : "12",
+        "parameters":[
+            {
+                "name":"param1",
+                "configFile":"configFile1"
+                "value":"value1",
+                "secure":"0",
+            },
+            {
+                "name":"param2",
+                "configFile":"configFile2"
+                "value":"value2",
+                "secure":"1",
+            }
+        ]
+      }
+      "alerts":[
+        {
+          "level": "success",
+          "text": ""Assign parameters successfully to profile CCR1"
+        }
+      ]
+    }
+
+|
+

http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/24ff8964/docs/2.1.x/_sources/development/traffic_ops_api/v12/region.rst.txt
----------------------------------------------------------------------
diff --git a/docs/2.1.x/_sources/development/traffic_ops_api/v12/region.rst.txt b/docs/2.1.x/_sources/development/traffic_ops_api/v12/region.rst.txt
new file mode 100644
index 0000000..74e6fbf
--- /dev/null
+++ b/docs/2.1.x/_sources/development/traffic_ops_api/v12/region.rst.txt
@@ -0,0 +1,244 @@
+.. 
+.. 
+.. Licensed under the Apache License, Version 2.0 (the "License");
+.. you may not use this file except in compliance with the License.
+.. You may obtain a copy of the License at
+.. 
+..     http://www.apache.org/licenses/LICENSE-2.0
+.. 
+.. Unless required by applicable law or agreed to in writing, software
+.. distributed under the License is distributed on an "AS IS" BASIS,
+.. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+.. See the License for the specific language governing permissions and
+.. limitations under the License.
+.. 
+
+.. _to-api-v12-region:
+
+Regions
+=======
+
+.. _to-api-v12-regions-route:
+
+/api/1.2/regions
+++++++++++++++++
+
+**GET /api/1.1/regions**
+
+  Authentication Required: Yes
+
+  Role(s) Required: None
+
+  **Request Route Parameters**
+
+  +---------------+----------+---------------------------------------------+
+  |   Name        | Required |                Description                  |
+  +===============+==========+=============================================+
+  |  ``division`` |    no    | Filter regions by Division ID.              |
+  +---------------+----------+---------------------------------------------+
+
+  **Response Properties**
+
+  +----------------------+--------+------------------------------------------------+
+  | Parameter            | Type   | Description                                    |
+  +======================+========+================================================+
+  |``id``                | string | Region ID.                                     |
+  +----------------------+--------+------------------------------------------------+
+  |``name``              | string | Region name.                                   |
+  +----------------------+--------+------------------------------------------------+
+  |``division``          | string | Division ID.                                   |
+  +----------------------+--------+------------------------------------------------+
+  |``divisionName``      | string | Division name.                                 |
+  +----------------------+--------+------------------------------------------------+
+
+  **Response Example** ::
+
+    {
+     "response": [
+        {
+           "id": "6",
+           "name": "Atlanta",
+           "division": "2",
+           "divisionName": "West"
+        },
+        {
+           "id": "7",
+           "name": "Denver",
+           "division": "2",
+           "divisionName": "West"
+        },
+     ]
+    }
+
+
+**GET /api/1.1/regions/:id**
+
+  Authentication Required: Yes
+
+  Role(s) Required: None
+
+  **Request Route Parameters**
+
+  +-----------+----------+---------------------------------------------+
+  |   Name    | Required |                Description                  |
+  +===========+==========+=============================================+
+  |   ``id``  |   yes    | Region id.                                  |
+  +-----------+----------+---------------------------------------------+
+
+  **Response Properties**
+
+  +----------------------+--------+------------------------------------------------+
+  | Parameter            | Type   | Description                                    |
+  +======================+========+================================================+
+  |``id``                | string | Region ID.                                     |
+  +----------------------+--------+------------------------------------------------+
+  |``name``              | string | Region name.                                   |
+  +----------------------+--------+------------------------------------------------+
+  |``division``          | string | Division ID.                                   |
+  +----------------------+--------+------------------------------------------------+
+  |``divisionName``      | string | Division name.                                 |
+  +----------------------+--------+------------------------------------------------+
+
+  **Response Example** ::
+
+    {
+     "response": [
+        {
+           "id": "6",
+           "name": "Atlanta",
+           "division": "2",
+           "divisionName": "West"
+        }
+     ]
+    }
+
+
+**PUT /api/1.2/regions/:id**
+  Update a region
+
+  Authentication Required: Yes
+
+  Role(s) Required: admin or oper
+
+  **Request Route Parameters**
+
+  +-------------------+----------+------------------------------------------------+
+  | Name              |   Type   |                 Description                    |
+  +===================+==========+================================================+
+  | ``id``            | int      | Region id.                                     |
+  +-------------------+----------+------------------------------------------------+
+
+  **Request Properties**
+
+  +----------------+----------+--------------------------+
+  | Parameter      | Required | Description              |
+  +================+==========+==========================+
+  | ``name``       | yes      | The name of the region   |
+  +----------------+----------+--------------------------+
+  | ``division``   | yes      | The division Id          |
+  +----------------+----------+--------------------------+
+
+  **Request Example** ::
+
+    {
+        "name": "myregion1",
+        "division": "4"
+    }
+
+|
+
+  **Response Properties**
+
+  +----------------------+--------+------------------------------------------------+
+  | Parameter            | Type   | Description                                    |
+  +======================+========+================================================+
+  |``division``          | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``divisionName``      | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``name``              | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``id``                | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``lastUpdated``       | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+
+  **Response Example** ::
+
+	{
+		"alerts": [
+			{
+				"level": "success",
+				"text": "Region update was successful."
+			}
+		],
+		"response": {
+			"id": "1",
+			"lastUpdated": "2014-03-18 08:57:39",
+			"name": "myregion1",
+			"division": "4",
+			"divisionName": "mydivision1"
+		}
+	}
+  
+|
+
+**POST /api/1.2/divisions/:division_name/regions**
+  Create Region
+
+  Authentication Required: Yes
+
+  Role(s) Required: admin or oper
+
+  division_name - The name of division to create new region into.
+
+  ** Request Route Parameters**
+
+  +-------------------+----------+------------------------------------------------+
+  | Name              | Required | Description                                    |
+  +===================+==========+================================================+
+  | ``division_name`` | yes      | The name of division will create new region in |
+  +-------------------+----------+------------------------------------------------+
+
+  **Request Properties**
+
+  +-------------------+----------+------------------------------------------+
+  | Parameter         | Required | Description                              |
+  +===================+==========+==========================================+
+  | ``name``          | yes      | The name of the region                   |
+  +-------------------+----------+------------------------------------------+
+
+  **Request Example** ::
+
+    {
+        "name": "myregion1",
+    }
+
+|
+
+  **Response Properties**
+
+  +-------------------+--------+-------------------------------------------+
+  | Parameter         | Type   | Description                               |
+  +===================+========+===========================================+
+  | ``name``          | string | name of region created                    |
+  +-------------------+--------+-------------------------------------------+
+  | ``id``            | string | id of region created                      |
+  +-------------------+--------+-------------------------------------------+
+  | ``divisionName``  | string | the division name the region belongs to.  |
+  +-------------------+--------+-------------------------------------------+
+  | ``divisionId``    | string | the id of division the region belongs to. |
+  +-------------------+--------+-------------------------------------------+
+
+  **Response Example** ::
+
+    {
+      "response": {
+        'divisionName': 'mydivision1',
+        'divsionId': '4',
+        'name': 'myregion1',
+        'id': '19'
+       }
+    }
+
+|

http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/24ff8964/docs/2.1.x/_sources/development/traffic_ops_api/v12/role.rst.txt
----------------------------------------------------------------------
diff --git a/docs/2.1.x/_sources/development/traffic_ops_api/v12/role.rst.txt b/docs/2.1.x/_sources/development/traffic_ops_api/v12/role.rst.txt
new file mode 100644
index 0000000..b993c97
--- /dev/null
+++ b/docs/2.1.x/_sources/development/traffic_ops_api/v12/role.rst.txt
@@ -0,0 +1,59 @@
+.. 
+.. 
+.. Licensed under the Apache License, Version 2.0 (the "License");
+.. you may not use this file except in compliance with the License.
+.. You may obtain a copy of the License at
+.. 
+..     http://www.apache.org/licenses/LICENSE-2.0
+.. 
+.. Unless required by applicable law or agreed to in writing, software
+.. distributed under the License is distributed on an "AS IS" BASIS,
+.. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+.. See the License for the specific language governing permissions and
+.. limitations under the License.
+.. 
+
+.. _to-api-v12-roles:
+
+Roles
+=====
+
+.. _to-api-v12-roles-route:
+
+/api/1.2/roles
+++++++++++++++
+
+**GET /api/1.2/roles.json**
+
+  Authentication Required: Yes
+
+  Role(s) Required: None
+
+  **Response Properties**
+
+  +----------------------+--------+------------------------------------------------+
+  | Parameter            | Type   | Description                                    |
+  +======================+========+================================================+
+  |``name``              | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``id``                | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``privLevel``         | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+  |``description``       | string |                                                |
+  +----------------------+--------+------------------------------------------------+
+
+  **Response Example** ::
+
+    {
+     "response": [
+        {
+           "name": "read-only",
+           "id": "2",
+           "privLevel": "10",
+           "description": "read-only user"
+        }
+     ]
+    }
+
+|


Mime
View raw message