@Generated(value="software.amazon.awssdk:codegen") public interface DataSyncClient extends SdkClient
builder()
method.
AWS DataSync is a managed data transfer service that makes it simpler for you to automate moving data between on-premises storage and Amazon Simple Storage Service (Amazon S3) or Amazon Elastic File System (Amazon EFS).
This API interface reference for AWS DataSync contains documentation for a programming interface that you can use to manage AWS DataSync.
Modifier and Type | Field and Description |
---|---|
static String |
SERVICE_NAME |
Modifier and Type | Method and Description |
---|---|
static DataSyncClientBuilder |
builder()
Create a builder that can be used to configure and create a
DataSyncClient . |
default CancelTaskExecutionResponse |
cancelTaskExecution(CancelTaskExecutionRequest cancelTaskExecutionRequest)
Cancels execution of a task.
|
default CancelTaskExecutionResponse |
cancelTaskExecution(Consumer<CancelTaskExecutionRequest.Builder> cancelTaskExecutionRequest)
Cancels execution of a task.
|
static DataSyncClient |
create()
Create a
DataSyncClient with the region loaded from the
DefaultAwsRegionProviderChain and credentials loaded from the
DefaultCredentialsProvider . |
default CreateAgentResponse |
createAgent(Consumer<CreateAgentRequest.Builder> createAgentRequest)
Activates an AWS DataSync agent that you have deployed on your host.
|
default CreateAgentResponse |
createAgent(CreateAgentRequest createAgentRequest)
Activates an AWS DataSync agent that you have deployed on your host.
|
default CreateLocationEfsResponse |
createLocationEfs(Consumer<CreateLocationEfsRequest.Builder> createLocationEfsRequest)
Creates an endpoint for an Amazon EFS file system.
|
default CreateLocationEfsResponse |
createLocationEfs(CreateLocationEfsRequest createLocationEfsRequest)
Creates an endpoint for an Amazon EFS file system.
|
default CreateLocationNfsResponse |
createLocationNfs(Consumer<CreateLocationNfsRequest.Builder> createLocationNfsRequest)
Creates an endpoint for a Network File System (NFS) file system.
|
default CreateLocationNfsResponse |
createLocationNfs(CreateLocationNfsRequest createLocationNfsRequest)
Creates an endpoint for a Network File System (NFS) file system.
|
default CreateLocationS3Response |
createLocationS3(Consumer<CreateLocationS3Request.Builder> createLocationS3Request)
Creates an endpoint for an Amazon S3 bucket.
|
default CreateLocationS3Response |
createLocationS3(CreateLocationS3Request createLocationS3Request)
Creates an endpoint for an Amazon S3 bucket.
|
default CreateTaskResponse |
createTask(Consumer<CreateTaskRequest.Builder> createTaskRequest)
Creates a task.
|
default CreateTaskResponse |
createTask(CreateTaskRequest createTaskRequest)
Creates a task.
|
default DeleteAgentResponse |
deleteAgent(Consumer<DeleteAgentRequest.Builder> deleteAgentRequest)
Deletes an agent.
|
default DeleteAgentResponse |
deleteAgent(DeleteAgentRequest deleteAgentRequest)
Deletes an agent.
|
default DeleteLocationResponse |
deleteLocation(Consumer<DeleteLocationRequest.Builder> deleteLocationRequest)
Deletes the configuration of a location used by AWS DataSync.
|
default DeleteLocationResponse |
deleteLocation(DeleteLocationRequest deleteLocationRequest)
Deletes the configuration of a location used by AWS DataSync.
|
default DeleteTaskResponse |
deleteTask(Consumer<DeleteTaskRequest.Builder> deleteTaskRequest)
Deletes a task.
|
default DeleteTaskResponse |
deleteTask(DeleteTaskRequest deleteTaskRequest)
Deletes a task.
|
default DescribeAgentResponse |
describeAgent(Consumer<DescribeAgentRequest.Builder> describeAgentRequest)
Returns metadata such as the name, the network interfaces, and the status (that is, whether the agent is running
or not) for an agent.
|
default DescribeAgentResponse |
describeAgent(DescribeAgentRequest describeAgentRequest)
Returns metadata such as the name, the network interfaces, and the status (that is, whether the agent is running
or not) for an agent.
|
default DescribeLocationEfsResponse |
describeLocationEfs(Consumer<DescribeLocationEfsRequest.Builder> describeLocationEfsRequest)
Returns metadata, such as the path information about an Amazon EFS location.
|
default DescribeLocationEfsResponse |
describeLocationEfs(DescribeLocationEfsRequest describeLocationEfsRequest)
Returns metadata, such as the path information about an Amazon EFS location.
|
default DescribeLocationNfsResponse |
describeLocationNfs(Consumer<DescribeLocationNfsRequest.Builder> describeLocationNfsRequest)
Returns metadata, such as the path information, about a NFS location.
|
default DescribeLocationNfsResponse |
describeLocationNfs(DescribeLocationNfsRequest describeLocationNfsRequest)
Returns metadata, such as the path information, about a NFS location.
|
default DescribeLocationS3Response |
describeLocationS3(Consumer<DescribeLocationS3Request.Builder> describeLocationS3Request)
Returns metadata, such as bucket name, about an Amazon S3 bucket location.
|
default DescribeLocationS3Response |
describeLocationS3(DescribeLocationS3Request describeLocationS3Request)
Returns metadata, such as bucket name, about an Amazon S3 bucket location.
|
default DescribeTaskResponse |
describeTask(Consumer<DescribeTaskRequest.Builder> describeTaskRequest)
Returns metadata about a task.
|
default DescribeTaskResponse |
describeTask(DescribeTaskRequest describeTaskRequest)
Returns metadata about a task.
|
default DescribeTaskExecutionResponse |
describeTaskExecution(Consumer<DescribeTaskExecutionRequest.Builder> describeTaskExecutionRequest)
Returns detailed metadata about a task that is being executed.
|
default DescribeTaskExecutionResponse |
describeTaskExecution(DescribeTaskExecutionRequest describeTaskExecutionRequest)
Returns detailed metadata about a task that is being executed.
|
default ListAgentsResponse |
listAgents()
Returns a list of agents owned by an AWS account in the AWS Region specified in the request.
|
default ListAgentsResponse |
listAgents(Consumer<ListAgentsRequest.Builder> listAgentsRequest)
Returns a list of agents owned by an AWS account in the AWS Region specified in the request.
|
default ListAgentsResponse |
listAgents(ListAgentsRequest listAgentsRequest)
Returns a list of agents owned by an AWS account in the AWS Region specified in the request.
|
default ListAgentsIterable |
listAgentsPaginator()
Returns a list of agents owned by an AWS account in the AWS Region specified in the request.
|
default ListAgentsIterable |
listAgentsPaginator(Consumer<ListAgentsRequest.Builder> listAgentsRequest)
Returns a list of agents owned by an AWS account in the AWS Region specified in the request.
|
default ListAgentsIterable |
listAgentsPaginator(ListAgentsRequest listAgentsRequest)
Returns a list of agents owned by an AWS account in the AWS Region specified in the request.
|
default ListLocationsResponse |
listLocations()
Returns a lists of source and destination locations.
|
default ListLocationsResponse |
listLocations(Consumer<ListLocationsRequest.Builder> listLocationsRequest)
Returns a lists of source and destination locations.
|
default ListLocationsResponse |
listLocations(ListLocationsRequest listLocationsRequest)
Returns a lists of source and destination locations.
|
default ListLocationsIterable |
listLocationsPaginator()
Returns a lists of source and destination locations.
|
default ListLocationsIterable |
listLocationsPaginator(Consumer<ListLocationsRequest.Builder> listLocationsRequest)
Returns a lists of source and destination locations.
|
default ListLocationsIterable |
listLocationsPaginator(ListLocationsRequest listLocationsRequest)
Returns a lists of source and destination locations.
|
default ListTagsForResourceResponse |
listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest)
Returns all the tags associated with a specified resources.
|
default ListTagsForResourceResponse |
listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
Returns all the tags associated with a specified resources.
|
default ListTagsForResourceIterable |
listTagsForResourcePaginator(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest)
Returns all the tags associated with a specified resources.
|
default ListTagsForResourceIterable |
listTagsForResourcePaginator(ListTagsForResourceRequest listTagsForResourceRequest)
Returns all the tags associated with a specified resources.
|
default ListTaskExecutionsResponse |
listTaskExecutions()
Returns a list of executed tasks.
|
default ListTaskExecutionsResponse |
listTaskExecutions(Consumer<ListTaskExecutionsRequest.Builder> listTaskExecutionsRequest)
Returns a list of executed tasks.
|
default ListTaskExecutionsResponse |
listTaskExecutions(ListTaskExecutionsRequest listTaskExecutionsRequest)
Returns a list of executed tasks.
|
default ListTaskExecutionsIterable |
listTaskExecutionsPaginator()
Returns a list of executed tasks.
|
default ListTaskExecutionsIterable |
listTaskExecutionsPaginator(Consumer<ListTaskExecutionsRequest.Builder> listTaskExecutionsRequest)
Returns a list of executed tasks.
|
default ListTaskExecutionsIterable |
listTaskExecutionsPaginator(ListTaskExecutionsRequest listTaskExecutionsRequest)
Returns a list of executed tasks.
|
default ListTasksResponse |
listTasks()
Returns a list of all the tasks.
|
default ListTasksResponse |
listTasks(Consumer<ListTasksRequest.Builder> listTasksRequest)
Returns a list of all the tasks.
|
default ListTasksResponse |
listTasks(ListTasksRequest listTasksRequest)
Returns a list of all the tasks.
|
default ListTasksIterable |
listTasksPaginator()
Returns a list of all the tasks.
|
default ListTasksIterable |
listTasksPaginator(Consumer<ListTasksRequest.Builder> listTasksRequest)
Returns a list of all the tasks.
|
default ListTasksIterable |
listTasksPaginator(ListTasksRequest listTasksRequest)
Returns a list of all the tasks.
|
static ServiceMetadata |
serviceMetadata() |
default StartTaskExecutionResponse |
startTaskExecution(Consumer<StartTaskExecutionRequest.Builder> startTaskExecutionRequest)
Starts a specific invocation of a task.
|
default StartTaskExecutionResponse |
startTaskExecution(StartTaskExecutionRequest startTaskExecutionRequest)
Starts a specific invocation of a task.
|
default TagResourceResponse |
tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest)
Applies a key-value pair to an AWS resource.
|
default TagResourceResponse |
tagResource(TagResourceRequest tagResourceRequest)
Applies a key-value pair to an AWS resource.
|
default UntagResourceResponse |
untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest)
Removes a tag from an AWS resource.
|
default UntagResourceResponse |
untagResource(UntagResourceRequest untagResourceRequest)
Removes a tag from an AWS resource.
|
default UpdateAgentResponse |
updateAgent(Consumer<UpdateAgentRequest.Builder> updateAgentRequest)
Updates the name of an agent.
|
default UpdateAgentResponse |
updateAgent(UpdateAgentRequest updateAgentRequest)
Updates the name of an agent.
|
default UpdateTaskResponse |
updateTask(Consumer<UpdateTaskRequest.Builder> updateTaskRequest)
Updates the metadata associated with a task.
|
default UpdateTaskResponse |
updateTask(UpdateTaskRequest updateTaskRequest)
Updates the metadata associated with a task.
|
serviceName
close
static final String SERVICE_NAME
static DataSyncClient create()
DataSyncClient
with the region loaded from the
DefaultAwsRegionProviderChain
and credentials loaded from the
DefaultCredentialsProvider
.static DataSyncClientBuilder builder()
DataSyncClient
.default CancelTaskExecutionResponse cancelTaskExecution(CancelTaskExecutionRequest cancelTaskExecutionRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Cancels execution of a task.
When you cancel a task execution, the transfer of some files are abruptly interrupted. The contents of files that are transferred to the destination might be incomplete or inconsistent with the source files. However, if you start a new task execution on the same task and you allow the task execution to complete, file content on the destination is complete and consistent. This applies to other unexpected failures that interrupt a task execution. In all of these cases, AWS DataSync successfully complete the transfer when you start the next task execution.
cancelTaskExecutionRequest
- CancelTaskExecutionRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default CancelTaskExecutionResponse cancelTaskExecution(Consumer<CancelTaskExecutionRequest.Builder> cancelTaskExecutionRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Cancels execution of a task.
When you cancel a task execution, the transfer of some files are abruptly interrupted. The contents of files that are transferred to the destination might be incomplete or inconsistent with the source files. However, if you start a new task execution on the same task and you allow the task execution to complete, file content on the destination is complete and consistent. This applies to other unexpected failures that interrupt a task execution. In all of these cases, AWS DataSync successfully complete the transfer when you start the next task execution.
This is a convenience which creates an instance of the CancelTaskExecutionRequest.Builder
avoiding the
need to create one manually via CancelTaskExecutionRequest.builder()
cancelTaskExecutionRequest
- A Consumer
that will call methods on CancelTaskExecutionRequest.Builder
to create a
request. CancelTaskExecutionRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default CreateAgentResponse createAgent(CreateAgentRequest createAgentRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Activates an AWS DataSync agent that you have deployed on your host. The activation process associates your agent with your account. In the activation process, you specify information such as the AWS Region that you want to activate the agent in. You activate the agent in the AWS Region where your target locations (in Amazon S3 or Amazon EFS) reside. Your tasks are created in this AWS Region.
You can use an agent for more than one location. If a task uses multiple agents, all of them need to have status AVAILABLE for the task to run. If you use multiple agents for a source location, the status of all the agents must be AVAILABLE for the task to run. For more information, see Activating a Sync Agent in the AWS DataSync User Guide.
Agents are automatically updated by AWS on a regular basis, using a mechanism that ensures minimal interruption to your tasks.
createAgentRequest
- CreateAgentRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default CreateAgentResponse createAgent(Consumer<CreateAgentRequest.Builder> createAgentRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Activates an AWS DataSync agent that you have deployed on your host. The activation process associates your agent with your account. In the activation process, you specify information such as the AWS Region that you want to activate the agent in. You activate the agent in the AWS Region where your target locations (in Amazon S3 or Amazon EFS) reside. Your tasks are created in this AWS Region.
You can use an agent for more than one location. If a task uses multiple agents, all of them need to have status AVAILABLE for the task to run. If you use multiple agents for a source location, the status of all the agents must be AVAILABLE for the task to run. For more information, see Activating a Sync Agent in the AWS DataSync User Guide.
Agents are automatically updated by AWS on a regular basis, using a mechanism that ensures minimal interruption to your tasks.
This is a convenience which creates an instance of the CreateAgentRequest.Builder
avoiding the need to
create one manually via CreateAgentRequest.builder()
createAgentRequest
- A Consumer
that will call methods on CreateAgentRequest.Builder
to create a request.
CreateAgentRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default CreateLocationEfsResponse createLocationEfs(CreateLocationEfsRequest createLocationEfsRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Creates an endpoint for an Amazon EFS file system.
createLocationEfsRequest
- CreateLocationEfsRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default CreateLocationEfsResponse createLocationEfs(Consumer<CreateLocationEfsRequest.Builder> createLocationEfsRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Creates an endpoint for an Amazon EFS file system.
This is a convenience which creates an instance of the CreateLocationEfsRequest.Builder
avoiding the need
to create one manually via CreateLocationEfsRequest.builder()
createLocationEfsRequest
- A Consumer
that will call methods on CreateLocationEfsRequest.Builder
to create a request.
CreateLocationEfsRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default CreateLocationNfsResponse createLocationNfs(CreateLocationNfsRequest createLocationNfsRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Creates an endpoint for a Network File System (NFS) file system.
createLocationNfsRequest
- CreateLocationNfsRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default CreateLocationNfsResponse createLocationNfs(Consumer<CreateLocationNfsRequest.Builder> createLocationNfsRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Creates an endpoint for a Network File System (NFS) file system.
This is a convenience which creates an instance of the CreateLocationNfsRequest.Builder
avoiding the need
to create one manually via CreateLocationNfsRequest.builder()
createLocationNfsRequest
- A Consumer
that will call methods on CreateLocationNfsRequest.Builder
to create a request.
CreateLocationNfsRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default CreateLocationS3Response createLocationS3(CreateLocationS3Request createLocationS3Request) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Creates an endpoint for an Amazon S3 bucket.
For AWS DataSync to access a destination S3 bucket, it needs an AWS Identity and Access Management (IAM) role that has the required permissions. You can set up the required permissions by creating an IAM policy that grants the required permissions and attaching the policy to the role. An example of such a policy is shown in the examples section. For more information, see Configuring Amazon S3 Location Settings in the AWS DataSync User Guide.
createLocationS3Request
- CreateLocationS3RequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default CreateLocationS3Response createLocationS3(Consumer<CreateLocationS3Request.Builder> createLocationS3Request) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Creates an endpoint for an Amazon S3 bucket.
For AWS DataSync to access a destination S3 bucket, it needs an AWS Identity and Access Management (IAM) role that has the required permissions. You can set up the required permissions by creating an IAM policy that grants the required permissions and attaching the policy to the role. An example of such a policy is shown in the examples section. For more information, see Configuring Amazon S3 Location Settings in the AWS DataSync User Guide.
This is a convenience which creates an instance of the CreateLocationS3Request.Builder
avoiding the need
to create one manually via CreateLocationS3Request.builder()
createLocationS3Request
- A Consumer
that will call methods on CreateLocationS3Request.Builder
to create a request.
CreateLocationS3RequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default CreateTaskResponse createTask(CreateTaskRequest createTaskRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Creates a task. A task is a set of two locations (source and destination) and a set of default
OverrideOptions
that you use to control the behavior of a task. If you don't specify default values
for Options
when you create a task, AWS DataSync populates them with safe service defaults.
When you initially create a task, it enters the INITIALIZING status and then the CREATING status. In CREATING status, AWS DataSync attempts to mount the source Network File System (NFS) location. The task transitions to the AVAILABLE status without waiting for the destination location to mount. Instead, AWS DataSync mounts a destination before every task execution and then unmounts it after every task execution.
If an agent that is associated with a source (NFS) location goes offline, the task transitions to the UNAVAILABLE
status. If the status of the task remains in the CREATING status for more than a few minutes, it means that your
agent might be having trouble mounting the source NFS file system. Check the task's ErrorCode
and
ErrorDetail
. Mount issues are often caused by either a misconfigured firewall or a mistyped NFS
server host name.
createTaskRequest
- CreateTaskRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default CreateTaskResponse createTask(Consumer<CreateTaskRequest.Builder> createTaskRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Creates a task. A task is a set of two locations (source and destination) and a set of default
OverrideOptions
that you use to control the behavior of a task. If you don't specify default values
for Options
when you create a task, AWS DataSync populates them with safe service defaults.
When you initially create a task, it enters the INITIALIZING status and then the CREATING status. In CREATING status, AWS DataSync attempts to mount the source Network File System (NFS) location. The task transitions to the AVAILABLE status without waiting for the destination location to mount. Instead, AWS DataSync mounts a destination before every task execution and then unmounts it after every task execution.
If an agent that is associated with a source (NFS) location goes offline, the task transitions to the UNAVAILABLE
status. If the status of the task remains in the CREATING status for more than a few minutes, it means that your
agent might be having trouble mounting the source NFS file system. Check the task's ErrorCode
and
ErrorDetail
. Mount issues are often caused by either a misconfigured firewall or a mistyped NFS
server host name.
This is a convenience which creates an instance of the CreateTaskRequest.Builder
avoiding the need to
create one manually via CreateTaskRequest.builder()
createTaskRequest
- A Consumer
that will call methods on CreateTaskRequest.Builder
to create a request.
CreateTaskRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DeleteAgentResponse deleteAgent(DeleteAgentRequest deleteAgentRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Deletes an agent. To specify which agent to delete, use the Amazon Resource Name (ARN) of the agent in your request. The operation disassociates the agent from your AWS account. However, it doesn't delete the agent virtual machine (VM) from your on-premises environment.
After you delete an agent, you can't reactivate it and you longer pay software charges for it.
deleteAgentRequest
- DeleteAgentRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DeleteAgentResponse deleteAgent(Consumer<DeleteAgentRequest.Builder> deleteAgentRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Deletes an agent. To specify which agent to delete, use the Amazon Resource Name (ARN) of the agent in your request. The operation disassociates the agent from your AWS account. However, it doesn't delete the agent virtual machine (VM) from your on-premises environment.
After you delete an agent, you can't reactivate it and you longer pay software charges for it.
This is a convenience which creates an instance of the DeleteAgentRequest.Builder
avoiding the need to
create one manually via DeleteAgentRequest.builder()
deleteAgentRequest
- A Consumer
that will call methods on DeleteAgentRequest.Builder
to create a request.
DeleteAgentRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DeleteLocationResponse deleteLocation(DeleteLocationRequest deleteLocationRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Deletes the configuration of a location used by AWS DataSync.
deleteLocationRequest
- DeleteLocationInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DeleteLocationResponse deleteLocation(Consumer<DeleteLocationRequest.Builder> deleteLocationRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Deletes the configuration of a location used by AWS DataSync.
This is a convenience which creates an instance of the DeleteLocationRequest.Builder
avoiding the need to
create one manually via DeleteLocationRequest.builder()
deleteLocationRequest
- A Consumer
that will call methods on DeleteLocationRequest.Builder
to create a request.
DeleteLocationInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DeleteTaskResponse deleteTask(DeleteTaskRequest deleteTaskRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Deletes a task.
deleteTaskRequest
- DeleteTaskInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DeleteTaskResponse deleteTask(Consumer<DeleteTaskRequest.Builder> deleteTaskRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Deletes a task.
This is a convenience which creates an instance of the DeleteTaskRequest.Builder
avoiding the need to
create one manually via DeleteTaskRequest.builder()
deleteTaskRequest
- A Consumer
that will call methods on DeleteTaskRequest.Builder
to create a request.
DeleteTaskInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeAgentResponse describeAgent(DescribeAgentRequest describeAgentRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns metadata such as the name, the network interfaces, and the status (that is, whether the agent is running or not) for an agent. To specify which agent to describe, use the Amazon Resource Name (ARN) of the agent in your request.
describeAgentRequest
- DescribeAgentInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeAgentResponse describeAgent(Consumer<DescribeAgentRequest.Builder> describeAgentRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns metadata such as the name, the network interfaces, and the status (that is, whether the agent is running or not) for an agent. To specify which agent to describe, use the Amazon Resource Name (ARN) of the agent in your request.
This is a convenience which creates an instance of the DescribeAgentRequest.Builder
avoiding the need to
create one manually via DescribeAgentRequest.builder()
describeAgentRequest
- A Consumer
that will call methods on DescribeAgentRequest.Builder
to create a request.
DescribeAgentInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeLocationEfsResponse describeLocationEfs(DescribeLocationEfsRequest describeLocationEfsRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns metadata, such as the path information about an Amazon EFS location.
describeLocationEfsRequest
- DescribeLocationEfsRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeLocationEfsResponse describeLocationEfs(Consumer<DescribeLocationEfsRequest.Builder> describeLocationEfsRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns metadata, such as the path information about an Amazon EFS location.
This is a convenience which creates an instance of the DescribeLocationEfsRequest.Builder
avoiding the
need to create one manually via DescribeLocationEfsRequest.builder()
describeLocationEfsRequest
- A Consumer
that will call methods on DescribeLocationEfsRequest.Builder
to create a
request. DescribeLocationEfsRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeLocationNfsResponse describeLocationNfs(DescribeLocationNfsRequest describeLocationNfsRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns metadata, such as the path information, about a NFS location.
describeLocationNfsRequest
- DescribeLocationNfsRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeLocationNfsResponse describeLocationNfs(Consumer<DescribeLocationNfsRequest.Builder> describeLocationNfsRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns metadata, such as the path information, about a NFS location.
This is a convenience which creates an instance of the DescribeLocationNfsRequest.Builder
avoiding the
need to create one manually via DescribeLocationNfsRequest.builder()
describeLocationNfsRequest
- A Consumer
that will call methods on DescribeLocationNfsRequest.Builder
to create a
request. DescribeLocationNfsRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeLocationS3Response describeLocationS3(DescribeLocationS3Request describeLocationS3Request) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns metadata, such as bucket name, about an Amazon S3 bucket location.
describeLocationS3Request
- DescribeLocationS3RequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeLocationS3Response describeLocationS3(Consumer<DescribeLocationS3Request.Builder> describeLocationS3Request) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns metadata, such as bucket name, about an Amazon S3 bucket location.
This is a convenience which creates an instance of the DescribeLocationS3Request.Builder
avoiding the
need to create one manually via DescribeLocationS3Request.builder()
describeLocationS3Request
- A Consumer
that will call methods on DescribeLocationS3Request.Builder
to create a
request. DescribeLocationS3RequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeTaskResponse describeTask(DescribeTaskRequest describeTaskRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns metadata about a task.
describeTaskRequest
- DescribeTaskRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeTaskResponse describeTask(Consumer<DescribeTaskRequest.Builder> describeTaskRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns metadata about a task.
This is a convenience which creates an instance of the DescribeTaskRequest.Builder
avoiding the need to
create one manually via DescribeTaskRequest.builder()
describeTaskRequest
- A Consumer
that will call methods on DescribeTaskRequest.Builder
to create a request.
DescribeTaskRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeTaskExecutionResponse describeTaskExecution(DescribeTaskExecutionRequest describeTaskExecutionRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns detailed metadata about a task that is being executed.
describeTaskExecutionRequest
- DescribeTaskExecutionRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeTaskExecutionResponse describeTaskExecution(Consumer<DescribeTaskExecutionRequest.Builder> describeTaskExecutionRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns detailed metadata about a task that is being executed.
This is a convenience which creates an instance of the DescribeTaskExecutionRequest.Builder
avoiding the
need to create one manually via DescribeTaskExecutionRequest.builder()
describeTaskExecutionRequest
- A Consumer
that will call methods on DescribeTaskExecutionRequest.Builder
to create a
request. DescribeTaskExecutionRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListAgentsResponse listAgents() throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns a list of agents owned by an AWS account in the AWS Region specified in the request. The returned list is ordered by agent Amazon Resource Name (ARN).
By default, this operation returns a maximum of 100 agents. This operation supports pagination that enables you to optionally reduce the number of agents returned in a response.
If you have more agents than are returned in a response (that is, the response returns only a truncated list of your agents), the response contains a marker that you can specify in your next request to fetch the next page of agents.
InvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
listAgents(ListAgentsRequest)
,
AWS API
Documentationdefault ListAgentsResponse listAgents(ListAgentsRequest listAgentsRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns a list of agents owned by an AWS account in the AWS Region specified in the request. The returned list is ordered by agent Amazon Resource Name (ARN).
By default, this operation returns a maximum of 100 agents. This operation supports pagination that enables you to optionally reduce the number of agents returned in a response.
If you have more agents than are returned in a response (that is, the response returns only a truncated list of your agents), the response contains a marker that you can specify in your next request to fetch the next page of agents.
listAgentsRequest
- ListAgentsRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListAgentsResponse listAgents(Consumer<ListAgentsRequest.Builder> listAgentsRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns a list of agents owned by an AWS account in the AWS Region specified in the request. The returned list is ordered by agent Amazon Resource Name (ARN).
By default, this operation returns a maximum of 100 agents. This operation supports pagination that enables you to optionally reduce the number of agents returned in a response.
If you have more agents than are returned in a response (that is, the response returns only a truncated list of your agents), the response contains a marker that you can specify in your next request to fetch the next page of agents.
This is a convenience which creates an instance of the ListAgentsRequest.Builder
avoiding the need to
create one manually via ListAgentsRequest.builder()
listAgentsRequest
- A Consumer
that will call methods on ListAgentsRequest.Builder
to create a request.
ListAgentsRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListAgentsIterable listAgentsPaginator() throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns a list of agents owned by an AWS account in the AWS Region specified in the request. The returned list is ordered by agent Amazon Resource Name (ARN).
By default, this operation returns a maximum of 100 agents. This operation supports pagination that enables you to optionally reduce the number of agents returned in a response.
If you have more agents than are returned in a response (that is, the response returns only a truncated list of your agents), the response contains a marker that you can specify in your next request to fetch the next page of agents.
This is a variant of listAgents(software.amazon.awssdk.services.datasync.model.ListAgentsRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.datasync.paginators.ListAgentsIterable responses = client.listAgentsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.datasync.paginators.ListAgentsIterable responses = client.listAgentsPaginator(request); for (software.amazon.awssdk.services.datasync.model.ListAgentsResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.datasync.paginators.ListAgentsIterable responses = client.listAgentsPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listAgents(software.amazon.awssdk.services.datasync.model.ListAgentsRequest)
operation.
InvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
listAgentsPaginator(ListAgentsRequest)
,
AWS API
Documentationdefault ListAgentsIterable listAgentsPaginator(ListAgentsRequest listAgentsRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns a list of agents owned by an AWS account in the AWS Region specified in the request. The returned list is ordered by agent Amazon Resource Name (ARN).
By default, this operation returns a maximum of 100 agents. This operation supports pagination that enables you to optionally reduce the number of agents returned in a response.
If you have more agents than are returned in a response (that is, the response returns only a truncated list of your agents), the response contains a marker that you can specify in your next request to fetch the next page of agents.
This is a variant of listAgents(software.amazon.awssdk.services.datasync.model.ListAgentsRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.datasync.paginators.ListAgentsIterable responses = client.listAgentsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.datasync.paginators.ListAgentsIterable responses = client.listAgentsPaginator(request); for (software.amazon.awssdk.services.datasync.model.ListAgentsResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.datasync.paginators.ListAgentsIterable responses = client.listAgentsPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listAgents(software.amazon.awssdk.services.datasync.model.ListAgentsRequest)
operation.
listAgentsRequest
- ListAgentsRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListAgentsIterable listAgentsPaginator(Consumer<ListAgentsRequest.Builder> listAgentsRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns a list of agents owned by an AWS account in the AWS Region specified in the request. The returned list is ordered by agent Amazon Resource Name (ARN).
By default, this operation returns a maximum of 100 agents. This operation supports pagination that enables you to optionally reduce the number of agents returned in a response.
If you have more agents than are returned in a response (that is, the response returns only a truncated list of your agents), the response contains a marker that you can specify in your next request to fetch the next page of agents.
This is a variant of listAgents(software.amazon.awssdk.services.datasync.model.ListAgentsRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.datasync.paginators.ListAgentsIterable responses = client.listAgentsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.datasync.paginators.ListAgentsIterable responses = client.listAgentsPaginator(request); for (software.amazon.awssdk.services.datasync.model.ListAgentsResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.datasync.paginators.ListAgentsIterable responses = client.listAgentsPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listAgents(software.amazon.awssdk.services.datasync.model.ListAgentsRequest)
operation.
This is a convenience which creates an instance of the ListAgentsRequest.Builder
avoiding the need to
create one manually via ListAgentsRequest.builder()
listAgentsRequest
- A Consumer
that will call methods on ListAgentsRequest.Builder
to create a request.
ListAgentsRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListLocationsResponse listLocations() throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns a lists of source and destination locations.
If you have more locations than are returned in a response (that is, the response returns only a truncated list of your agents), the response contains a token that you can specify in your next request to fetch the next page of locations.
InvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
listLocations(ListLocationsRequest)
,
AWS API
Documentationdefault ListLocationsResponse listLocations(ListLocationsRequest listLocationsRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns a lists of source and destination locations.
If you have more locations than are returned in a response (that is, the response returns only a truncated list of your agents), the response contains a token that you can specify in your next request to fetch the next page of locations.
listLocationsRequest
- ListLocationsRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListLocationsResponse listLocations(Consumer<ListLocationsRequest.Builder> listLocationsRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns a lists of source and destination locations.
If you have more locations than are returned in a response (that is, the response returns only a truncated list of your agents), the response contains a token that you can specify in your next request to fetch the next page of locations.
This is a convenience which creates an instance of the ListLocationsRequest.Builder
avoiding the need to
create one manually via ListLocationsRequest.builder()
listLocationsRequest
- A Consumer
that will call methods on ListLocationsRequest.Builder
to create a request.
ListLocationsRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListLocationsIterable listLocationsPaginator() throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns a lists of source and destination locations.
If you have more locations than are returned in a response (that is, the response returns only a truncated list of your agents), the response contains a token that you can specify in your next request to fetch the next page of locations.
This is a variant of listLocations(software.amazon.awssdk.services.datasync.model.ListLocationsRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.datasync.paginators.ListLocationsIterable responses = client.listLocationsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.datasync.paginators.ListLocationsIterable responses = client.listLocationsPaginator(request); for (software.amazon.awssdk.services.datasync.model.ListLocationsResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.datasync.paginators.ListLocationsIterable responses = client.listLocationsPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listLocations(software.amazon.awssdk.services.datasync.model.ListLocationsRequest)
operation.
InvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
listLocationsPaginator(ListLocationsRequest)
,
AWS API
Documentationdefault ListLocationsIterable listLocationsPaginator(ListLocationsRequest listLocationsRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns a lists of source and destination locations.
If you have more locations than are returned in a response (that is, the response returns only a truncated list of your agents), the response contains a token that you can specify in your next request to fetch the next page of locations.
This is a variant of listLocations(software.amazon.awssdk.services.datasync.model.ListLocationsRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.datasync.paginators.ListLocationsIterable responses = client.listLocationsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.datasync.paginators.ListLocationsIterable responses = client.listLocationsPaginator(request); for (software.amazon.awssdk.services.datasync.model.ListLocationsResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.datasync.paginators.ListLocationsIterable responses = client.listLocationsPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listLocations(software.amazon.awssdk.services.datasync.model.ListLocationsRequest)
operation.
listLocationsRequest
- ListLocationsRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListLocationsIterable listLocationsPaginator(Consumer<ListLocationsRequest.Builder> listLocationsRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns a lists of source and destination locations.
If you have more locations than are returned in a response (that is, the response returns only a truncated list of your agents), the response contains a token that you can specify in your next request to fetch the next page of locations.
This is a variant of listLocations(software.amazon.awssdk.services.datasync.model.ListLocationsRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.datasync.paginators.ListLocationsIterable responses = client.listLocationsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.datasync.paginators.ListLocationsIterable responses = client.listLocationsPaginator(request); for (software.amazon.awssdk.services.datasync.model.ListLocationsResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.datasync.paginators.ListLocationsIterable responses = client.listLocationsPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listLocations(software.amazon.awssdk.services.datasync.model.ListLocationsRequest)
operation.
This is a convenience which creates an instance of the ListLocationsRequest.Builder
avoiding the need to
create one manually via ListLocationsRequest.builder()
listLocationsRequest
- A Consumer
that will call methods on ListLocationsRequest.Builder
to create a request.
ListLocationsRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListTagsForResourceResponse listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns all the tags associated with a specified resources.
listTagsForResourceRequest
- ListTagsForResourceRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListTagsForResourceResponse listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns all the tags associated with a specified resources.
This is a convenience which creates an instance of the ListTagsForResourceRequest.Builder
avoiding the
need to create one manually via ListTagsForResourceRequest.builder()
listTagsForResourceRequest
- A Consumer
that will call methods on ListTagsForResourceRequest.Builder
to create a
request. ListTagsForResourceRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListTagsForResourceIterable listTagsForResourcePaginator(ListTagsForResourceRequest listTagsForResourceRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns all the tags associated with a specified resources.
This is a variant of
listTagsForResource(software.amazon.awssdk.services.datasync.model.ListTagsForResourceRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.datasync.paginators.ListTagsForResourceIterable responses = client.listTagsForResourcePaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.datasync.paginators.ListTagsForResourceIterable responses = client .listTagsForResourcePaginator(request); for (software.amazon.awssdk.services.datasync.model.ListTagsForResourceResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.datasync.paginators.ListTagsForResourceIterable responses = client.listTagsForResourcePaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listTagsForResource(software.amazon.awssdk.services.datasync.model.ListTagsForResourceRequest)
operation.
listTagsForResourceRequest
- ListTagsForResourceRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListTagsForResourceIterable listTagsForResourcePaginator(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns all the tags associated with a specified resources.
This is a variant of
listTagsForResource(software.amazon.awssdk.services.datasync.model.ListTagsForResourceRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.datasync.paginators.ListTagsForResourceIterable responses = client.listTagsForResourcePaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.datasync.paginators.ListTagsForResourceIterable responses = client .listTagsForResourcePaginator(request); for (software.amazon.awssdk.services.datasync.model.ListTagsForResourceResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.datasync.paginators.ListTagsForResourceIterable responses = client.listTagsForResourcePaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listTagsForResource(software.amazon.awssdk.services.datasync.model.ListTagsForResourceRequest)
operation.
This is a convenience which creates an instance of the ListTagsForResourceRequest.Builder
avoiding the
need to create one manually via ListTagsForResourceRequest.builder()
listTagsForResourceRequest
- A Consumer
that will call methods on ListTagsForResourceRequest.Builder
to create a
request. ListTagsForResourceRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListTaskExecutionsResponse listTaskExecutions() throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns a list of executed tasks.
InvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
listTaskExecutions(ListTaskExecutionsRequest)
,
AWS
API Documentationdefault ListTaskExecutionsResponse listTaskExecutions(ListTaskExecutionsRequest listTaskExecutionsRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns a list of executed tasks.
listTaskExecutionsRequest
- ListTaskExecutionsInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListTaskExecutionsResponse listTaskExecutions(Consumer<ListTaskExecutionsRequest.Builder> listTaskExecutionsRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns a list of executed tasks.
This is a convenience which creates an instance of the ListTaskExecutionsRequest.Builder
avoiding the
need to create one manually via ListTaskExecutionsRequest.builder()
listTaskExecutionsRequest
- A Consumer
that will call methods on ListTaskExecutionsRequest.Builder
to create a
request. ListTaskExecutionsInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListTaskExecutionsIterable listTaskExecutionsPaginator() throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns a list of executed tasks.
This is a variant of
listTaskExecutions(software.amazon.awssdk.services.datasync.model.ListTaskExecutionsRequest)
operation.
The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally
handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.datasync.paginators.ListTaskExecutionsIterable responses = client.listTaskExecutionsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.datasync.paginators.ListTaskExecutionsIterable responses = client .listTaskExecutionsPaginator(request); for (software.amazon.awssdk.services.datasync.model.ListTaskExecutionsResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.datasync.paginators.ListTaskExecutionsIterable responses = client.listTaskExecutionsPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listTaskExecutions(software.amazon.awssdk.services.datasync.model.ListTaskExecutionsRequest)
operation.
InvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
listTaskExecutionsPaginator(ListTaskExecutionsRequest)
,
AWS
API Documentationdefault ListTaskExecutionsIterable listTaskExecutionsPaginator(ListTaskExecutionsRequest listTaskExecutionsRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns a list of executed tasks.
This is a variant of
listTaskExecutions(software.amazon.awssdk.services.datasync.model.ListTaskExecutionsRequest)
operation.
The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally
handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.datasync.paginators.ListTaskExecutionsIterable responses = client.listTaskExecutionsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.datasync.paginators.ListTaskExecutionsIterable responses = client .listTaskExecutionsPaginator(request); for (software.amazon.awssdk.services.datasync.model.ListTaskExecutionsResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.datasync.paginators.ListTaskExecutionsIterable responses = client.listTaskExecutionsPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listTaskExecutions(software.amazon.awssdk.services.datasync.model.ListTaskExecutionsRequest)
operation.
listTaskExecutionsRequest
- ListTaskExecutionsInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListTaskExecutionsIterable listTaskExecutionsPaginator(Consumer<ListTaskExecutionsRequest.Builder> listTaskExecutionsRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns a list of executed tasks.
This is a variant of
listTaskExecutions(software.amazon.awssdk.services.datasync.model.ListTaskExecutionsRequest)
operation.
The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally
handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.datasync.paginators.ListTaskExecutionsIterable responses = client.listTaskExecutionsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.datasync.paginators.ListTaskExecutionsIterable responses = client .listTaskExecutionsPaginator(request); for (software.amazon.awssdk.services.datasync.model.ListTaskExecutionsResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.datasync.paginators.ListTaskExecutionsIterable responses = client.listTaskExecutionsPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listTaskExecutions(software.amazon.awssdk.services.datasync.model.ListTaskExecutionsRequest)
operation.
This is a convenience which creates an instance of the ListTaskExecutionsRequest.Builder
avoiding the
need to create one manually via ListTaskExecutionsRequest.builder()
listTaskExecutionsRequest
- A Consumer
that will call methods on ListTaskExecutionsRequest.Builder
to create a
request. ListTaskExecutionsInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListTasksResponse listTasks() throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns a list of all the tasks.
InvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
listTasks(ListTasksRequest)
,
AWS API
Documentationdefault ListTasksResponse listTasks(ListTasksRequest listTasksRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns a list of all the tasks.
listTasksRequest
- ListTasksRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListTasksResponse listTasks(Consumer<ListTasksRequest.Builder> listTasksRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns a list of all the tasks.
This is a convenience which creates an instance of the ListTasksRequest.Builder
avoiding the need to
create one manually via ListTasksRequest.builder()
listTasksRequest
- A Consumer
that will call methods on ListTasksRequest.Builder
to create a request.
ListTasksRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListTasksIterable listTasksPaginator() throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns a list of all the tasks.
This is a variant of listTasks(software.amazon.awssdk.services.datasync.model.ListTasksRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.datasync.paginators.ListTasksIterable responses = client.listTasksPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.datasync.paginators.ListTasksIterable responses = client.listTasksPaginator(request); for (software.amazon.awssdk.services.datasync.model.ListTasksResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.datasync.paginators.ListTasksIterable responses = client.listTasksPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listTasks(software.amazon.awssdk.services.datasync.model.ListTasksRequest)
operation.
InvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
listTasksPaginator(ListTasksRequest)
,
AWS API
Documentationdefault ListTasksIterable listTasksPaginator(ListTasksRequest listTasksRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns a list of all the tasks.
This is a variant of listTasks(software.amazon.awssdk.services.datasync.model.ListTasksRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.datasync.paginators.ListTasksIterable responses = client.listTasksPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.datasync.paginators.ListTasksIterable responses = client.listTasksPaginator(request); for (software.amazon.awssdk.services.datasync.model.ListTasksResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.datasync.paginators.ListTasksIterable responses = client.listTasksPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listTasks(software.amazon.awssdk.services.datasync.model.ListTasksRequest)
operation.
listTasksRequest
- ListTasksRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListTasksIterable listTasksPaginator(Consumer<ListTasksRequest.Builder> listTasksRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Returns a list of all the tasks.
This is a variant of listTasks(software.amazon.awssdk.services.datasync.model.ListTasksRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.datasync.paginators.ListTasksIterable responses = client.listTasksPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.datasync.paginators.ListTasksIterable responses = client.listTasksPaginator(request); for (software.amazon.awssdk.services.datasync.model.ListTasksResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.datasync.paginators.ListTasksIterable responses = client.listTasksPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listTasks(software.amazon.awssdk.services.datasync.model.ListTasksRequest)
operation.
This is a convenience which creates an instance of the ListTasksRequest.Builder
avoiding the need to
create one manually via ListTasksRequest.builder()
listTasksRequest
- A Consumer
that will call methods on ListTasksRequest.Builder
to create a request.
ListTasksRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default StartTaskExecutionResponse startTaskExecution(StartTaskExecutionRequest startTaskExecutionRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Starts a specific invocation of a task. A TaskExecution
value represents an individual run of a
task. Each task can have at most one TaskExecution
at a time.
TaskExecution
has the following transition phases: INITIALIZING | PREPARING | TRANSFERRING |
VERIFYING | SUCCESS/FAILURE.
For detailed information, see Task Execution in Components and Terminology in the AWS DataSync User Guide.
startTaskExecutionRequest
- StartTaskExecutionRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default StartTaskExecutionResponse startTaskExecution(Consumer<StartTaskExecutionRequest.Builder> startTaskExecutionRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Starts a specific invocation of a task. A TaskExecution
value represents an individual run of a
task. Each task can have at most one TaskExecution
at a time.
TaskExecution
has the following transition phases: INITIALIZING | PREPARING | TRANSFERRING |
VERIFYING | SUCCESS/FAILURE.
For detailed information, see Task Execution in Components and Terminology in the AWS DataSync User Guide.
This is a convenience which creates an instance of the StartTaskExecutionRequest.Builder
avoiding the
need to create one manually via StartTaskExecutionRequest.builder()
startTaskExecutionRequest
- A Consumer
that will call methods on StartTaskExecutionRequest.Builder
to create a
request. StartTaskExecutionRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default TagResourceResponse tagResource(TagResourceRequest tagResourceRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Applies a key-value pair to an AWS resource.
tagResourceRequest
- TagResourceRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default TagResourceResponse tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Applies a key-value pair to an AWS resource.
This is a convenience which creates an instance of the TagResourceRequest.Builder
avoiding the need to
create one manually via TagResourceRequest.builder()
tagResourceRequest
- A Consumer
that will call methods on TagResourceRequest.Builder
to create a request.
TagResourceRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default UntagResourceResponse untagResource(UntagResourceRequest untagResourceRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Removes a tag from an AWS resource.
untagResourceRequest
- UntagResourceRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default UntagResourceResponse untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Removes a tag from an AWS resource.
This is a convenience which creates an instance of the UntagResourceRequest.Builder
avoiding the need to
create one manually via UntagResourceRequest.builder()
untagResourceRequest
- A Consumer
that will call methods on UntagResourceRequest.Builder
to create a request.
UntagResourceRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default UpdateAgentResponse updateAgent(UpdateAgentRequest updateAgentRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Updates the name of an agent.
updateAgentRequest
- UpdateAgentRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default UpdateAgentResponse updateAgent(Consumer<UpdateAgentRequest.Builder> updateAgentRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Updates the name of an agent.
This is a convenience which creates an instance of the UpdateAgentRequest.Builder
avoiding the need to
create one manually via UpdateAgentRequest.builder()
updateAgentRequest
- A Consumer
that will call methods on UpdateAgentRequest.Builder
to create a request.
UpdateAgentRequestInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default UpdateTaskResponse updateTask(UpdateTaskRequest updateTaskRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Updates the metadata associated with a task.
updateTaskRequest
- UpdateTaskResponseInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default UpdateTaskResponse updateTask(Consumer<UpdateTaskRequest.Builder> updateTaskRequest) throws InvalidRequestException, AwsServiceException, SdkClientException, DataSyncException
Updates the metadata associated with a task.
This is a convenience which creates an instance of the UpdateTaskRequest.Builder
avoiding the need to
create one manually via UpdateTaskRequest.builder()
updateTaskRequest
- A Consumer
that will call methods on UpdateTaskRequest.Builder
to create a request.
UpdateTaskResponseInvalidRequestException
- This exception is thrown when the client submits a malformed request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.DataSyncException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
static ServiceMetadata serviceMetadata()
Copyright © 2017 Amazon Web Services, Inc. All Rights Reserved.