Component - script API

StackState Self-hosted v5.1.x

Function: Component.withId(id: Long)

Get access to a component by its ID.

Args

  • id - ID of the component we are querying for. Each component has a unique randomly assigned ID number.

Builder methods

Each of the methods below give you an Async result with a set of properties

  • at(time: Instant or Timeslice) - specifes a time for which the query should be executed.

  • get - gets components details in full, with the following fields:

    id
    name
    description
    lastUpdateTimestamp
    type
    layer
    domain
    environments
    state
    runState
    outgoingRelations
    incomingRelations
    synchronized
    failingChecks
    iconbase64
    visible
  • checks - Gets a list of component checks each with the following fields:

    id
    lastUpdateTimestamp`
    name
    description
    remediationHint
    function
    arguments
    state
    syncCreated
  • domain - Gets the domain the component belongs to with the following fields:

    id
    lastUpdateTimestamp
    name
    description
    order
    identifier
  • streams - Gets a list of component streams each with the following fields:

    id
    lastUpdateTimestamp
    name
    description
    priority
    dataType
    dataSource
    query
  • type - Gets the component type of the given component with the following fields:

    id
    lastUpdateTimestamp
    name
    description
    iconbase64
    identifier
  • layer - Gets the layer for the component with the following fields:

    id
    lastUpdateTimestamp
    name
    description
    order
    identifier
  • environments - Gets a list of environments this component belongs to with following fields:

    id
    lastUpdateTimestamp
    name
    description
    identifier
    ownedBy
  • propagation - Get the propagation for the component if any with the following fields:

    id
    lastUpdateTimestamp
    function
    arguments

Examples

This example returns the name of the layer for the component with ID 123. After getting the layer the AsyncScriptResult then function is used to get the name of the layer.

Component.withId(123).layer().then { it.name }

Last updated