| Required role: | TenantReader | Requires the role: | Workflow |
| GET | /api/resourceaddons/hostnames | Returns a list of hostnames for one time use (the pool will never return already obtained hostnames) | |
|---|---|---|---|
| GET | /resourceaddons/hostnames | Returns a list of hostnames for one time use (the pool will never return already obtained hostnames) |
Imports System
Imports System.IO
Imports System.Collections
Imports System.Collections.Generic
Imports System.Runtime.Serialization
Imports ServiceStack
Imports ServiceStack.DataAnnotations
Imports CoreService.ServiceModel.Dtos.HostNames.Crud
Imports YCO.Dune.Models.Dtos.Common.Responses
Imports CoreService.ServiceModel.Dtos.Base.Responses
Imports CoreService.ServiceModel.Enums
Namespace Global
Namespace CoreService.ServiceModel.Dtos.Base.Responses
Public Partial Class VariableDto
Public Overridable Property Name As String
'''<Summary>
'''Value in form of a json string (e.g. Number = 1234, String = "foo", Boolean = false, List = [1,2,3,4]). Note: string values need extra quotes
'''</Summary>
Public Overridable Property Value As String
'''<Summary>
'''The data type of the value property
'''</Summary>
Public Overridable Property Type As ValueDataType
Public Overridable Property Description As String
Public Overridable Property IsInherited As Boolean
Public Overridable Property Environment As Environments?
End Class
End Namespace
Namespace CoreService.ServiceModel.Dtos.HostNames.Crud
'''<Summary>
'''Returns a list of hostnames
'''</Summary>
<Api(Description:="Returns a list of hostnames")>
<ApiResponse(Description:="Success", IsDefaultResponse:=true, ResponseType:=GetType(0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]), StatusCode:=200)>
Public Partial Class GetHostNames
Implements IBaseRequest
Implements IHasTenantName
Implements IGet
<ApiMember(DataType:="string", IsRequired:=true, ParameterType:="header")>
<Validate(Validator:="NotEmpty")>
Public Overridable Property TenantName As String Implements IHasTenantName.TenantName
'''<Summary>
'''If set, hostnames will be created using it
'''</Summary>
<ApiMember(DataType:="string", Description:="If set, hostnames will be created using it", ParameterType:="query")>
<Validate(Validator:="MaximumLength(2)")>
Public Overridable Property Prefix As String
'''<Summary>
'''Defines how long the hostname will be including the prefix
'''</Summary>
<ApiMember(DataType:="int", Description:="Defines how long the hostname will be including the prefix", ParameterType:="query")>
<Validate(Validator:="ExclusiveBetween(7,17)")>
Public Overridable Property Length As Integer?
'''<Summary>
'''The number of hostnames to be returned
'''</Summary>
<ApiMember(DataType:="int", Description:="The number of hostnames to be returned", IsRequired:=true)>
<Validate(Validator:="GreaterThanOrEqual(1)")>
Public Overridable Property Count As Integer
End Class
End Namespace
Namespace CoreService.ServiceModel.Enums
Public Enum Environments
Lab
Poc
Dev
Test
Int
Uat
Prod
End Enum
Public Enum ValueDataType
[String]
Number
[Boolean]
List
End Enum
End Namespace
Namespace YCO.Dune.Models.Dtos.Common.Responses
Public Partial Class ItemsResponse(Of T)
Public Overridable Property Items As IList(Of VariableDto)
Public Overridable Property Offset As Integer
Public Overridable Property Total As Integer
Public Overridable Property IsGrouped As Boolean
Public Overridable Property ResponseStatus As ResponseStatus
Public Overridable Property Meta As Dictionary(Of String, String)
End Class
End Namespace
End Namespace
To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json
To embed the response in a jsonp callback, append ?callback=myCallback
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
GET /api/resourceaddons/hostnames HTTP/1.1 Host: core.starburst.svc Accept: application/json
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length
{"items":null,"offset":0,"total":0,"isGrouped":false,"responseStatus":{"errorCode":"String","message":"String","stackTrace":"String","errors":[{"errorCode":"String","fieldName":"String","message":"String","meta":{"String":"String"}}],"meta":{"String":"String"}},"meta":{"String":"String"}}