Project Properties can be accessed and modified through this API using three services: GET,PUT, and PATCH. These three services allow for the retrieval, complete update, and partial update of Project Properties.
...
Request
Parameter | Type | Required | Description |
|---|---|---|---|
projectid | URL | Yes | This is a URL parameter for the Project Id which is searched to find and return the Properties associated with it. |
| Include Page | ||||
|---|---|---|---|---|
|
Response Codes
HTTP Code | Description |
|---|---|
| 200 | Project was found and it's properties returned |
| 400 | Bad request |
| 401Unauthorized | Authentication failure |
| 403 | Authorization failure (no access to resource) |
| 404 | Project was not found with the specified project id |
| 500 | Unexpected internal server error |
Example
...
This PUT service will update the propertyValue of each property in the project associated with the Project id specified in the URL.
| Info | ||
|---|---|---|
| ||
http://host:port/flexdeploy/rest/v1/project/{projectid}/property |
Request
| Attributes | Type | Required | Description |
|---|---|---|---|
| projectid | URL | Yes | This is the Id of the Project which will have it's Properties updated. |
| propertyName | String | No | This is the name of the type of the single property associated with it. (Can be many) |
| propertyValue | String | No | This is the value that will be updated to for the property with the associated propertyName. (Can be many) |
Note: unlisted properties will default to null.
Response Codes
HTTP Code | Description |
|---|---|
| 200 | Project was found and it's Properties were updated |
| 400 | Bad request |
| 401Unauthorized | Authentication failure |
| 403 | Authorization failure (no access to resource) |
| 404 | Project not found |
| 500 | Unexpected internal server error |
Example
...
| Code Block | ||||
|---|---|---|---|---|
| ||||
[
{
"propertyName": "Approved Check Script",
"propertyValue": "Put1"
},
{
"propertyName": "ServiceNow Password",
"propertyValue": "*****"
},
{
"propertyName": "ServiceNow Port",
"propertyValue": "Put3"
},
{
"propertyName": "ServiceNow URL",
"propertyValue": "Put4"
},
{
"propertyName": "ServiceNow User Name",
"propertyValue": "Put5"
}
] |
PATCH
This PATCH service will update an existing Project's Properties with the information passed through a JSON object. If a property is not listed it will not be updated in the Project.
| Info | ||
|---|---|---|
| ||
http://host:port/flexdeploy/rest/v1/project/{projectid}/property |
Request
| Attributes | Type | Required | Description |
|---|---|---|---|
| projectId | URL | Yes | This is the Id of the Project which will have it's Properties updated. |
| propertyName | String | No | This is the name of the type of the single property associated with it. (Can be many) |
| propertyValue | String | No | This is the value that will be updated to for the property with the associated propertyName. (Can be many) |
| Include Page | ||||
|---|---|---|---|---|
|
Response Codes
HTTP Code | Description |
|---|---|
| 200 | Project was found and it's Properties were updated |
| 400 | Bad request |
| 401Unauthorized | Authentication failure |
| 403 | Authorization failure (no access to resource) |
| 404 | Project not found |
| 500 | Unexpected internal server error |
Example
If we had a Project in our database with an Id of 12723 and had the following attributes
| Code Block | ||||
|---|---|---|---|---|
| ||||
[
{
"propertyName": "Approved Check Script",
"propertyValue": "MyCheckScript"
},
{
"propertyName": "ServiceNow Password",
"propertyValue": "MyPassword"
},
{
"propertyName": "ServiceNow Port",
"propertyValue": "MyPort"
},
{
"propertyName": "ServiceNow URL",
"propertyValue": "MyURL"
},
{
"propertyName": "ServiceNow User Name",
"propertyValue": "MyUserName"
}
] |
When we run a PATCH request at the following URL
http://host:port/flexdeploy/rest/project/12723
And the PATCH request receives the following JSON Project Properties object,
| Code Block | ||||
|---|---|---|---|---|
| ||||
[
{
"propertyName": "ServiceNow URL",
"propertyValue": "PatchedURL"
},
{
"propertyName": "ServiceNow User Name",
"propertyValue": "PatchedUserName"
}
] |
The PATCH request would then update the specified Project's Properties and return the following JSON object
| Code Block | ||||
|---|---|---|---|---|
| ||||
[
{
"propertyName": "Approved Check Script",
"propertyValue": "MyCheckScript"
},
{
"propertyName": "ServiceNow Password",
"propertyValue": "MyPassword"
},
{
"propertyName": "ServiceNow Port",
"propertyValue": "MyPort"
},
{
"propertyName": "ServiceNow URL",
"propertyValue": "PatchedURL"
},
{
"propertyName": "ServiceNow User Name",
"propertyValue": "PatchedUserName"
}
] |