| Anchor | ||||
|---|---|---|---|---|
|
...
GET (Using Query Parameters)
This GET service will return a list of environments in the form of JSON objects based on the query parameters code and name. Environments are only returned if they match all of the specified query parameters. If no query parameters are given this request will return the entire list of environments.
| Info | ||
|---|---|---|
| ||
http://host:port/flexdeploy/rest/topology/environment? Append the following character sequences to the above URL to specify Query parameters.Use '&' between successive query parameters:code={code} name={name} Examples:To search by code only:http://host:port/flexdeploy/rest/topology/environment?code={code} To search by name only:http://host:port/flexdeploy/rest/topology/environment?name={name} To search by code and name:http://host:port/flexdeploy/rest/topology/environment?code={code}&name={name} |
...
Parameter | Type | Required | Description |
|---|---|---|---|
Code | URL | No | This is a URL query parameter for the code which is used to search the environments. |
| Name | URL | No | This is a URL query parameter for the name which is used to search the environments. |
Response Codes
HTTP Code | Description |
|---|---|
| 200 | Environments were found and returned |
| 400 | Bad request |
| 401 | Unauthorized |
| 500 | Unexpected internal server error |
Example
If we had an environment in our database with an Id of 11101 and had the following attributes
...
Parameters
Parameters | Type | Required | Description |
|---|---|---|---|
| description | String | No | This is the description that the created environment will have. |
| instances | List<Long> | No | This is the list of Instance Ids that are assigned to the created environment. |
| isActive | Boolean | Yes | This is the isActive boolean that is true if the created environment is active. |
| environmentCode | String | Yes | This is the Code that the created environment will have. |
| sortNumber | Integer | Yes | This is the sort number that the created environment will have. |
| environmentId | Long | Yes | This is the Id place holder. This Id will not be given to the created environment. |
| isBuildEnvironment | Boolean | Yes | This is the isBuildEnvironment boolean that is true if the created environment is a build environment. |
| environmentName | String | Yes | This is the name of the created environment. |
Response Codes
HTTP Code | Description |
|---|---|
| 201 | Environment was created successfully |
| 400 | Bad request |
| 401 | Unauthorized |
| 404 | Environment not found |
| 500 | Unexpected internal server error |
Example
If the POST request receives the following JSON environment object,
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"description": "This is Post 1",
"instances": [15100,15101],
"isActive": true,
"environmentCode": "POST1",
"sortNumber": 1,
"environmentId":00000,
"isBuildEnvironment": true,
"environmentName": "Post 1"
} |
The following environment object will then be created as a new row in the database.
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"description": "This is Environment 1",
"instances": [15100],
"isActive": true,
"environmentCode": "ENV1",
"sortNumber": 1,
"environmentId": 11101,
"isBuildEnvironment": true,
"environmentName": "Env 1"
} |
...
| Info | ||
|---|---|---|
| ||
http://host:port/flexdeploy/rest/topology/environment/{Id} |
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"description": "This is Put 1",
"instances": [15100],
"isActive": false,
"environmentCode": "PUT1",
"sortNumber": 6,
"environmentId": 00000,
"isBuildEnvironment": true,
"environmentName": "Put 1"
} |
Parameters
Parameters | Type | Required | Description |
|---|---|---|---|
| Id | URL | Yes | This is a URL parameter for the Id which is used to find and return an environment with. |
| description | String | No | This is the description that the environment's description will be updated to. |
| instances | List<Long> | No | This is the list of Instance Ids that will be assigned to the environment that is being updated. |
| isActive | Boolean | Yes | This is the isActive boolean that the environment's isActive boolean will be updated to. |
| environmentCode | String | Yes | This is the Code that the environment's Code will be updated to. |
| sortNumber | Integer | Yes | This is the sort number that the environment's sort number will be updated to. |
| environmentId | Long | Yes | This is the Id place holder. This Id will not be updated in the environment. |
| isBuildEnvironment | Boolean | Yes | This is the isBuildEnvironment boolean that the environment's isBuildEnvironment boolean will be updated to. |
| environmentName | String | Yes | This is the name that the environment's name will be updated to. |
Response Codes
HTTP Code | Description |
|---|---|
| 200 | Environment was found and updated |
| 400 | Bad request |
| 401 | Unauthorized |
| 404 | Environment not found |
| 500 | Unexpected internal server error |
Example
If we had an environment in our database with an Id of 11101 and had the following attributes
...
PATCH
This PATCH service will update an existing environment with the information passed through a JSON object. If an attribute of the JSON is null it will not be updated in the environment.
| Info | ||
|---|---|---|
| ||
http://host:port/flexdeploy/rest/topology/environment/{Id} |
...
Parameters
Parameters | Type | Required | Description |
|---|---|---|---|
| Id | URL | Yes | This is a URL parameter for the Id which is used to find and return an environment with. |
| description | String | No | This is the description that the environment's description will be updated to. |
| instances | List<Long> | No | This is the list of instance Ids that will be assigned to the environment that is being updated. |
| isActive | Boolean | No | This is the isActive boolean that the environment's isActive boolean will be updated to. |
| environmentCode | String | No | This is the code that the environment's code will be update to. |
| sortNumber | Integer | No | This is the sort number that the environment's sort number will be updated to. |
| environmentId | Long | No | This is the Id place holder. It will not change the environment's Id that is being updated. |
| isBuildEnvironment | Boolean | No | This is the isActive boolean that the environment's isActive boolean will be updated to. |
| environmentName | String | No | This is the name that the environment's name will be updated to. |
Response Codes
HTTP Code | Description |
|---|---|
| 200 | Environment was found and patched |
| 400 | Bad request |
| 401 | Unauthorized |
| 404 | Environment not found |
| 500 | Unexpected internal server error |
Example
If we had an environment in our database with an Id of 11101 and had the following attributes
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"description": "This is Environment 1",
"instances": [15101],
"isActive": true,
"environmentCode": "ENV1",
"sortNumber": 1,
"environmentId": 11101,
"isBuildEnvironment": false,
"environmentName": "Env 1"
} |
When we run a PATCH request at the following URL
http://host:port/flexdeploy/rest/topology/environment/11101
And the PATCH request receives the following JSON environment object,
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"description": "This is Patch with some null attributes",
"instances": [15102,15103],
"isActive": null,
"environmentCode": null,
"sortNumber": 7,
"environmentId": null,
"isBuildEnvironment": false,
"environmentName": "Patch with some null"
} |
The PATCH request would then update the environment with Id 11101 and return the following JSON environment object
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"description": "This is Patch with some null attributes",
"instances": [15102,15103],
"isActive": true,
"environmentCode": "ENV1",
"sortNumber": 7,
"environmentId": 11101,
"isBuildEnvironment": false,
"environmentName": "Patch with some null"
} |
...