CoreService

<back to all web services

SearchFacts

ResourceAddons - CRUD

Returns a list of facts

Requires Authentication
Required role:TenantReader
The following routes are available for this service:
GET/api/resourceaddons/facts/searchReturns a list of facts
GET/resourceaddons/facts/searchReturns a list of facts
SearchFacts Parameters:
NameParameterData TypeRequiredDescription
IdentityquerystringNoSearches for name or displayname containing the value
NamequerystringNo
DisplayNamequerystringNo
TenantNameheaderstringYes
IncludeReferencedObjectsquerybool?NoReturns all referenced object
GroupByquerystringNoThe property, the data will be grouped on
AggregateOnquerystringNoThe property, used for aggregation
AggregationqueryAggregations?NoThe aggregation function to use

Allowable Values

  • None
  • Count
  • DistinctCount
  • Sum
  • Min
  • Max
  • Avg
  • First
QueryBase Parameters:
NameParameterData TypeRequiredDescription
Skipformint?No
Takeformint?No
OrderByformstringNo
OrderByDescformstringNo
IncludeformstringNo
FieldsformstringNo
MetaformDictionary<string, string>No
Fact Parameters:
NameParameterData TypeRequiredDescription
IdformGuidNo
TenantIdformGuidYes
ResourceIdformGuidYes
NameformstringYes
DisplayNameformstringYes
ValueformstringNo
SelfLinkformstringYes
LastSeenformDateTimeYes
Aggregations Enum:
None
Count
DistinctCount
Sum
Min
Max
Avg
First
QueryResponse<T> Parameters:
NameParameterData TypeRequiredDescription
OffsetformintNo
TotalformintNo
ResultsformList<TimeSeriesDefinition>Yes
MetaformDictionary<string, string>No
ResponseStatusformResponseStatusNo
TimeSeriesDefinition Parameters:
NameParameterData TypeRequiredDescription
IdformGuidNo
TenantIdformGuidNo
TenantformTenantNo
NameformstringYes
DisplayNameformstringNo
SelfLinkformstringYes
ObjectTypeformObjectTypesYes
DescriptionformstringNo
SourceTypeformObjectTypesNo
AutoCollectionformboolNo
AutoCollectionQueryformstringNo
AutoCollectionIntervalformint?No
AutoCollectionIntervalUnitformIntervalUnits?No
AutoCollectionTimeformTimeOnly?No
LastAutoCollectedformDateTime?No
RetentionTimeMonthsformintNo
Auditable Parameters:
NameParameterData TypeRequiredDescription
CreatedformDateTimeYes
CreateUserformstringYes
CreateUserIdformstringYes
ModifiedformDateTimeYes
ModifyUserformstringYes
ModifyUserIdformstringYes
IsDeletedformboolYes
DeletedformDateTime?No
DeleteUserformstringNo
DeleteUserIdformstringNo
Tenant Parameters:
NameParameterData TypeRequiredDescription
NameformstringYes
ObjectTypeformObjectTypesYes
SelfLinkformstringYes
VariablesformIList<Variable>Yes
AllowedMailDomainsformIList<string>Yes
LicensedModulesformIList<string>Yes
DefaultDeploymentLifetimeDaysformshortYes
MaxDeploymentLifetimeDaysformshortYes
SystemUnpatchedWarningDaysformshortYes
SystemBackupMissingWarningHoursformshortYes
StopVulnerableResourceAfterDaysformshortYes
DeploymentExpirationWarningDaysformshortYes
PatchNotificationDaysformshortYes
UseCustomHostnamesformboolYes
RemoveInactiveVulnerabilitiesAfterDaysformshortYes
ConfigItem Parameters:
NameParameterData TypeRequiredDescription
IdformGuidNo
NameformstringYes
DisplayNameformstringYes
DescriptionformstringNo
ObjectTypeformObjectTypesNo
SelfLinkformstringYes
TagsformIList<Tag>Yes
PathformIList<PathItem>Yes
ObjectTypes Enum:
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
Tag Parameters:
NameParameterData TypeRequiredDescription
NameformstringYes
ValueformstringNo
IsProtectedformboolNo
PathItem Parameters:
NameParameterData TypeRequiredDescription
LabelformstringYes
LinkformstringYes
ObjectTypeformObjectTypesNo
ObjectIdformGuidNo
Variable Parameters:
NameParameterData TypeRequiredDescription
NameformstringYes
ValueformstringYes
TypeformValueDataTypeNo
DescriptionformstringNo
IsInheritedformboolNo
EnvironmentformEnvironments?No
ValueDataType Enum:
String
Number
Boolean
List
Environments Enum:
Lab
Poc
Dev
Test
Int
Uat
Prod
IntervalUnits Enum:
Second
Minute
Hour
Day
Week
Month
Year

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

HTTP + JSON

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

GET /api/resourceaddons/facts/search HTTP/1.1 
Host: core.starburst.svc 
Accept: application/json
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"offset":0,"total":0,"results":[{"id":"00000000-0000-0000-0000-000000000000","tenantId":"00000000-0000-0000-0000-000000000000","resourceId":"00000000-0000-0000-0000-000000000000","name":"String","displayName":"String","value":"String","selfLink":"/resourceaddons/facts/00000000-0000-0000-0000-000000000000","lastSeen":"0001-01-01T00:00:00.0000000Z"}],"meta":{"String":"String"},"responseStatus":{"errorCode":"String","message":"String","stackTrace":"String","errors":[{"errorCode":"String","fieldName":"String","message":"String","meta":{"String":"String"}}],"meta":{"String":"String"}}}