| Required role: | TenantReader |
| GET | /api/tenants/ | Returns a specific tenant | |
|---|---|---|---|
| GET | /tenants/ | Returns a specific tenant |
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.Tenant.Crud
Imports CoreService.ServiceModel.Dtos.Tenant.Responses
Imports CoreService.ServiceModel.Dtos.Base.Responses
Imports YCO.Dune.Models.Enums
Imports CoreService.ServiceModel.Enums
Namespace Global
Namespace CoreService.ServiceModel.Dtos.Base.Responses
Public Partial Class ConfigItemDto
Implements IConfigItem
Public Overridable Property Id As Guid
Public Overridable Property Name As String
Public Overridable Property DisplayName As String Implements IConfigItem.DisplayName
Public Overridable Property Description As String Implements IConfigItem.Description
Public Overridable Property ObjectType As ObjectTypes
Public Overridable Property SelfLink As String Implements IConfigItem.SelfLink
Public Overridable Property Tags As IList(Of TagDto) Implements IConfigItem.Tags
Public Overridable Property Path As IList(Of PathItemDto)
Public Overridable Property Created As Date
Public Overridable Property CreateUser As String
Public Overridable Property CreateUserId As String
Public Overridable Property Modified As Date
Public Overridable Property ModifyUser As String
Public Overridable Property ModifyUserId As String
Public Overridable Property IsDeleted As Boolean
Public Overridable Property Deleted As Date?
Public Overridable Property DeleteUser As String
Public Overridable Property DeleteUserId As String
Public Overridable Property Links As IList(Of LinkDto)
End Class
Public Partial Class LinkDto
Public Overridable Property Caption As String
Public Overridable Property Rel As String
Public Overridable Property HRef As String
Public Overridable Property Method As String
End Class
Public Partial Class PathItemDto
Public Overridable Property Label As String
Public Overridable Property Link As String
Public Overridable Property ObjectType As ObjectTypes
Public Overridable Property ObjectId As Guid
End Class
Public Partial Class TagDto
Public Overridable Property Name As String
Public Overridable Property Value As String
Public Overridable Property IsProtected As Boolean
End Class
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.Tenant.Crud
'''<Summary>
'''Returns a single tenant
'''</Summary>
<Api(Description:="Returns a single tenant")>
<ApiResponse(Description:="The tenant", IsDefaultResponse:=true, ResponseType:=GetType(TenantDto), StatusCode:=200)>
Public Partial Class GetTenant
Implements IGetSingleRequest
Implements IHasTenantName
Implements IGet
<ApiMember(DataType:="string", IsRequired:=true, ParameterType:="header")>
<Validate(Validator:="NotEmpty")>
Public Overridable Property TenantName As String Implements IHasTenantName.TenantName
<ApiMember(ParameterType:="query", Verb:="GET")>
Public Overridable Property IncludeReferencedObjects As Boolean? Implements IGetSingleRequest.IncludeReferencedObjects
<ApiMember(ParameterType:="query", Verb:="GET")>
Public Overridable Property IncludeDeleted As Boolean? Implements IGetSingleRequest.IncludeDeleted
End Class
End Namespace
Namespace CoreService.ServiceModel.Dtos.Tenant.Responses
Public Partial Class TenantDto
Inherits ConfigItemDto
'''<Summary>
'''Variables defined on tenant level
'''</Summary>
Public Overridable Property Variables As IList(Of VariableDto)
'''<Summary>
'''Allowed email domains used for authentication
'''</Summary>
Public Overridable Property AllowedMailDomains As IList(Of String)
'''<Summary>
'''List of licensed modules for this tenant
'''</Summary>
Public Overridable Property LicensedModules As IList(Of String)
'''<Summary>
'''Amount of days until a Deployment expires
'''</Summary>
Public Overridable Property DefaultDeploymentLifetimeDays As Short
'''<Summary>
'''Max amount of days until a Deployment expires
'''</Summary>
Public Overridable Property MaxDeploymentLifetimeDays As Short
'''<Summary>
'''Amount of days without patching until a unpatched warning is shown
'''</Summary>
Public Overridable Property SystemUnpatchedWarningDays As Short
'''<Summary>
'''Amount of hours without backup until a backup missing warning is shown
'''</Summary>
Public Overridable Property SystemBackupMissingWarningHours As Short
'''<Summary>
'''Amount of days until a vulnerable resource is getting stopped
'''</Summary>
Public Overridable Property StopVulnerableResourceAfterDays As Short
'''<Summary>
'''Amount of days before deployment expiration, which triggers the expiration warning
'''</Summary>
Public Overridable Property DeploymentExpirationWarningDays As Short
'''<Summary>
'''Amount of days the patch notification is sent out prior to the patch date
'''</Summary>
Public Overridable Property PatchNotificationDays As Short
'''<Summary>
'''Use a pool with your own hostnames (true) or let the hostname be auto generated (false)
'''</Summary>
Public Overridable Property UseCustomHostnames As Boolean
'''<Summary>
'''After how many days inactive vulnerabilities will be purged from database
'''</Summary>
Public Overridable Property RemoveInactiveVulnerabilitiesAfterDays As Short
Public Overridable Property Links As IList(Of LinkDto)
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.Enums
Public Enum ObjectTypes
None
ConfigItem
Tenant
Collection
Resource
ComputeNode
VirtualMachine
PhysicalMachine
Disk
Subnet
IPAddress
Job
JobEvent
FreezePeriod
ResourceGroup
Deployment
ResourceGroupTemplate
DeploymentTemplate
ResourceProvider
GenericResource
Role
Permission
User
PatchingWindow
Update
ReportDefinition
TimeSeries
DataPoint
Action
ActionAssignment
UserNote
End Enum
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/tenants/ HTTP/1.1 Host: core.starburst.svc Accept: application/json
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length
{"variables":null,"allowedMailDomains":null,"licensedModules":null,"defaultDeploymentLifetimeDays":0,"maxDeploymentLifetimeDays":0,"systemUnpatchedWarningDays":0,"systemBackupMissingWarningHours":0,"stopVulnerableResourceAfterDays":0,"deploymentExpirationWarningDays":0,"patchNotificationDays":0,"useCustomHostnames":false,"removeInactiveVulnerabilitiesAfterDays":0,"links":[{"caption":"Collections","rel":"down","hRef":"/collections/","method":"GET"}],"id":"00000000-0000-0000-0000-000000000000","name":"String","displayName":"String","description":"String","objectType":"None","selfLink":"String","tags":null,"path":null,"created":"0001-01-01T00:00:00.0000000Z","createUser":"String","createUserId":"String","modified":"0001-01-01T00:00:00.0000000Z","modifyUser":"String","modifyUserId":"String","isDeleted":false,"deleted":"0001-01-01T00:00:00.0000000Z","deleteUser":"String","deleteUserId":"String"}