Class CreateTaskRequest
- java.lang.Object
-
- software.amazon.awssdk.core.SdkRequest
-
- software.amazon.awssdk.awscore.AwsRequest
-
- software.amazon.awssdk.services.datasync.model.DataSyncRequest
-
- software.amazon.awssdk.services.datasync.model.CreateTaskRequest
-
- All Implemented Interfaces:
SdkPojo,ToCopyableBuilder<CreateTaskRequest.Builder,CreateTaskRequest>
@Generated("software.amazon.awssdk:codegen") public final class CreateTaskRequest extends DataSyncRequest implements ToCopyableBuilder<CreateTaskRequest.Builder,CreateTaskRequest>
CreateTaskRequest
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceCreateTaskRequest.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static CreateTaskRequest.Builderbuilder()StringcloudWatchLogGroupArn()The Amazon Resource Name (ARN) of the Amazon CloudWatch log group that is used to monitor and log events in the task.StringdestinationLocationArn()The Amazon Resource Name (ARN) of an Amazon Web Services storage resource's location.booleanequals(Object obj)booleanequalsBySdkFields(Object obj)List<FilterRule>excludes()Specifies a list of filter rules that exclude specific data during your transfer.<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)booleanhasExcludes()For responses, this returns true if the service returned a value for the Excludes property.inthashCode()booleanhasIncludes()For responses, this returns true if the service returned a value for the Includes property.booleanhasTags()For responses, this returns true if the service returned a value for the Tags property.List<FilterRule>includes()Specifies a list of filter rules that include specific data during your transfer.ManifestConfigmanifestConfig()Configures a manifest, which is a list of files or objects that you want DataSync to transfer.Stringname()The name of a task.Optionsoptions()Specifies the configuration options for a task.TaskScheduleschedule()Specifies a schedule used to periodically transfer files from a source to a destination location.List<SdkField<?>>sdkFields()static Class<? extends CreateTaskRequest.Builder>serializableBuilderClass()StringsourceLocationArn()The Amazon Resource Name (ARN) of the source location for the task.List<TagListEntry>tags()Specifies the tags that you want to apply to the Amazon Resource Name (ARN) representing the task.TaskReportConfigtaskReportConfig()Specifies how you want to configure a task report, which provides detailed information about your DataSync transfer.CreateTaskRequest.BuildertoBuilder()StringtoString()Returns a string representation of this object.-
Methods inherited from class software.amazon.awssdk.awscore.AwsRequest
overrideConfiguration
-
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
-
sourceLocationArn
public final String sourceLocationArn()
The Amazon Resource Name (ARN) of the source location for the task.
- Returns:
- The Amazon Resource Name (ARN) of the source location for the task.
-
destinationLocationArn
public final String destinationLocationArn()
The Amazon Resource Name (ARN) of an Amazon Web Services storage resource's location.
- Returns:
- The Amazon Resource Name (ARN) of an Amazon Web Services storage resource's location.
-
cloudWatchLogGroupArn
public final String cloudWatchLogGroupArn()
The Amazon Resource Name (ARN) of the Amazon CloudWatch log group that is used to monitor and log events in the task.
- Returns:
- The Amazon Resource Name (ARN) of the Amazon CloudWatch log group that is used to monitor and log events in the task.
-
name
public final String name()
The name of a task. This value is a text reference that is used to identify the task in the console.
- Returns:
- The name of a task. This value is a text reference that is used to identify the task in the console.
-
options
public final Options options()
Specifies the configuration options for a task. Some options include preserving file or object metadata and verifying data integrity.
You can also override these options before starting an individual run of a task (also known as a task execution). For more information, see StartTaskExecution.
- Returns:
- Specifies the configuration options for a task. Some options include preserving file or object metadata
and verifying data integrity.
You can also override these options before starting an individual run of a task (also known as a task execution). For more information, see StartTaskExecution.
-
hasExcludes
public final boolean hasExcludes()
For responses, this returns true if the service returned a value for the Excludes 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.
-
excludes
public final List<FilterRule> excludes()
Specifies a list of filter rules that exclude specific data during your transfer. For more information and examples, see Filtering data transferred by DataSync.
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
hasExcludes()method.- Returns:
- Specifies a list of filter rules that exclude specific data during your transfer. For more information and examples, see Filtering data transferred by DataSync.
-
schedule
public final TaskSchedule schedule()
Specifies a schedule used to periodically transfer files from a source to a destination location. The schedule should be specified in UTC time. For more information, see Scheduling your task.
- Returns:
- Specifies a schedule used to periodically transfer files from a source to a destination location. The schedule should be specified in UTC time. For more information, see Scheduling your task.
-
hasTags
public final boolean hasTags()
For responses, this returns true if the service returned a value for the Tags 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.
-
tags
public final List<TagListEntry> tags()
Specifies the tags that you want to apply to the Amazon Resource Name (ARN) representing the task.
Tags are key-value pairs that help you manage, filter, and search for your DataSync 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
hasTags()method.- Returns:
- Specifies the tags that you want to apply to the Amazon Resource Name (ARN) representing the task.
Tags are key-value pairs that help you manage, filter, and search for your DataSync resources.
-
hasIncludes
public final boolean hasIncludes()
For responses, this returns true if the service returned a value for the Includes 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.
-
includes
public final List<FilterRule> includes()
Specifies a list of filter rules that include specific data during your transfer. For more information and examples, see Filtering data transferred by DataSync.
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
hasIncludes()method.- Returns:
- Specifies a list of filter rules that include specific data during your transfer. For more information and examples, see Filtering data transferred by DataSync.
-
manifestConfig
public final ManifestConfig manifestConfig()
Configures a manifest, which is a list of files or objects that you want DataSync to transfer. For more information and configuration examples, see Specifying what DataSync transfers by using a manifest.
When using this parameter, your caller identity (the role that you're using DataSync with) must have the
iam:PassRolepermission. The AWSDataSyncFullAccess policy includes this permission.- Returns:
- Configures a manifest, which is a list of files or objects that you want DataSync to transfer. For more
information and configuration examples, see Specifying
what DataSync transfers by using a manifest.
When using this parameter, your caller identity (the role that you're using DataSync with) must have the
iam:PassRolepermission. The AWSDataSyncFullAccess policy includes this permission.
-
taskReportConfig
public final TaskReportConfig taskReportConfig()
Specifies how you want to configure a task report, which provides detailed information about your DataSync transfer. For more information, see Monitoring your DataSync transfers with task reports.
When using this parameter, your caller identity (the role that you're using DataSync with) must have the
iam:PassRolepermission. The AWSDataSyncFullAccess policy includes this permission.- Returns:
- Specifies how you want to configure a task report, which provides detailed information about your
DataSync transfer. For more information, see Monitoring your DataSync
transfers with task reports.
When using this parameter, your caller identity (the role that you're using DataSync with) must have the
iam:PassRolepermission. The AWSDataSyncFullAccess policy includes this permission.
-
toBuilder
public CreateTaskRequest.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<CreateTaskRequest.Builder,CreateTaskRequest>- Specified by:
toBuilderin classDataSyncRequest
-
builder
public static CreateTaskRequest.Builder builder()
-
serializableBuilderClass
public static Class<? extends CreateTaskRequest.Builder> serializableBuilderClass()
-
hashCode
public final int hashCode()
- Overrides:
hashCodein classAwsRequest
-
equals
public final boolean equals(Object obj)
- Overrides:
equalsin classAwsRequest
-
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.
-
getValueForField
public final <T> Optional<T> getValueForField(String fieldName, Class<T> clazz)
- Overrides:
getValueForFieldin classSdkRequest
-
-