1. BC Change in APIv2

Before: A field FarmRole.networking.networks was optional for CREATE / UPDATE Farm Roles or Farm Templates.

After: A field FarmRole.networking.networks is mandatory for the Openstack platform for CREATE / UPDATE Farm Roles or Farm Templates.

2. BC Change in APIv2

 Role Object.  Role.deprecated has been replaced with inherited object with the information about deprecation. The field Role.deprecated became read only.

Before:

     {
	    "deprecated": true
     }
    

After:

    {
	    "deprecated": {
		  "deprecated": "2017-12-07T09:52:37Z",
		  "replacement": {
			"id": 41402
		  }
	    }      
    }
   

It is impossible to deprecate a Role through the PATCH /api/v1beta0/user/envId/roles/roleId/ action.

A new POST /api/v1beta0/user/envId/roles/roleId/actions/deprecate action must be used instead.

Before:

PATCH http://SCALR/api/v1beta0/user/5/roles/38775/ HTTP/1.1
Content-Type: application/json; charset=utf-8
X-Scalr-Key-Id: APIK4IZNYS0UXAJDIENJ
X-Scalr-Date: 2017-12-07T10:12:13Z
X-Scalr-Signature: ....
Content-Length: 19
{"deprecated":true}

HTTP/1.1 200 OK
Server: nginx/1.12.2
Date: Thu, 07 Dec 2017 10:12:13 GMT
Content-Type: application/json; utf-8
Content-Length: 428
{
	"meta": {
		"requestId": "86ebe675-655b-4686-a977-6e080c458fb9"
	},
	"data": {
		"id": 38775,
		"name": "base-centos6-devel",
		"description": "Development role",
		"quickStart": false,
		"deprecated": true,
		"useScalrAgent": true,
		"scope": "environment",
		"os": {
			"id": "centos-6-x"
		},
		"category": {
			"id": 9
		},
		"builtinAutomation": ["base", "chef"]
	},
	"warnings": []
}

After:

POST http://SCALR/api/v1beta0/user/5/roles/38775/actions/deprecate HTTP/1.1
Content-Type: application/json; charset=utf-8
X-Scalr-Key-Id: APIK12345
X-Scalr-Date: 2017-12-07T10:04:12Z
X-Scalr-Signature: .....
Content-Length: 40
{
	"deprecate": true,
	"replacement": {
		"id": 41402
	}
}

HTTP/1.1 200 OK
Server: nginx/1.12.2
Date: Thu, 07 Dec 2017 10:04:13 GMT
Content-Type: application/json; utf-8
Content-Length: 530
Connection: keep-alive
{
	"meta": {
		"requestId": "c5ca9c46-c7c7-415f-bbe6-b9e9699ef208",
	},
	"data": {
		"id": 38775,
		"name": "base-centos6-devel",
		"description": "Development role",
		"quickStart": false,
		"deprecated": {
			"deprecated": "2017-12-07T10:04:13Z",
			"replacement": {
				"id": 41402
			}
		},
		"useScalrAgent": true,
		"scope": "environment",
		"os": {
			"id": "centos-6-x"
		},
		"category": {
			"id": 9
		},
		"builtinAutomation": ["base", "chef"]
	},
	"warnings": []
}

Endpoint GET /api/v1beta0/user/envId/roles/ (all scopes) does not support a filter by a deprecated field (?deprecated=true|false)