Class AutomationExecutionMetadata

    • Method Detail

      • automationExecutionId

        public final String automationExecutionId()

        The execution ID.

        Returns:
        The execution ID.
      • documentName

        public final String documentName()

        The name of the Automation runbook used during execution.

        Returns:
        The name of the Automation runbook used during execution.
      • documentVersion

        public final String documentVersion()

        The document version used during the execution.

        Returns:
        The document version used during the execution.
      • executionStartTime

        public final Instant executionStartTime()

        The time the execution started.

        Returns:
        The time the execution started.
      • executionEndTime

        public final Instant executionEndTime()

        The time the execution finished. This isn't populated if the execution is still in progress.

        Returns:
        The time the execution finished. This isn't populated if the execution is still in progress.
      • executedBy

        public final String executedBy()

        The IAM role ARN of the user who ran the automation.

        Returns:
        The IAM role ARN of the user who ran the automation.
      • logFile

        public final String logFile()

        An S3 bucket where execution information is stored.

        Returns:
        An S3 bucket where execution information is stored.
      • hasOutputs

        public final boolean hasOutputs()
        For responses, this returns true if the service returned a value for the Outputs property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
      • outputs

        public final Map<String,​List<String>> outputs()

        The list of execution outputs as defined in the Automation runbook.

        Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

        This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasOutputs() method.

        Returns:
        The list of execution outputs as defined in the Automation runbook.
      • modeAsString

        public final String modeAsString()

        The Automation execution mode.

        If the service returns an enum value that is not available in the current SDK version, mode will return ExecutionMode.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from modeAsString().

        Returns:
        The Automation execution mode.
        See Also:
        ExecutionMode
      • parentAutomationExecutionId

        public final String parentAutomationExecutionId()

        The execution ID of the parent automation.

        Returns:
        The execution ID of the parent automation.
      • currentStepName

        public final String currentStepName()

        The name of the step that is currently running.

        Returns:
        The name of the step that is currently running.
      • currentAction

        public final String currentAction()

        The action of the step that is currently running.

        Returns:
        The action of the step that is currently running.
      • failureMessage

        public final String failureMessage()

        The list of execution outputs as defined in the Automation runbook.

        Returns:
        The list of execution outputs as defined in the Automation runbook.
      • targetParameterName

        public final String targetParameterName()

        The list of execution outputs as defined in the Automation runbook.

        Returns:
        The list of execution outputs as defined in the Automation runbook.
      • hasTargets

        public final boolean hasTargets()
        For responses, this returns true if the service returned a value for the Targets property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
      • targets

        public final List<Target> targets()

        The targets defined by the user when starting the automation.

        Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

        This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasTargets() method.

        Returns:
        The targets defined by the user when starting the automation.
      • hasTargetMaps

        public final boolean hasTargetMaps()
        For responses, this returns true if the service returned a value for the TargetMaps property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
      • targetMaps

        public final List<Map<String,​List<String>>> targetMaps()

        The specified key-value mapping of document parameters to target resources.

        Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

        This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasTargetMaps() method.

        Returns:
        The specified key-value mapping of document parameters to target resources.
      • resolvedTargets

        public final ResolvedTargets resolvedTargets()

        A list of targets that resolved during the execution.

        Returns:
        A list of targets that resolved during the execution.
      • maxConcurrency

        public final String maxConcurrency()

        The MaxConcurrency value specified by the user when starting the automation.

        Returns:
        The MaxConcurrency value specified by the user when starting the automation.
      • maxErrors

        public final String maxErrors()

        The MaxErrors value specified by the user when starting the automation.

        Returns:
        The MaxErrors value specified by the user when starting the automation.
      • target

        public final String target()

        The list of execution outputs as defined in the Automation runbook.

        Returns:
        The list of execution outputs as defined in the Automation runbook.
      • alarmConfiguration

        public final AlarmConfiguration alarmConfiguration()

        The details for the CloudWatch alarm applied to your automation.

        Returns:
        The details for the CloudWatch alarm applied to your automation.
      • hasTriggeredAlarms

        public final boolean hasTriggeredAlarms()
        For responses, this returns true if the service returned a value for the TriggeredAlarms property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
      • triggeredAlarms

        public final List<AlarmStateInformation> triggeredAlarms()

        The CloudWatch alarm that was invoked by the automation.

        Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

        This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasTriggeredAlarms() method.

        Returns:
        The CloudWatch alarm that was invoked by the automation.
      • targetLocationsURL

        public final String targetLocationsURL()

        A publicly accessible URL for a file that contains the TargetLocations body. Currently, only files in presigned Amazon S3 buckets are supported

        Returns:
        A publicly accessible URL for a file that contains the TargetLocations body. Currently, only files in presigned Amazon S3 buckets are supported
      • automationSubtype

        public final AutomationSubtype automationSubtype()

        The subtype of the Automation operation. Currently, the only supported value is ChangeRequest.

        If the service returns an enum value that is not available in the current SDK version, automationSubtype will return AutomationSubtype.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from automationSubtypeAsString().

        Returns:
        The subtype of the Automation operation. Currently, the only supported value is ChangeRequest.
        See Also:
        AutomationSubtype
      • automationSubtypeAsString

        public final String automationSubtypeAsString()

        The subtype of the Automation operation. Currently, the only supported value is ChangeRequest.

        If the service returns an enum value that is not available in the current SDK version, automationSubtype will return AutomationSubtype.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from automationSubtypeAsString().

        Returns:
        The subtype of the Automation operation. Currently, the only supported value is ChangeRequest.
        See Also:
        AutomationSubtype
      • scheduledTime

        public final Instant scheduledTime()

        The date and time the Automation operation is scheduled to start.

        Returns:
        The date and time the Automation operation is scheduled to start.
      • hasRunbooks

        public final boolean hasRunbooks()
        For responses, this returns true if the service returned a value for the Runbooks property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
      • runbooks

        public final List<Runbook> runbooks()

        Information about the Automation runbooks that are run during a runbook workflow in Change Manager.

        The Automation runbooks specified for the runbook workflow can't run until all required approvals for the change request have been received.

        Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

        This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasRunbooks() method.

        Returns:
        Information about the Automation runbooks that are run during a runbook workflow in Change Manager.

        The Automation runbooks specified for the runbook workflow can't run until all required approvals for the change request have been received.

      • opsItemId

        public final String opsItemId()

        The ID of an OpsItem that is created to represent a Change Manager change request.

        Returns:
        The ID of an OpsItem that is created to represent a Change Manager change request.
      • associationId

        public final String associationId()

        The ID of a State Manager association used in the Automation operation.

        Returns:
        The ID of a State Manager association used in the Automation operation.
      • changeRequestName

        public final String changeRequestName()

        The name of the Change Manager change request.

        Returns:
        The name of the Change Manager change request.
      • hashCode

        public final int hashCode()
        Overrides:
        hashCode in class Object
      • equals

        public final boolean equals​(Object obj)
        Overrides:
        equals in class Object
      • toString

        public final String toString()
        Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
        Overrides:
        toString in class Object
      • getValueForField

        public final <T> Optional<T> getValueForField​(String fieldName,
                                                      Class<T> clazz)