Class Runbook
- java.lang.Object
-
- software.amazon.awssdk.services.ssm.model.Runbook
-
- All Implemented Interfaces:
Serializable,SdkPojo,ToCopyableBuilder<Runbook.Builder,Runbook>
@Generated("software.amazon.awssdk:codegen") public final class Runbook extends Object implements SdkPojo, Serializable, ToCopyableBuilder<Runbook.Builder,Runbook>
Information about an Automation runbook used in 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.
- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceRunbook.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static Runbook.Builderbuilder()StringdocumentName()The name of the Automation runbook used in a runbook workflow.StringdocumentVersion()The version of the Automation runbook used in a runbook workflow.booleanequals(Object obj)booleanequalsBySdkFields(Object obj)<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)inthashCode()booleanhasParameters()For responses, this returns true if the service returned a value for the Parameters property.booleanhasTargetLocations()For responses, this returns true if the service returned a value for the TargetLocations property.booleanhasTargetMaps()For responses, this returns true if the service returned a value for the TargetMaps property.booleanhasTargets()For responses, this returns true if the service returned a value for the Targets property.StringmaxConcurrency()TheMaxConcurrencyvalue specified by the user when the operation started, indicating the maximum number of resources that the runbook operation can run on at the same time.StringmaxErrors()TheMaxErrorsvalue specified by the user when the execution started, indicating the maximum number of errors that can occur during the operation before the updates are stopped or rolled back.Map<String,List<String>>parameters()The key-value map of execution parameters, which were supplied when callingStartChangeRequestExecution.Map<String,SdkField<?>>sdkFieldNameToField()List<SdkField<?>>sdkFields()static Class<? extends Runbook.Builder>serializableBuilderClass()List<TargetLocation>targetLocations()Information about the Amazon Web Services Regions and Amazon Web Services accounts targeted by the current Runbook operation.List<Map<String,List<String>>>targetMaps()A key-value mapping of runbook parameters to target resources.StringtargetParameterName()The name of the parameter used as the target resource for the rate-controlled runbook workflow.List<Target>targets()A key-value mapping to target resources that the runbook operation performs tasks on.Runbook.BuildertoBuilder()StringtoString()Returns a string representation of this object.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
documentName
public final String documentName()
The name of the Automation runbook used in a runbook workflow.
- Returns:
- The name of the Automation runbook used in a runbook workflow.
-
documentVersion
public final String documentVersion()
The version of the Automation runbook used in a runbook workflow.
- Returns:
- The version of the Automation runbook used in a runbook workflow.
-
hasParameters
public final boolean hasParameters()
For responses, this returns true if the service returned a value for the Parameters property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()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.
-
parameters
public final Map<String,List<String>> parameters()
The key-value map of execution parameters, which were supplied when calling
StartChangeRequestExecution.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
hasParameters()method.- Returns:
- The key-value map of execution parameters, which were supplied when calling
StartChangeRequestExecution.
-
targetParameterName
public final String targetParameterName()
The name of the parameter used as the target resource for the rate-controlled runbook workflow. Required if you specify
Targets.- Returns:
- The name of the parameter used as the target resource for the rate-controlled runbook workflow. Required
if you specify
Targets.
-
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 theisEmpty()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()
A key-value mapping to target resources that the runbook operation performs tasks on. Required if you specify
TargetParameterName.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:
- A key-value mapping to target resources that the runbook operation performs tasks on. Required if you
specify
TargetParameterName.
-
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 theisEmpty()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()
A key-value mapping of runbook parameters to target resources. Both Targets and TargetMaps can't be specified together.
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:
- A key-value mapping of runbook parameters to target resources. Both Targets and TargetMaps can't be specified together.
-
maxConcurrency
public final String maxConcurrency()
The
MaxConcurrencyvalue specified by the user when the operation started, indicating the maximum number of resources that the runbook operation can run on at the same time.- Returns:
- The
MaxConcurrencyvalue specified by the user when the operation started, indicating the maximum number of resources that the runbook operation can run on at the same time.
-
maxErrors
public final String maxErrors()
The
MaxErrorsvalue specified by the user when the execution started, indicating the maximum number of errors that can occur during the operation before the updates are stopped or rolled back.- Returns:
- The
MaxErrorsvalue specified by the user when the execution started, indicating the maximum number of errors that can occur during the operation before the updates are stopped or rolled back.
-
hasTargetLocations
public final boolean hasTargetLocations()
For responses, this returns true if the service returned a value for the TargetLocations property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()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.
-
targetLocations
public final List<TargetLocation> targetLocations()
Information about the Amazon Web Services Regions and Amazon Web Services accounts targeted by the current Runbook operation.
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
hasTargetLocations()method.- Returns:
- Information about the Amazon Web Services Regions and Amazon Web Services accounts targeted by the current Runbook operation.
-
toBuilder
public Runbook.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<Runbook.Builder,Runbook>
-
builder
public static Runbook.Builder builder()
-
serializableBuilderClass
public static Class<? extends Runbook.Builder> serializableBuilderClass()
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFieldsin interfaceSdkPojo
-
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.
-
sdkFieldNameToField
public final Map<String,SdkField<?>> sdkFieldNameToField()
- Specified by:
sdkFieldNameToFieldin interfaceSdkPojo
-
-