See all operations
PUT: projects/{project_id}/automation-hosts
Description
Updates an automation host in the system
How to Execute
To access this REST web service, you need to use the following URL:
https://api.inflectra.com/Spira/Services/v4_0/RestService.svc/projects/{project_id}/automation-hosts
Request Parameters
Name
|
Description
|
project_id
|
The id of the current project
|
Request Body
Property
|
Description
|
AutomationHostId
|
The id of the host
|
Name
|
The name of the host
|
Token
|
The token of the host
Ths is the name that external systems should refer to it as
|
Description
|
The detailed description of the host
Optional
|
LastUpdateDate
|
The date/time that the host was last modified
This field needs to match the values retrieved to ensure data-concurrency
|
Active
|
Is this host active for the project
|
LastContactDate
|
The last date/time that this host was contacted
|
ProjectId
|
The id of the project that the artifact belongs to
The current project is always used for Insert operations for security reasons
|
ArtifactTypeId
|
The type of artifact that we have (read-only)
|
ConcurrencyDate
|
The datetime used to track optimistic concurrency to prevent edit conflicts
|
CustomProperties
|
The list of associated custom properties/fields for this artifact
|
<RemoteAutomationHost xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Inflectra.SpiraTest.Web.Services.v4_0.DataObjects">
<ArtifactTypeId>0</ArtifactTypeId>
<ConcurrencyDate>0001-01-01T00:00:00</ConcurrencyDate>
<CustomProperties i:nil="true" />
<ProjectId i:nil="true" />
<Active>false</Active>
<AutomationHostId i:nil="true" />
<Description i:nil="true" />
<LastContactDate i:nil="true" />
<LastUpdateDate>0001-01-01T00:00:00</LastUpdateDate>
<Name i:nil="true" />
<Token i:nil="true" />
</RemoteAutomationHost>
{"ArtifactTypeId":0,
"ConcurrencyDate":"\/Date(-62135578800000-0500)\/",
"CustomProperties":null,
"ProjectId":null,
"Active":false,
"AutomationHostId":null,
"Description":null,
"LastContactDate":null,
"LastUpdateDate":"\/Date(-62135578800000-0500)\/",
"Name":null,
"Token":null}
Return Data
The JSON and XML examples below show the shape of one entry that will be returned. It does not show an example of how that entry will be populated.