StarterTemplate ASP.NET Host

<back to all web services

RequestHostPostV2

TestHost Service

The following routes are available for this service:
POST/service/automation/v2/hostsAdds a new test hostThe authenticating user must have Read access to Test Hosts. There must be no host with this name.
    RequestHostPost: Test host information.
  • HostName: The computer name.
  • HostConfiguration: Hardware and/or software information.
  • Agents: Test runners on the host.
  • OS: The operating system's name and version.
  • IsActive: True if tests can be run on this host; otherwise, false.
  • DeptId: Your department ID.
  • AgentVersion: Version of the agent on the host.
Parameters:
NameParameterData TypeRequiredDescription
DeptIdqueryintNoThe ID of the department that includes the host

To override the Content-type in your clients HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /xml/reply/RequestHostPostV2 HTTP/1.1 
Host: rest.qacomplete.smartbear.com 
Content-Type: application/xml
Content-Length: length

<RequestHostPostV2 xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SwpStack.AutomationService.DTO.V2.TestHost">
  <AgentVersion xmlns="http://schemas.datacontract.org/2004/07/SwpStack.AutomationService.DTO.Common.TestHost">String</AgentVersion>
  <Agents xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns="http://schemas.datacontract.org/2004/07/SwpStack.AutomationService.DTO.Common.TestHost">
    <d2p1:string>String</d2p1:string>
  </Agents>
  <DeptId xmlns="http://schemas.datacontract.org/2004/07/SwpStack.AutomationService.DTO.Common.TestHost">0</DeptId>
  <HostConfiguration xmlns="http://schemas.datacontract.org/2004/07/SwpStack.AutomationService.DTO.Common.TestHost">String</HostConfiguration>
  <HostName xmlns="http://schemas.datacontract.org/2004/07/SwpStack.AutomationService.DTO.Common.TestHost">String</HostName>
  <IsActive xmlns="http://schemas.datacontract.org/2004/07/SwpStack.AutomationService.DTO.Common.TestHost">false</IsActive>
  <OS xmlns="http://schemas.datacontract.org/2004/07/SwpStack.AutomationService.DTO.Common.TestHost">String</OS>
</RequestHostPostV2>

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<ResponseSingleHost xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SwpStack.AutomationService.DTO.Common.TestHost">
  <AgentVersion>String</AgentVersion>
  <Agents xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>String</d2p1:string>
  </Agents>
  <HostConfiguration>String</HostConfiguration>
  <HostName>String</HostName>
  <Id>0</Id>
  <IsActive>false</IsActive>
  <OS>String</OS>
  <SecurityToken>String</SecurityToken>
</ResponseSingleHost>