| Anchor | ||||
|---|---|---|---|---|
|
...
| Info | ||
|---|---|---|
| ||
http://host:port/flexdeploy/rest/v1/project/{projectid}/property |
| Table of Contents | ||
|---|---|---|
|
...
| Info | ||
|---|---|---|
| ||
http://host:port/flexdeploy/rest/v1/project/{projectid}/property |
Parameters
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. |
Response Codes
HTTP Code | Description |
|---|---|
| 200 | Project was found and it's properties returned |
| 400 | Bad request |
| 401 | Unauthorized |
| 404 | Project was not found with the specified project id |
| 500 | Unexpected internal server error |
...
| Info | ||
|---|---|---|
| ||
http://host:port/flexdeploy/rest/v1/project/{projectid}/property |
| Code Block | ||||
|---|---|---|---|---|
| ||||
[
{
"propertyName": "Approved Check Script",
"propertyValue": "Put1"
},
{
"propertyName": "ServiceNow Password",
"propertyValue": "Put2"
},
{
"propertyName": "ServiceNow Port",
"propertyValue": "Put3"
},
{
"propertyName": "ServiceNow URL",
"propertyValue": "Put4"
},
{
"propertyName": "ServiceNow User Name",
"propertyValue": "Put5"
}
] |
Parameters
| 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 |
| 401 | Unauthorized |
| 404 | Project not found |
| 500 | Unexpected internal server error |
...
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/{projectIdprojectid}/property |
Parameters
| 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) |
Response Codes
HTTP Code | Description |
|---|---|
| 200 | Project was found and it's Properties were updated |
| 400 | Bad request |
| 401 | Unauthorized |
| 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"
}
] |
...