Interface TransferClient
- All Superinterfaces:
AutoCloseable,AwsClient,SdkAutoCloseable,SdkClient
builder() method.
Transfer Family is a fully managed service that enables the transfer of files over the File Transfer Protocol (FTP), File Transfer Protocol over SSL (FTPS), or Secure Shell (SSH) File Transfer Protocol (SFTP) directly into and out of Amazon Simple Storage Service (Amazon S3) or Amazon EFS. Additionally, you can use Applicability Statement 2 (AS2) to transfer files into and out of Amazon S3. Amazon Web Services helps you seamlessly migrate your file transfer workflows to Transfer Family by integrating with existing authentication systems, and providing DNS routing with Amazon Route 53 so nothing changes for your customers and partners, or their applications. With your data in Amazon S3, you can use it with Amazon Web Services services for processing, analytics, machine learning, and archiving. Getting started with Transfer Family is easy since there is no infrastructure to buy and set up.
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringValue for looking up the service's metadata from theServiceMetadataProvider.static final String -
Method Summary
Modifier and TypeMethodDescriptionstatic TransferClientBuilderbuilder()Create a builder that can be used to configure and create aTransferClient.static TransferClientcreate()Create aTransferClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider.default CreateAccessResponsecreateAccess(Consumer<CreateAccessRequest.Builder> createAccessRequest) Used by administrators to choose which groups in the directory should have access to upload and download files over the enabled protocols using Transfer Family.default CreateAccessResponsecreateAccess(CreateAccessRequest createAccessRequest) Used by administrators to choose which groups in the directory should have access to upload and download files over the enabled protocols using Transfer Family.default CreateAgreementResponsecreateAgreement(Consumer<CreateAgreementRequest.Builder> createAgreementRequest) Creates an agreement.default CreateAgreementResponsecreateAgreement(CreateAgreementRequest createAgreementRequest) Creates an agreement.default CreateConnectorResponsecreateConnector(Consumer<CreateConnectorRequest.Builder> createConnectorRequest) Creates the connector, which captures the parameters for a connection for the AS2 or SFTP protocol.default CreateConnectorResponsecreateConnector(CreateConnectorRequest createConnectorRequest) Creates the connector, which captures the parameters for a connection for the AS2 or SFTP protocol.default CreateProfileResponsecreateProfile(Consumer<CreateProfileRequest.Builder> createProfileRequest) Creates the local or partner profile to use for AS2 transfers.default CreateProfileResponsecreateProfile(CreateProfileRequest createProfileRequest) Creates the local or partner profile to use for AS2 transfers.default CreateServerResponsecreateServer(Consumer<CreateServerRequest.Builder> createServerRequest) Instantiates an auto-scaling virtual server based on the selected file transfer protocol in Amazon Web Services.default CreateServerResponsecreateServer(CreateServerRequest createServerRequest) Instantiates an auto-scaling virtual server based on the selected file transfer protocol in Amazon Web Services.default CreateUserResponsecreateUser(Consumer<CreateUserRequest.Builder> createUserRequest) Creates a user and associates them with an existing file transfer protocol-enabled server.default CreateUserResponsecreateUser(CreateUserRequest createUserRequest) Creates a user and associates them with an existing file transfer protocol-enabled server.default CreateWorkflowResponsecreateWorkflow(Consumer<CreateWorkflowRequest.Builder> createWorkflowRequest) Allows you to create a workflow with specified steps and step details the workflow invokes after file transfer completes.default CreateWorkflowResponsecreateWorkflow(CreateWorkflowRequest createWorkflowRequest) Allows you to create a workflow with specified steps and step details the workflow invokes after file transfer completes.default DeleteAccessResponsedeleteAccess(Consumer<DeleteAccessRequest.Builder> deleteAccessRequest) Allows you to delete the access specified in theServerIDandExternalIDparameters.default DeleteAccessResponsedeleteAccess(DeleteAccessRequest deleteAccessRequest) Allows you to delete the access specified in theServerIDandExternalIDparameters.default DeleteAgreementResponsedeleteAgreement(Consumer<DeleteAgreementRequest.Builder> deleteAgreementRequest) Delete the agreement that's specified in the providedAgreementId.default DeleteAgreementResponsedeleteAgreement(DeleteAgreementRequest deleteAgreementRequest) Delete the agreement that's specified in the providedAgreementId.default DeleteCertificateResponsedeleteCertificate(Consumer<DeleteCertificateRequest.Builder> deleteCertificateRequest) Deletes the certificate that's specified in theCertificateIdparameter.default DeleteCertificateResponsedeleteCertificate(DeleteCertificateRequest deleteCertificateRequest) Deletes the certificate that's specified in theCertificateIdparameter.default DeleteConnectorResponsedeleteConnector(Consumer<DeleteConnectorRequest.Builder> deleteConnectorRequest) Deletes the connector that's specified in the providedConnectorId.default DeleteConnectorResponsedeleteConnector(DeleteConnectorRequest deleteConnectorRequest) Deletes the connector that's specified in the providedConnectorId.default DeleteHostKeyResponsedeleteHostKey(Consumer<DeleteHostKeyRequest.Builder> deleteHostKeyRequest) Deletes the host key that's specified in theHostKeyIdparameter.default DeleteHostKeyResponsedeleteHostKey(DeleteHostKeyRequest deleteHostKeyRequest) Deletes the host key that's specified in theHostKeyIdparameter.default DeleteProfileResponsedeleteProfile(Consumer<DeleteProfileRequest.Builder> deleteProfileRequest) Deletes the profile that's specified in theProfileIdparameter.default DeleteProfileResponsedeleteProfile(DeleteProfileRequest deleteProfileRequest) Deletes the profile that's specified in theProfileIdparameter.default DeleteServerResponsedeleteServer(Consumer<DeleteServerRequest.Builder> deleteServerRequest) Deletes the file transfer protocol-enabled server that you specify.default DeleteServerResponsedeleteServer(DeleteServerRequest deleteServerRequest) Deletes the file transfer protocol-enabled server that you specify.default DeleteSshPublicKeyResponsedeleteSshPublicKey(Consumer<DeleteSshPublicKeyRequest.Builder> deleteSshPublicKeyRequest) Deletes a user's Secure Shell (SSH) public key.default DeleteSshPublicKeyResponsedeleteSshPublicKey(DeleteSshPublicKeyRequest deleteSshPublicKeyRequest) Deletes a user's Secure Shell (SSH) public key.default DeleteUserResponsedeleteUser(Consumer<DeleteUserRequest.Builder> deleteUserRequest) Deletes the user belonging to a file transfer protocol-enabled server you specify.default DeleteUserResponsedeleteUser(DeleteUserRequest deleteUserRequest) Deletes the user belonging to a file transfer protocol-enabled server you specify.default DeleteWorkflowResponsedeleteWorkflow(Consumer<DeleteWorkflowRequest.Builder> deleteWorkflowRequest) Deletes the specified workflow.default DeleteWorkflowResponsedeleteWorkflow(DeleteWorkflowRequest deleteWorkflowRequest) Deletes the specified workflow.default DescribeAccessResponsedescribeAccess(Consumer<DescribeAccessRequest.Builder> describeAccessRequest) Describes the access that is assigned to the specific file transfer protocol-enabled server, as identified by itsServerIdproperty and itsExternalId.default DescribeAccessResponsedescribeAccess(DescribeAccessRequest describeAccessRequest) Describes the access that is assigned to the specific file transfer protocol-enabled server, as identified by itsServerIdproperty and itsExternalId.default DescribeAgreementResponsedescribeAgreement(Consumer<DescribeAgreementRequest.Builder> describeAgreementRequest) Describes the agreement that's identified by theAgreementId.default DescribeAgreementResponsedescribeAgreement(DescribeAgreementRequest describeAgreementRequest) Describes the agreement that's identified by theAgreementId.default DescribeCertificateResponsedescribeCertificate(Consumer<DescribeCertificateRequest.Builder> describeCertificateRequest) Describes the certificate that's identified by theCertificateId.default DescribeCertificateResponsedescribeCertificate(DescribeCertificateRequest describeCertificateRequest) Describes the certificate that's identified by theCertificateId.default DescribeConnectorResponsedescribeConnector(Consumer<DescribeConnectorRequest.Builder> describeConnectorRequest) Describes the connector that's identified by theConnectorId.default DescribeConnectorResponsedescribeConnector(DescribeConnectorRequest describeConnectorRequest) Describes the connector that's identified by theConnectorId.default DescribeExecutionResponsedescribeExecution(Consumer<DescribeExecutionRequest.Builder> describeExecutionRequest) You can useDescribeExecutionto check the details of the execution of the specified workflow.default DescribeExecutionResponsedescribeExecution(DescribeExecutionRequest describeExecutionRequest) You can useDescribeExecutionto check the details of the execution of the specified workflow.default DescribeHostKeyResponsedescribeHostKey(Consumer<DescribeHostKeyRequest.Builder> describeHostKeyRequest) Returns the details of the host key that's specified by theHostKeyIdandServerId.default DescribeHostKeyResponsedescribeHostKey(DescribeHostKeyRequest describeHostKeyRequest) Returns the details of the host key that's specified by theHostKeyIdandServerId.default DescribeProfileResponsedescribeProfile(Consumer<DescribeProfileRequest.Builder> describeProfileRequest) Returns the details of the profile that's specified by theProfileId.default DescribeProfileResponsedescribeProfile(DescribeProfileRequest describeProfileRequest) Returns the details of the profile that's specified by theProfileId.default DescribeSecurityPolicyResponsedescribeSecurityPolicy(Consumer<DescribeSecurityPolicyRequest.Builder> describeSecurityPolicyRequest) Describes the security policy that is attached to your server or SFTP connector.default DescribeSecurityPolicyResponsedescribeSecurityPolicy(DescribeSecurityPolicyRequest describeSecurityPolicyRequest) Describes the security policy that is attached to your server or SFTP connector.default DescribeServerResponsedescribeServer(Consumer<DescribeServerRequest.Builder> describeServerRequest) Describes a file transfer protocol-enabled server that you specify by passing theServerIdparameter.default DescribeServerResponsedescribeServer(DescribeServerRequest describeServerRequest) Describes a file transfer protocol-enabled server that you specify by passing theServerIdparameter.default DescribeUserResponsedescribeUser(Consumer<DescribeUserRequest.Builder> describeUserRequest) Describes the user assigned to the specific file transfer protocol-enabled server, as identified by itsServerIdproperty.default DescribeUserResponsedescribeUser(DescribeUserRequest describeUserRequest) Describes the user assigned to the specific file transfer protocol-enabled server, as identified by itsServerIdproperty.default DescribeWorkflowResponsedescribeWorkflow(Consumer<DescribeWorkflowRequest.Builder> describeWorkflowRequest) Describes the specified workflow.default DescribeWorkflowResponsedescribeWorkflow(DescribeWorkflowRequest describeWorkflowRequest) Describes the specified workflow.default ImportCertificateResponseimportCertificate(Consumer<ImportCertificateRequest.Builder> importCertificateRequest) Imports the signing and encryption certificates that you need to create local (AS2) profiles and partner profiles.default ImportCertificateResponseimportCertificate(ImportCertificateRequest importCertificateRequest) Imports the signing and encryption certificates that you need to create local (AS2) profiles and partner profiles.default ImportHostKeyResponseimportHostKey(Consumer<ImportHostKeyRequest.Builder> importHostKeyRequest) Adds a host key to the server that's specified by theServerIdparameter.default ImportHostKeyResponseimportHostKey(ImportHostKeyRequest importHostKeyRequest) Adds a host key to the server that's specified by theServerIdparameter.default ImportSshPublicKeyResponseimportSshPublicKey(Consumer<ImportSshPublicKeyRequest.Builder> importSshPublicKeyRequest) Adds a Secure Shell (SSH) public key to a Transfer Family user identified by aUserNamevalue assigned to the specific file transfer protocol-enabled server, identified byServerId.default ImportSshPublicKeyResponseimportSshPublicKey(ImportSshPublicKeyRequest importSshPublicKeyRequest) Adds a Secure Shell (SSH) public key to a Transfer Family user identified by aUserNamevalue assigned to the specific file transfer protocol-enabled server, identified byServerId.default ListAccessesResponselistAccesses(Consumer<ListAccessesRequest.Builder> listAccessesRequest) Lists the details for all the accesses you have on your server.default ListAccessesResponselistAccesses(ListAccessesRequest listAccessesRequest) Lists the details for all the accesses you have on your server.default ListAccessesIterablelistAccessesPaginator(Consumer<ListAccessesRequest.Builder> listAccessesRequest) This is a variant oflistAccesses(software.amazon.awssdk.services.transfer.model.ListAccessesRequest)operation.default ListAccessesIterablelistAccessesPaginator(ListAccessesRequest listAccessesRequest) This is a variant oflistAccesses(software.amazon.awssdk.services.transfer.model.ListAccessesRequest)operation.default ListAgreementsResponselistAgreements(Consumer<ListAgreementsRequest.Builder> listAgreementsRequest) Returns a list of the agreements for the server that's identified by theServerIdthat you supply.default ListAgreementsResponselistAgreements(ListAgreementsRequest listAgreementsRequest) Returns a list of the agreements for the server that's identified by theServerIdthat you supply.default ListAgreementsIterablelistAgreementsPaginator(Consumer<ListAgreementsRequest.Builder> listAgreementsRequest) This is a variant oflistAgreements(software.amazon.awssdk.services.transfer.model.ListAgreementsRequest)operation.default ListAgreementsIterablelistAgreementsPaginator(ListAgreementsRequest listAgreementsRequest) This is a variant oflistAgreements(software.amazon.awssdk.services.transfer.model.ListAgreementsRequest)operation.default ListCertificatesResponselistCertificates(Consumer<ListCertificatesRequest.Builder> listCertificatesRequest) Returns a list of the current certificates that have been imported into Transfer Family.default ListCertificatesResponselistCertificates(ListCertificatesRequest listCertificatesRequest) Returns a list of the current certificates that have been imported into Transfer Family.default ListCertificatesIterablelistCertificatesPaginator(Consumer<ListCertificatesRequest.Builder> listCertificatesRequest) This is a variant oflistCertificates(software.amazon.awssdk.services.transfer.model.ListCertificatesRequest)operation.default ListCertificatesIterablelistCertificatesPaginator(ListCertificatesRequest listCertificatesRequest) This is a variant oflistCertificates(software.amazon.awssdk.services.transfer.model.ListCertificatesRequest)operation.default ListConnectorsResponselistConnectors(Consumer<ListConnectorsRequest.Builder> listConnectorsRequest) Lists the connectors for the specified Region.default ListConnectorsResponselistConnectors(ListConnectorsRequest listConnectorsRequest) Lists the connectors for the specified Region.default ListConnectorsIterablelistConnectorsPaginator(Consumer<ListConnectorsRequest.Builder> listConnectorsRequest) This is a variant oflistConnectors(software.amazon.awssdk.services.transfer.model.ListConnectorsRequest)operation.default ListConnectorsIterablelistConnectorsPaginator(ListConnectorsRequest listConnectorsRequest) This is a variant oflistConnectors(software.amazon.awssdk.services.transfer.model.ListConnectorsRequest)operation.default ListExecutionsResponselistExecutions(Consumer<ListExecutionsRequest.Builder> listExecutionsRequest) Lists all in-progress executions for the specified workflow.default ListExecutionsResponselistExecutions(ListExecutionsRequest listExecutionsRequest) Lists all in-progress executions for the specified workflow.default ListExecutionsIterablelistExecutionsPaginator(Consumer<ListExecutionsRequest.Builder> listExecutionsRequest) This is a variant oflistExecutions(software.amazon.awssdk.services.transfer.model.ListExecutionsRequest)operation.default ListExecutionsIterablelistExecutionsPaginator(ListExecutionsRequest listExecutionsRequest) This is a variant oflistExecutions(software.amazon.awssdk.services.transfer.model.ListExecutionsRequest)operation.default ListFileTransferResultsResponselistFileTransferResults(Consumer<ListFileTransferResultsRequest.Builder> listFileTransferResultsRequest) Returns real-time updates and detailed information on the status of each individual file being transferred in a specific file transfer operation.default ListFileTransferResultsResponselistFileTransferResults(ListFileTransferResultsRequest listFileTransferResultsRequest) Returns real-time updates and detailed information on the status of each individual file being transferred in a specific file transfer operation.default ListFileTransferResultsIterablelistFileTransferResultsPaginator(Consumer<ListFileTransferResultsRequest.Builder> listFileTransferResultsRequest) This is a variant oflistFileTransferResults(software.amazon.awssdk.services.transfer.model.ListFileTransferResultsRequest)operation.default ListFileTransferResultsIterablelistFileTransferResultsPaginator(ListFileTransferResultsRequest listFileTransferResultsRequest) This is a variant oflistFileTransferResults(software.amazon.awssdk.services.transfer.model.ListFileTransferResultsRequest)operation.default ListHostKeysResponselistHostKeys(Consumer<ListHostKeysRequest.Builder> listHostKeysRequest) Returns a list of host keys for the server that's specified by theServerIdparameter.default ListHostKeysResponselistHostKeys(ListHostKeysRequest listHostKeysRequest) Returns a list of host keys for the server that's specified by theServerIdparameter.default ListProfilesResponselistProfiles(Consumer<ListProfilesRequest.Builder> listProfilesRequest) Returns a list of the profiles for your system.default ListProfilesResponselistProfiles(ListProfilesRequest listProfilesRequest) Returns a list of the profiles for your system.default ListProfilesIterablelistProfilesPaginator(Consumer<ListProfilesRequest.Builder> listProfilesRequest) This is a variant oflistProfiles(software.amazon.awssdk.services.transfer.model.ListProfilesRequest)operation.default ListProfilesIterablelistProfilesPaginator(ListProfilesRequest listProfilesRequest) This is a variant oflistProfiles(software.amazon.awssdk.services.transfer.model.ListProfilesRequest)operation.default ListSecurityPoliciesResponselistSecurityPolicies(Consumer<ListSecurityPoliciesRequest.Builder> listSecurityPoliciesRequest) Lists the security policies that are attached to your servers and SFTP connectors.default ListSecurityPoliciesResponselistSecurityPolicies(ListSecurityPoliciesRequest listSecurityPoliciesRequest) Lists the security policies that are attached to your servers and SFTP connectors.default ListSecurityPoliciesIterablelistSecurityPoliciesPaginator(Consumer<ListSecurityPoliciesRequest.Builder> listSecurityPoliciesRequest) This is a variant oflistSecurityPolicies(software.amazon.awssdk.services.transfer.model.ListSecurityPoliciesRequest)operation.default ListSecurityPoliciesIterablelistSecurityPoliciesPaginator(ListSecurityPoliciesRequest listSecurityPoliciesRequest) This is a variant oflistSecurityPolicies(software.amazon.awssdk.services.transfer.model.ListSecurityPoliciesRequest)operation.default ListServersResponseLists the file transfer protocol-enabled servers that are associated with your Amazon Web Services account.default ListServersResponselistServers(Consumer<ListServersRequest.Builder> listServersRequest) Lists the file transfer protocol-enabled servers that are associated with your Amazon Web Services account.default ListServersResponselistServers(ListServersRequest listServersRequest) Lists the file transfer protocol-enabled servers that are associated with your Amazon Web Services account.default ListServersIterableThis is a variant oflistServers(software.amazon.awssdk.services.transfer.model.ListServersRequest)operation.default ListServersIterablelistServersPaginator(Consumer<ListServersRequest.Builder> listServersRequest) This is a variant oflistServers(software.amazon.awssdk.services.transfer.model.ListServersRequest)operation.default ListServersIterablelistServersPaginator(ListServersRequest listServersRequest) This is a variant oflistServers(software.amazon.awssdk.services.transfer.model.ListServersRequest)operation.default ListTagsForResourceResponselistTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) Lists all of the tags associated with the Amazon Resource Name (ARN) that you specify.default ListTagsForResourceResponselistTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) Lists all of the tags associated with the Amazon Resource Name (ARN) that you specify.default ListTagsForResourceIterablelistTagsForResourcePaginator(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) This is a variant oflistTagsForResource(software.amazon.awssdk.services.transfer.model.ListTagsForResourceRequest)operation.default ListTagsForResourceIterablelistTagsForResourcePaginator(ListTagsForResourceRequest listTagsForResourceRequest) This is a variant oflistTagsForResource(software.amazon.awssdk.services.transfer.model.ListTagsForResourceRequest)operation.default ListUsersResponselistUsers(Consumer<ListUsersRequest.Builder> listUsersRequest) Lists the users for a file transfer protocol-enabled server that you specify by passing theServerIdparameter.default ListUsersResponselistUsers(ListUsersRequest listUsersRequest) Lists the users for a file transfer protocol-enabled server that you specify by passing theServerIdparameter.default ListUsersIterablelistUsersPaginator(Consumer<ListUsersRequest.Builder> listUsersRequest) This is a variant oflistUsers(software.amazon.awssdk.services.transfer.model.ListUsersRequest)operation.default ListUsersIterablelistUsersPaginator(ListUsersRequest listUsersRequest) This is a variant oflistUsers(software.amazon.awssdk.services.transfer.model.ListUsersRequest)operation.default ListWorkflowsResponselistWorkflows(Consumer<ListWorkflowsRequest.Builder> listWorkflowsRequest) Lists all workflows associated with your Amazon Web Services account for your current region.default ListWorkflowsResponselistWorkflows(ListWorkflowsRequest listWorkflowsRequest) Lists all workflows associated with your Amazon Web Services account for your current region.default ListWorkflowsIterablelistWorkflowsPaginator(Consumer<ListWorkflowsRequest.Builder> listWorkflowsRequest) This is a variant oflistWorkflows(software.amazon.awssdk.services.transfer.model.ListWorkflowsRequest)operation.default ListWorkflowsIterablelistWorkflowsPaginator(ListWorkflowsRequest listWorkflowsRequest) This is a variant oflistWorkflows(software.amazon.awssdk.services.transfer.model.ListWorkflowsRequest)operation.default SendWorkflowStepStateResponsesendWorkflowStepState(Consumer<SendWorkflowStepStateRequest.Builder> sendWorkflowStepStateRequest) Sends a callback for asynchronous custom steps.default SendWorkflowStepStateResponsesendWorkflowStepState(SendWorkflowStepStateRequest sendWorkflowStepStateRequest) Sends a callback for asynchronous custom steps.The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfigurationstatic ServiceMetadatadefault StartDirectoryListingResponsestartDirectoryListing(Consumer<StartDirectoryListingRequest.Builder> startDirectoryListingRequest) Retrieves a list of the contents of a directory from a remote SFTP server.default StartDirectoryListingResponsestartDirectoryListing(StartDirectoryListingRequest startDirectoryListingRequest) Retrieves a list of the contents of a directory from a remote SFTP server.default StartFileTransferResponsestartFileTransfer(Consumer<StartFileTransferRequest.Builder> startFileTransferRequest) Begins a file transfer between local Amazon Web Services storage and a remote AS2 or SFTP server.default StartFileTransferResponsestartFileTransfer(StartFileTransferRequest startFileTransferRequest) Begins a file transfer between local Amazon Web Services storage and a remote AS2 or SFTP server.default StartServerResponsestartServer(Consumer<StartServerRequest.Builder> startServerRequest) Changes the state of a file transfer protocol-enabled server fromOFFLINEtoONLINE.default StartServerResponsestartServer(StartServerRequest startServerRequest) Changes the state of a file transfer protocol-enabled server fromOFFLINEtoONLINE.default StopServerResponsestopServer(Consumer<StopServerRequest.Builder> stopServerRequest) Changes the state of a file transfer protocol-enabled server fromONLINEtoOFFLINE.default StopServerResponsestopServer(StopServerRequest stopServerRequest) Changes the state of a file transfer protocol-enabled server fromONLINEtoOFFLINE.default TagResourceResponsetagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) Attaches a key-value pair to a resource, as identified by its Amazon Resource Name (ARN).default TagResourceResponsetagResource(TagResourceRequest tagResourceRequest) Attaches a key-value pair to a resource, as identified by its Amazon Resource Name (ARN).default TestConnectionResponsetestConnection(Consumer<TestConnectionRequest.Builder> testConnectionRequest) Tests whether your SFTP connector is set up successfully.default TestConnectionResponsetestConnection(TestConnectionRequest testConnectionRequest) Tests whether your SFTP connector is set up successfully.default TestIdentityProviderResponsetestIdentityProvider(Consumer<TestIdentityProviderRequest.Builder> testIdentityProviderRequest) If theIdentityProviderTypeof a file transfer protocol-enabled server isAWS_DIRECTORY_SERVICEorAPI_Gateway, tests whether your identity provider is set up successfully.default TestIdentityProviderResponsetestIdentityProvider(TestIdentityProviderRequest testIdentityProviderRequest) If theIdentityProviderTypeof a file transfer protocol-enabled server isAWS_DIRECTORY_SERVICEorAPI_Gateway, tests whether your identity provider is set up successfully.default UntagResourceResponseuntagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) Detaches a key-value pair from a resource, as identified by its Amazon Resource Name (ARN).default UntagResourceResponseuntagResource(UntagResourceRequest untagResourceRequest) Detaches a key-value pair from a resource, as identified by its Amazon Resource Name (ARN).default UpdateAccessResponseupdateAccess(Consumer<UpdateAccessRequest.Builder> updateAccessRequest) Allows you to update parameters for the access specified in theServerIDandExternalIDparameters.default UpdateAccessResponseupdateAccess(UpdateAccessRequest updateAccessRequest) Allows you to update parameters for the access specified in theServerIDandExternalIDparameters.default UpdateAgreementResponseupdateAgreement(Consumer<UpdateAgreementRequest.Builder> updateAgreementRequest) Updates some of the parameters for an existing agreement.default UpdateAgreementResponseupdateAgreement(UpdateAgreementRequest updateAgreementRequest) Updates some of the parameters for an existing agreement.default UpdateCertificateResponseupdateCertificate(Consumer<UpdateCertificateRequest.Builder> updateCertificateRequest) Updates the active and inactive dates for a certificate.default UpdateCertificateResponseupdateCertificate(UpdateCertificateRequest updateCertificateRequest) Updates the active and inactive dates for a certificate.default UpdateConnectorResponseupdateConnector(Consumer<UpdateConnectorRequest.Builder> updateConnectorRequest) Updates some of the parameters for an existing connector.default UpdateConnectorResponseupdateConnector(UpdateConnectorRequest updateConnectorRequest) Updates some of the parameters for an existing connector.default UpdateHostKeyResponseupdateHostKey(Consumer<UpdateHostKeyRequest.Builder> updateHostKeyRequest) Updates the description for the host key that's specified by theServerIdandHostKeyIdparameters.default UpdateHostKeyResponseupdateHostKey(UpdateHostKeyRequest updateHostKeyRequest) Updates the description for the host key that's specified by theServerIdandHostKeyIdparameters.default UpdateProfileResponseupdateProfile(Consumer<UpdateProfileRequest.Builder> updateProfileRequest) Updates some of the parameters for an existing profile.default UpdateProfileResponseupdateProfile(UpdateProfileRequest updateProfileRequest) Updates some of the parameters for an existing profile.default UpdateServerResponseupdateServer(Consumer<UpdateServerRequest.Builder> updateServerRequest) Updates the file transfer protocol-enabled server's properties after that server has been created.default UpdateServerResponseupdateServer(UpdateServerRequest updateServerRequest) Updates the file transfer protocol-enabled server's properties after that server has been created.default UpdateUserResponseupdateUser(Consumer<UpdateUserRequest.Builder> updateUserRequest) Assigns new properties to a user.default UpdateUserResponseupdateUser(UpdateUserRequest updateUserRequest) Assigns new properties to a user.default TransferWaiterwaiter()Create an instance ofTransferWaiterusing this client.Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
closeMethods inherited from interface software.amazon.awssdk.core.SdkClient
serviceName
-
Field Details
-
SERVICE_NAME
- See Also:
-
SERVICE_METADATA_ID
Value for looking up the service's metadata from theServiceMetadataProvider.- See Also:
-
-
Method Details
-
createAccess
default CreateAccessResponse createAccess(CreateAccessRequest createAccessRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, ResourceExistsException, AwsServiceException, SdkClientException, TransferException Used by administrators to choose which groups in the directory should have access to upload and download files over the enabled protocols using Transfer Family. For example, a Microsoft Active Directory might contain 50,000 users, but only a small fraction might need the ability to transfer files to the server. An administrator can use
CreateAccessto limit the access to the correct set of users who need this ability.- Parameters:
createAccessRequest-- Returns:
- Result of the CreateAccess operation returned by the service.
- See Also:
-
createAccess
default CreateAccessResponse createAccess(Consumer<CreateAccessRequest.Builder> createAccessRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, ResourceExistsException, AwsServiceException, SdkClientException, TransferException Used by administrators to choose which groups in the directory should have access to upload and download files over the enabled protocols using Transfer Family. For example, a Microsoft Active Directory might contain 50,000 users, but only a small fraction might need the ability to transfer files to the server. An administrator can use
CreateAccessto limit the access to the correct set of users who need this ability.
This is a convenience which creates an instance of the
CreateAccessRequest.Builderavoiding the need to create one manually viaCreateAccessRequest.builder()- Parameters:
createAccessRequest- AConsumerthat will call methods onCreateAccessRequest.Builderto create a request.- Returns:
- Result of the CreateAccess operation returned by the service.
- See Also:
-
createAgreement
default CreateAgreementResponse createAgreement(CreateAgreementRequest createAgreementRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, ResourceExistsException, AwsServiceException, SdkClientException, TransferException Creates an agreement. An agreement is a bilateral trading partner agreement, or partnership, between an Transfer Family server and an AS2 process. The agreement defines the file and message transfer relationship between the server and the AS2 process. To define an agreement, Transfer Family combines a server, local profile, partner profile, certificate, and other attributes.
The partner is identified with the
PartnerProfileId, and the AS2 process is identified with theLocalProfileId.- Parameters:
createAgreementRequest-- Returns:
- Result of the CreateAgreement operation returned by the service.
- See Also:
-
createAgreement
default CreateAgreementResponse createAgreement(Consumer<CreateAgreementRequest.Builder> createAgreementRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, ResourceExistsException, AwsServiceException, SdkClientException, TransferException Creates an agreement. An agreement is a bilateral trading partner agreement, or partnership, between an Transfer Family server and an AS2 process. The agreement defines the file and message transfer relationship between the server and the AS2 process. To define an agreement, Transfer Family combines a server, local profile, partner profile, certificate, and other attributes.
The partner is identified with the
PartnerProfileId, and the AS2 process is identified with theLocalProfileId.
This is a convenience which creates an instance of the
CreateAgreementRequest.Builderavoiding the need to create one manually viaCreateAgreementRequest.builder()- Parameters:
createAgreementRequest- AConsumerthat will call methods onCreateAgreementRequest.Builderto create a request.- Returns:
- Result of the CreateAgreement operation returned by the service.
- See Also:
-
createConnector
default CreateConnectorResponse createConnector(CreateConnectorRequest createConnectorRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, ResourceExistsException, AwsServiceException, SdkClientException, TransferException Creates the connector, which captures the parameters for a connection for the AS2 or SFTP protocol. For AS2, the connector is required for sending files to an externally hosted AS2 server. For SFTP, the connector is required when sending files to an SFTP server or receiving files from an SFTP server. For more details about connectors, see Configure AS2 connectors and Create SFTP connectors.
You must specify exactly one configuration object: either for AS2 (
As2Config) or SFTP (SftpConfig).- Parameters:
createConnectorRequest-- Returns:
- Result of the CreateConnector operation returned by the service.
- See Also:
-
createConnector
default CreateConnectorResponse createConnector(Consumer<CreateConnectorRequest.Builder> createConnectorRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, ResourceExistsException, AwsServiceException, SdkClientException, TransferException Creates the connector, which captures the parameters for a connection for the AS2 or SFTP protocol. For AS2, the connector is required for sending files to an externally hosted AS2 server. For SFTP, the connector is required when sending files to an SFTP server or receiving files from an SFTP server. For more details about connectors, see Configure AS2 connectors and Create SFTP connectors.
You must specify exactly one configuration object: either for AS2 (
As2Config) or SFTP (SftpConfig).
This is a convenience which creates an instance of the
CreateConnectorRequest.Builderavoiding the need to create one manually viaCreateConnectorRequest.builder()- Parameters:
createConnectorRequest- AConsumerthat will call methods onCreateConnectorRequest.Builderto create a request.- Returns:
- Result of the CreateConnector operation returned by the service.
- See Also:
-
createProfile
default CreateProfileResponse createProfile(CreateProfileRequest createProfileRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Creates the local or partner profile to use for AS2 transfers.
- Parameters:
createProfileRequest-- Returns:
- Result of the CreateProfile operation returned by the service.
- See Also:
-
createProfile
default CreateProfileResponse createProfile(Consumer<CreateProfileRequest.Builder> createProfileRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Creates the local or partner profile to use for AS2 transfers.
This is a convenience which creates an instance of the
CreateProfileRequest.Builderavoiding the need to create one manually viaCreateProfileRequest.builder()- Parameters:
createProfileRequest- AConsumerthat will call methods onCreateProfileRequest.Builderto create a request.- Returns:
- Result of the CreateProfile operation returned by the service.
- See Also:
-
createServer
default CreateServerResponse createServer(CreateServerRequest createServerRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, ResourceExistsException, AccessDeniedException, AwsServiceException, SdkClientException, TransferException Instantiates an auto-scaling virtual server based on the selected file transfer protocol in Amazon Web Services. When you make updates to your file transfer protocol-enabled server or when you work with users, use the service-generated
ServerIdproperty that is assigned to the newly created server.- Parameters:
createServerRequest-- Returns:
- Result of the CreateServer operation returned by the service.
- See Also:
-
createServer
default CreateServerResponse createServer(Consumer<CreateServerRequest.Builder> createServerRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, ResourceExistsException, AccessDeniedException, AwsServiceException, SdkClientException, TransferException Instantiates an auto-scaling virtual server based on the selected file transfer protocol in Amazon Web Services. When you make updates to your file transfer protocol-enabled server or when you work with users, use the service-generated
ServerIdproperty that is assigned to the newly created server.
This is a convenience which creates an instance of the
CreateServerRequest.Builderavoiding the need to create one manually viaCreateServerRequest.builder()- Parameters:
createServerRequest- AConsumerthat will call methods onCreateServerRequest.Builderto create a request.- Returns:
- Result of the CreateServer operation returned by the service.
- See Also:
-
createUser
default CreateUserResponse createUser(CreateUserRequest createUserRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, ResourceExistsException, AwsServiceException, SdkClientException, TransferException Creates a user and associates them with an existing file transfer protocol-enabled server. You can only create and associate users with servers that have the
IdentityProviderTypeset toSERVICE_MANAGED. Using parameters forCreateUser, you can specify the user name, set the home directory, store the user's public key, and assign the user's Identity and Access Management (IAM) role. You can also optionally add a session policy, and assign metadata with tags that can be used to group and search for users.- Parameters:
createUserRequest-- Returns:
- Result of the CreateUser operation returned by the service.
- See Also:
-
createUser
default CreateUserResponse createUser(Consumer<CreateUserRequest.Builder> createUserRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, ResourceExistsException, AwsServiceException, SdkClientException, TransferException Creates a user and associates them with an existing file transfer protocol-enabled server. You can only create and associate users with servers that have the
IdentityProviderTypeset toSERVICE_MANAGED. Using parameters forCreateUser, you can specify the user name, set the home directory, store the user's public key, and assign the user's Identity and Access Management (IAM) role. You can also optionally add a session policy, and assign metadata with tags that can be used to group and search for users.
This is a convenience which creates an instance of the
CreateUserRequest.Builderavoiding the need to create one manually viaCreateUserRequest.builder()- Parameters:
createUserRequest- AConsumerthat will call methods onCreateUserRequest.Builderto create a request.- Returns:
- Result of the CreateUser operation returned by the service.
- See Also:
-
createWorkflow
default CreateWorkflowResponse createWorkflow(CreateWorkflowRequest createWorkflowRequest) throws InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, ResourceExistsException, AccessDeniedException, AwsServiceException, SdkClientException, TransferException Allows you to create a workflow with specified steps and step details the workflow invokes after file transfer completes. After creating a workflow, you can associate the workflow created with any transfer servers by specifying the
workflow-detailsfield inCreateServerandUpdateServeroperations.- Parameters:
createWorkflowRequest-- Returns:
- Result of the CreateWorkflow operation returned by the service.
- See Also:
-
createWorkflow
default CreateWorkflowResponse createWorkflow(Consumer<CreateWorkflowRequest.Builder> createWorkflowRequest) throws InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, ResourceExistsException, AccessDeniedException, AwsServiceException, SdkClientException, TransferException Allows you to create a workflow with specified steps and step details the workflow invokes after file transfer completes. After creating a workflow, you can associate the workflow created with any transfer servers by specifying the
workflow-detailsfield inCreateServerandUpdateServeroperations.
This is a convenience which creates an instance of the
CreateWorkflowRequest.Builderavoiding the need to create one manually viaCreateWorkflowRequest.builder()- Parameters:
createWorkflowRequest- AConsumerthat will call methods onCreateWorkflowRequest.Builderto create a request.- Returns:
- Result of the CreateWorkflow operation returned by the service.
- See Also:
-
deleteAccess
default DeleteAccessResponse deleteAccess(DeleteAccessRequest deleteAccessRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Allows you to delete the access specified in the
ServerIDandExternalIDparameters.- Parameters:
deleteAccessRequest-- Returns:
- Result of the DeleteAccess operation returned by the service.
- See Also:
-
deleteAccess
default DeleteAccessResponse deleteAccess(Consumer<DeleteAccessRequest.Builder> deleteAccessRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Allows you to delete the access specified in the
ServerIDandExternalIDparameters.
This is a convenience which creates an instance of the
DeleteAccessRequest.Builderavoiding the need to create one manually viaDeleteAccessRequest.builder()- Parameters:
deleteAccessRequest- AConsumerthat will call methods onDeleteAccessRequest.Builderto create a request.- Returns:
- Result of the DeleteAccess operation returned by the service.
- See Also:
-
deleteAgreement
default DeleteAgreementResponse deleteAgreement(DeleteAgreementRequest deleteAgreementRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Delete the agreement that's specified in the provided
AgreementId.- Parameters:
deleteAgreementRequest-- Returns:
- Result of the DeleteAgreement operation returned by the service.
- See Also:
-
deleteAgreement
default DeleteAgreementResponse deleteAgreement(Consumer<DeleteAgreementRequest.Builder> deleteAgreementRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Delete the agreement that's specified in the provided
AgreementId.
This is a convenience which creates an instance of the
DeleteAgreementRequest.Builderavoiding the need to create one manually viaDeleteAgreementRequest.builder()- Parameters:
deleteAgreementRequest- AConsumerthat will call methods onDeleteAgreementRequest.Builderto create a request.- Returns:
- Result of the DeleteAgreement operation returned by the service.
- See Also:
-
deleteCertificate
default DeleteCertificateResponse deleteCertificate(DeleteCertificateRequest deleteCertificateRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Deletes the certificate that's specified in the
CertificateIdparameter.- Parameters:
deleteCertificateRequest-- Returns:
- Result of the DeleteCertificate operation returned by the service.
- See Also:
-
deleteCertificate
default DeleteCertificateResponse deleteCertificate(Consumer<DeleteCertificateRequest.Builder> deleteCertificateRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Deletes the certificate that's specified in the
CertificateIdparameter.
This is a convenience which creates an instance of the
DeleteCertificateRequest.Builderavoiding the need to create one manually viaDeleteCertificateRequest.builder()- Parameters:
deleteCertificateRequest- AConsumerthat will call methods onDeleteCertificateRequest.Builderto create a request.- Returns:
- Result of the DeleteCertificate operation returned by the service.
- See Also:
-
deleteConnector
default DeleteConnectorResponse deleteConnector(DeleteConnectorRequest deleteConnectorRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Deletes the connector that's specified in the provided
ConnectorId.- Parameters:
deleteConnectorRequest-- Returns:
- Result of the DeleteConnector operation returned by the service.
- See Also:
-
deleteConnector
default DeleteConnectorResponse deleteConnector(Consumer<DeleteConnectorRequest.Builder> deleteConnectorRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Deletes the connector that's specified in the provided
ConnectorId.
This is a convenience which creates an instance of the
DeleteConnectorRequest.Builderavoiding the need to create one manually viaDeleteConnectorRequest.builder()- Parameters:
deleteConnectorRequest- AConsumerthat will call methods onDeleteConnectorRequest.Builderto create a request.- Returns:
- Result of the DeleteConnector operation returned by the service.
- See Also:
-
deleteHostKey
default DeleteHostKeyResponse deleteHostKey(DeleteHostKeyRequest deleteHostKeyRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Deletes the host key that's specified in the
HostKeyIdparameter.- Parameters:
deleteHostKeyRequest-- Returns:
- Result of the DeleteHostKey operation returned by the service.
- See Also:
-
deleteHostKey
default DeleteHostKeyResponse deleteHostKey(Consumer<DeleteHostKeyRequest.Builder> deleteHostKeyRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Deletes the host key that's specified in the
HostKeyIdparameter.
This is a convenience which creates an instance of the
DeleteHostKeyRequest.Builderavoiding the need to create one manually viaDeleteHostKeyRequest.builder()- Parameters:
deleteHostKeyRequest- AConsumerthat will call methods onDeleteHostKeyRequest.Builderto create a request.- Returns:
- Result of the DeleteHostKey operation returned by the service.
- See Also:
-
deleteProfile
default DeleteProfileResponse deleteProfile(DeleteProfileRequest deleteProfileRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Deletes the profile that's specified in the
ProfileIdparameter.- Parameters:
deleteProfileRequest-- Returns:
- Result of the DeleteProfile operation returned by the service.
- See Also:
-
deleteProfile
default DeleteProfileResponse deleteProfile(Consumer<DeleteProfileRequest.Builder> deleteProfileRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Deletes the profile that's specified in the
ProfileIdparameter.
This is a convenience which creates an instance of the
DeleteProfileRequest.Builderavoiding the need to create one manually viaDeleteProfileRequest.builder()- Parameters:
deleteProfileRequest- AConsumerthat will call methods onDeleteProfileRequest.Builderto create a request.- Returns:
- Result of the DeleteProfile operation returned by the service.
- See Also:
-
deleteServer
default DeleteServerResponse deleteServer(DeleteServerRequest deleteServerRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AccessDeniedException, AwsServiceException, SdkClientException, TransferException Deletes the file transfer protocol-enabled server that you specify.
No response returns from this operation.
- Parameters:
deleteServerRequest-- Returns:
- Result of the DeleteServer operation returned by the service.
- See Also:
-
deleteServer
default DeleteServerResponse deleteServer(Consumer<DeleteServerRequest.Builder> deleteServerRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AccessDeniedException, AwsServiceException, SdkClientException, TransferException Deletes the file transfer protocol-enabled server that you specify.
No response returns from this operation.
This is a convenience which creates an instance of the
DeleteServerRequest.Builderavoiding the need to create one manually viaDeleteServerRequest.builder()- Parameters:
deleteServerRequest- AConsumerthat will call methods onDeleteServerRequest.Builderto create a request.- Returns:
- Result of the DeleteServer operation returned by the service.
- See Also:
-
deleteSshPublicKey
default DeleteSshPublicKeyResponse deleteSshPublicKey(DeleteSshPublicKeyRequest deleteSshPublicKeyRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Deletes a user's Secure Shell (SSH) public key.
- Parameters:
deleteSshPublicKeyRequest-- Returns:
- Result of the DeleteSshPublicKey operation returned by the service.
- See Also:
-
deleteSshPublicKey
default DeleteSshPublicKeyResponse deleteSshPublicKey(Consumer<DeleteSshPublicKeyRequest.Builder> deleteSshPublicKeyRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Deletes a user's Secure Shell (SSH) public key.
This is a convenience which creates an instance of the
DeleteSshPublicKeyRequest.Builderavoiding the need to create one manually viaDeleteSshPublicKeyRequest.builder()- Parameters:
deleteSshPublicKeyRequest- AConsumerthat will call methods onDeleteSshPublicKeyRequest.Builderto create a request.- Returns:
- Result of the DeleteSshPublicKey operation returned by the service.
- See Also:
-
deleteUser
default DeleteUserResponse deleteUser(DeleteUserRequest deleteUserRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Deletes the user belonging to a file transfer protocol-enabled server you specify.
No response returns from this operation.
When you delete a user from a server, the user's information is lost.
- Parameters:
deleteUserRequest-- Returns:
- Result of the DeleteUser operation returned by the service.
- See Also:
-
deleteUser
default DeleteUserResponse deleteUser(Consumer<DeleteUserRequest.Builder> deleteUserRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Deletes the user belonging to a file transfer protocol-enabled server you specify.
No response returns from this operation.
When you delete a user from a server, the user's information is lost.
This is a convenience which creates an instance of the
DeleteUserRequest.Builderavoiding the need to create one manually viaDeleteUserRequest.builder()- Parameters:
deleteUserRequest- AConsumerthat will call methods onDeleteUserRequest.Builderto create a request.- Returns:
- Result of the DeleteUser operation returned by the service.
- See Also:
-
deleteWorkflow
default DeleteWorkflowResponse deleteWorkflow(DeleteWorkflowRequest deleteWorkflowRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AccessDeniedException, AwsServiceException, SdkClientException, TransferException Deletes the specified workflow.
- Parameters:
deleteWorkflowRequest-- Returns:
- Result of the DeleteWorkflow operation returned by the service.
- See Also:
-
deleteWorkflow
default DeleteWorkflowResponse deleteWorkflow(Consumer<DeleteWorkflowRequest.Builder> deleteWorkflowRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AccessDeniedException, AwsServiceException, SdkClientException, TransferException Deletes the specified workflow.
This is a convenience which creates an instance of the
DeleteWorkflowRequest.Builderavoiding the need to create one manually viaDeleteWorkflowRequest.builder()- Parameters:
deleteWorkflowRequest- AConsumerthat will call methods onDeleteWorkflowRequest.Builderto create a request.- Returns:
- Result of the DeleteWorkflow operation returned by the service.
- See Also:
-
describeAccess
default DescribeAccessResponse describeAccess(DescribeAccessRequest describeAccessRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Describes the access that is assigned to the specific file transfer protocol-enabled server, as identified by its
ServerIdproperty and itsExternalId.The response from this call returns the properties of the access that is associated with the
ServerIdvalue that was specified.- Parameters:
describeAccessRequest-- Returns:
- Result of the DescribeAccess operation returned by the service.
- See Also:
-
describeAccess
default DescribeAccessResponse describeAccess(Consumer<DescribeAccessRequest.Builder> describeAccessRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Describes the access that is assigned to the specific file transfer protocol-enabled server, as identified by its
ServerIdproperty and itsExternalId.The response from this call returns the properties of the access that is associated with the
ServerIdvalue that was specified.
This is a convenience which creates an instance of the
DescribeAccessRequest.Builderavoiding the need to create one manually viaDescribeAccessRequest.builder()- Parameters:
describeAccessRequest- AConsumerthat will call methods onDescribeAccessRequest.Builderto create a request.- Returns:
- Result of the DescribeAccess operation returned by the service.
- See Also:
-
describeAgreement
default DescribeAgreementResponse describeAgreement(DescribeAgreementRequest describeAgreementRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Describes the agreement that's identified by the
AgreementId.- Parameters:
describeAgreementRequest-- Returns:
- Result of the DescribeAgreement operation returned by the service.
- See Also:
-
describeAgreement
default DescribeAgreementResponse describeAgreement(Consumer<DescribeAgreementRequest.Builder> describeAgreementRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Describes the agreement that's identified by the
AgreementId.
This is a convenience which creates an instance of the
DescribeAgreementRequest.Builderavoiding the need to create one manually viaDescribeAgreementRequest.builder()- Parameters:
describeAgreementRequest- AConsumerthat will call methods onDescribeAgreementRequest.Builderto create a request.- Returns:
- Result of the DescribeAgreement operation returned by the service.
- See Also:
-
describeCertificate
default DescribeCertificateResponse describeCertificate(DescribeCertificateRequest describeCertificateRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Describes the certificate that's identified by the
CertificateId.- Parameters:
describeCertificateRequest-- Returns:
- Result of the DescribeCertificate operation returned by the service.
- See Also:
-
describeCertificate
default DescribeCertificateResponse describeCertificate(Consumer<DescribeCertificateRequest.Builder> describeCertificateRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Describes the certificate that's identified by the
CertificateId.
This is a convenience which creates an instance of the
DescribeCertificateRequest.Builderavoiding the need to create one manually viaDescribeCertificateRequest.builder()- Parameters:
describeCertificateRequest- AConsumerthat will call methods onDescribeCertificateRequest.Builderto create a request.- Returns:
- Result of the DescribeCertificate operation returned by the service.
- See Also:
-
describeConnector
default DescribeConnectorResponse describeConnector(DescribeConnectorRequest describeConnectorRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Describes the connector that's identified by the
ConnectorId.- Parameters:
describeConnectorRequest-- Returns:
- Result of the DescribeConnector operation returned by the service.
- See Also:
-
describeConnector
default DescribeConnectorResponse describeConnector(Consumer<DescribeConnectorRequest.Builder> describeConnectorRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Describes the connector that's identified by the
ConnectorId.
This is a convenience which creates an instance of the
DescribeConnectorRequest.Builderavoiding the need to create one manually viaDescribeConnectorRequest.builder()- Parameters:
describeConnectorRequest- AConsumerthat will call methods onDescribeConnectorRequest.Builderto create a request.- Returns:
- Result of the DescribeConnector operation returned by the service.
- See Also:
-
describeExecution
default DescribeExecutionResponse describeExecution(DescribeExecutionRequest describeExecutionRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException You can use
DescribeExecutionto check the details of the execution of the specified workflow.This API call only returns details for in-progress workflows.
If you provide an ID for an execution that is not in progress, or if the execution doesn't match the specified workflow ID, you receive a
ResourceNotFoundexception.- Parameters:
describeExecutionRequest-- Returns:
- Result of the DescribeExecution operation returned by the service.
- See Also:
-
describeExecution
default DescribeExecutionResponse describeExecution(Consumer<DescribeExecutionRequest.Builder> describeExecutionRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException You can use
DescribeExecutionto check the details of the execution of the specified workflow.This API call only returns details for in-progress workflows.
If you provide an ID for an execution that is not in progress, or if the execution doesn't match the specified workflow ID, you receive a
ResourceNotFoundexception.
This is a convenience which creates an instance of the
DescribeExecutionRequest.Builderavoiding the need to create one manually viaDescribeExecutionRequest.builder()- Parameters:
describeExecutionRequest- AConsumerthat will call methods onDescribeExecutionRequest.Builderto create a request.- Returns:
- Result of the DescribeExecution operation returned by the service.
- See Also:
-
describeHostKey
default DescribeHostKeyResponse describeHostKey(DescribeHostKeyRequest describeHostKeyRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Returns the details of the host key that's specified by the
HostKeyIdandServerId.- Parameters:
describeHostKeyRequest-- Returns:
- Result of the DescribeHostKey operation returned by the service.
- See Also:
-
describeHostKey
default DescribeHostKeyResponse describeHostKey(Consumer<DescribeHostKeyRequest.Builder> describeHostKeyRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Returns the details of the host key that's specified by the
HostKeyIdandServerId.
This is a convenience which creates an instance of the
DescribeHostKeyRequest.Builderavoiding the need to create one manually viaDescribeHostKeyRequest.builder()- Parameters:
describeHostKeyRequest- AConsumerthat will call methods onDescribeHostKeyRequest.Builderto create a request.- Returns:
- Result of the DescribeHostKey operation returned by the service.
- See Also:
-
describeProfile
default DescribeProfileResponse describeProfile(DescribeProfileRequest describeProfileRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Returns the details of the profile that's specified by the
ProfileId.- Parameters:
describeProfileRequest-- Returns:
- Result of the DescribeProfile operation returned by the service.
- See Also:
-
describeProfile
default DescribeProfileResponse describeProfile(Consumer<DescribeProfileRequest.Builder> describeProfileRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Returns the details of the profile that's specified by the
ProfileId.
This is a convenience which creates an instance of the
DescribeProfileRequest.Builderavoiding the need to create one manually viaDescribeProfileRequest.builder()- Parameters:
describeProfileRequest- AConsumerthat will call methods onDescribeProfileRequest.Builderto create a request.- Returns:
- Result of the DescribeProfile operation returned by the service.
- See Also:
-
describeSecurityPolicy
default DescribeSecurityPolicyResponse describeSecurityPolicy(DescribeSecurityPolicyRequest describeSecurityPolicyRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Describes the security policy that is attached to your server or SFTP connector. The response contains a description of the security policy's properties. For more information about security policies, see Working with security policies for servers or Working with security policies for SFTP connectors.
- Parameters:
describeSecurityPolicyRequest-- Returns:
- Result of the DescribeSecurityPolicy operation returned by the service.
- See Also:
-
describeSecurityPolicy
default DescribeSecurityPolicyResponse describeSecurityPolicy(Consumer<DescribeSecurityPolicyRequest.Builder> describeSecurityPolicyRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Describes the security policy that is attached to your server or SFTP connector. The response contains a description of the security policy's properties. For more information about security policies, see Working with security policies for servers or Working with security policies for SFTP connectors.
This is a convenience which creates an instance of the
DescribeSecurityPolicyRequest.Builderavoiding the need to create one manually viaDescribeSecurityPolicyRequest.builder()- Parameters:
describeSecurityPolicyRequest- AConsumerthat will call methods onDescribeSecurityPolicyRequest.Builderto create a request.- Returns:
- Result of the DescribeSecurityPolicy operation returned by the service.
- See Also:
-
describeServer
default DescribeServerResponse describeServer(DescribeServerRequest describeServerRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Describes a file transfer protocol-enabled server that you specify by passing the
ServerIdparameter.The response contains a description of a server's properties. When you set
EndpointTypeto VPC, the response will contain theEndpointDetails.- Parameters:
describeServerRequest-- Returns:
- Result of the DescribeServer operation returned by the service.
- See Also:
-
describeServer
default DescribeServerResponse describeServer(Consumer<DescribeServerRequest.Builder> describeServerRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Describes a file transfer protocol-enabled server that you specify by passing the
ServerIdparameter.The response contains a description of a server's properties. When you set
EndpointTypeto VPC, the response will contain theEndpointDetails.
This is a convenience which creates an instance of the
DescribeServerRequest.Builderavoiding the need to create one manually viaDescribeServerRequest.builder()- Parameters:
describeServerRequest- AConsumerthat will call methods onDescribeServerRequest.Builderto create a request.- Returns:
- Result of the DescribeServer operation returned by the service.
- See Also:
-
describeUser
default DescribeUserResponse describeUser(DescribeUserRequest describeUserRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Describes the user assigned to the specific file transfer protocol-enabled server, as identified by its
ServerIdproperty.The response from this call returns the properties of the user associated with the
ServerIdvalue that was specified.- Parameters:
describeUserRequest-- Returns:
- Result of the DescribeUser operation returned by the service.
- See Also:
-
describeUser
default DescribeUserResponse describeUser(Consumer<DescribeUserRequest.Builder> describeUserRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Describes the user assigned to the specific file transfer protocol-enabled server, as identified by its
ServerIdproperty.The response from this call returns the properties of the user associated with the
ServerIdvalue that was specified.
This is a convenience which creates an instance of the
DescribeUserRequest.Builderavoiding the need to create one manually viaDescribeUserRequest.builder()- Parameters:
describeUserRequest- AConsumerthat will call methods onDescribeUserRequest.Builderto create a request.- Returns:
- Result of the DescribeUser operation returned by the service.
- See Also:
-
describeWorkflow
default DescribeWorkflowResponse describeWorkflow(DescribeWorkflowRequest describeWorkflowRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Describes the specified workflow.
- Parameters:
describeWorkflowRequest-- Returns:
- Result of the DescribeWorkflow operation returned by the service.
- See Also:
-
describeWorkflow
default DescribeWorkflowResponse describeWorkflow(Consumer<DescribeWorkflowRequest.Builder> describeWorkflowRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Describes the specified workflow.
This is a convenience which creates an instance of the
DescribeWorkflowRequest.Builderavoiding the need to create one manually viaDescribeWorkflowRequest.builder()- Parameters:
describeWorkflowRequest- AConsumerthat will call methods onDescribeWorkflowRequest.Builderto create a request.- Returns:
- Result of the DescribeWorkflow operation returned by the service.
- See Also:
-
importCertificate
default ImportCertificateResponse importCertificate(ImportCertificateRequest importCertificateRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Imports the signing and encryption certificates that you need to create local (AS2) profiles and partner profiles.
- Parameters:
importCertificateRequest-- Returns:
- Result of the ImportCertificate operation returned by the service.
- See Also:
-
importCertificate
default ImportCertificateResponse importCertificate(Consumer<ImportCertificateRequest.Builder> importCertificateRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Imports the signing and encryption certificates that you need to create local (AS2) profiles and partner profiles.
This is a convenience which creates an instance of the
ImportCertificateRequest.Builderavoiding the need to create one manually viaImportCertificateRequest.builder()- Parameters:
importCertificateRequest- AConsumerthat will call methods onImportCertificateRequest.Builderto create a request.- Returns:
- Result of the ImportCertificate operation returned by the service.
- See Also:
-
importHostKey
default ImportHostKeyResponse importHostKey(ImportHostKeyRequest importHostKeyRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, ResourceExistsException, AwsServiceException, SdkClientException, TransferException Adds a host key to the server that's specified by the
ServerIdparameter.- Parameters:
importHostKeyRequest-- Returns:
- Result of the ImportHostKey operation returned by the service.
- See Also:
-
importHostKey
default ImportHostKeyResponse importHostKey(Consumer<ImportHostKeyRequest.Builder> importHostKeyRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, ResourceExistsException, AwsServiceException, SdkClientException, TransferException Adds a host key to the server that's specified by the
ServerIdparameter.
This is a convenience which creates an instance of the
ImportHostKeyRequest.Builderavoiding the need to create one manually viaImportHostKeyRequest.builder()- Parameters:
importHostKeyRequest- AConsumerthat will call methods onImportHostKeyRequest.Builderto create a request.- Returns:
- Result of the ImportHostKey operation returned by the service.
- See Also:
-
importSshPublicKey
default ImportSshPublicKeyResponse importSshPublicKey(ImportSshPublicKeyRequest importSshPublicKeyRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, ResourceExistsException, AwsServiceException, SdkClientException, TransferException Adds a Secure Shell (SSH) public key to a Transfer Family user identified by a
UserNamevalue assigned to the specific file transfer protocol-enabled server, identified byServerId.The response returns the
UserNamevalue, theServerIdvalue, and the name of theSshPublicKeyId.- Parameters:
importSshPublicKeyRequest-- Returns:
- Result of the ImportSshPublicKey operation returned by the service.
- See Also:
-
importSshPublicKey
default ImportSshPublicKeyResponse importSshPublicKey(Consumer<ImportSshPublicKeyRequest.Builder> importSshPublicKeyRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, ResourceExistsException, AwsServiceException, SdkClientException, TransferException Adds a Secure Shell (SSH) public key to a Transfer Family user identified by a
UserNamevalue assigned to the specific file transfer protocol-enabled server, identified byServerId.The response returns the
UserNamevalue, theServerIdvalue, and the name of theSshPublicKeyId.
This is a convenience which creates an instance of the
ImportSshPublicKeyRequest.Builderavoiding the need to create one manually viaImportSshPublicKeyRequest.builder()- Parameters:
importSshPublicKeyRequest- AConsumerthat will call methods onImportSshPublicKeyRequest.Builderto create a request.- Returns:
- Result of the ImportSshPublicKey operation returned by the service.
- See Also:
-
listAccesses
default ListAccessesResponse listAccesses(ListAccessesRequest listAccessesRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException Lists the details for all the accesses you have on your server.
- Parameters:
listAccessesRequest-- Returns:
- Result of the ListAccesses operation returned by the service.
- See Also:
-
listAccesses
default ListAccessesResponse listAccesses(Consumer<ListAccessesRequest.Builder> listAccessesRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException Lists the details for all the accesses you have on your server.
This is a convenience which creates an instance of the
ListAccessesRequest.Builderavoiding the need to create one manually viaListAccessesRequest.builder()- Parameters:
listAccessesRequest- AConsumerthat will call methods onListAccessesRequest.Builderto create a request.- Returns:
- Result of the ListAccesses operation returned by the service.
- See Also:
-
listAccessesPaginator
default ListAccessesIterable listAccessesPaginator(ListAccessesRequest listAccessesRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException This is a variant of
listAccesses(software.amazon.awssdk.services.transfer.model.ListAccessesRequest)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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListAccessesIterable responses = client.listAccessesPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListAccessesIterable responses = client.listAccessesPaginator(request); for (software.amazon.awssdk.services.transfer.model.ListAccessesResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListAccessesIterable responses = client.listAccessesPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listAccesses(software.amazon.awssdk.services.transfer.model.ListAccessesRequest)operation.- Parameters:
listAccessesRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listAccessesPaginator
default ListAccessesIterable listAccessesPaginator(Consumer<ListAccessesRequest.Builder> listAccessesRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException This is a variant of
listAccesses(software.amazon.awssdk.services.transfer.model.ListAccessesRequest)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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListAccessesIterable responses = client.listAccessesPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListAccessesIterable responses = client.listAccessesPaginator(request); for (software.amazon.awssdk.services.transfer.model.ListAccessesResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListAccessesIterable responses = client.listAccessesPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listAccesses(software.amazon.awssdk.services.transfer.model.ListAccessesRequest)operation.
This is a convenience which creates an instance of the
ListAccessesRequest.Builderavoiding the need to create one manually viaListAccessesRequest.builder()- Parameters:
listAccessesRequest- AConsumerthat will call methods onListAccessesRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listAgreements
default ListAgreementsResponse listAgreements(ListAgreementsRequest listAgreementsRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException Returns a list of the agreements for the server that's identified by the
ServerIdthat you supply. If you want to limit the results to a certain number, supply a value for theMaxResultsparameter. If you ran the command previously and received a value forNextToken, you can supply that value to continue listing agreements from where you left off.- Parameters:
listAgreementsRequest-- Returns:
- Result of the ListAgreements operation returned by the service.
- See Also:
-
listAgreements
default ListAgreementsResponse listAgreements(Consumer<ListAgreementsRequest.Builder> listAgreementsRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException Returns a list of the agreements for the server that's identified by the
ServerIdthat you supply. If you want to limit the results to a certain number, supply a value for theMaxResultsparameter. If you ran the command previously and received a value forNextToken, you can supply that value to continue listing agreements from where you left off.
This is a convenience which creates an instance of the
ListAgreementsRequest.Builderavoiding the need to create one manually viaListAgreementsRequest.builder()- Parameters:
listAgreementsRequest- AConsumerthat will call methods onListAgreementsRequest.Builderto create a request.- Returns:
- Result of the ListAgreements operation returned by the service.
- See Also:
-
listAgreementsPaginator
default ListAgreementsIterable listAgreementsPaginator(ListAgreementsRequest listAgreementsRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException This is a variant of
listAgreements(software.amazon.awssdk.services.transfer.model.ListAgreementsRequest)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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListAgreementsIterable responses = client.listAgreementsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListAgreementsIterable responses = client .listAgreementsPaginator(request); for (software.amazon.awssdk.services.transfer.model.ListAgreementsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListAgreementsIterable responses = client.listAgreementsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listAgreements(software.amazon.awssdk.services.transfer.model.ListAgreementsRequest)operation.- Parameters:
listAgreementsRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listAgreementsPaginator
default ListAgreementsIterable listAgreementsPaginator(Consumer<ListAgreementsRequest.Builder> listAgreementsRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException This is a variant of
listAgreements(software.amazon.awssdk.services.transfer.model.ListAgreementsRequest)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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListAgreementsIterable responses = client.listAgreementsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListAgreementsIterable responses = client .listAgreementsPaginator(request); for (software.amazon.awssdk.services.transfer.model.ListAgreementsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListAgreementsIterable responses = client.listAgreementsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listAgreements(software.amazon.awssdk.services.transfer.model.ListAgreementsRequest)operation.
This is a convenience which creates an instance of the
ListAgreementsRequest.Builderavoiding the need to create one manually viaListAgreementsRequest.builder()- Parameters:
listAgreementsRequest- AConsumerthat will call methods onListAgreementsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listCertificates
default ListCertificatesResponse listCertificates(ListCertificatesRequest listCertificatesRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException Returns a list of the current certificates that have been imported into Transfer Family. If you want to limit the results to a certain number, supply a value for the
MaxResultsparameter. If you ran the command previously and received a value for theNextTokenparameter, you can supply that value to continue listing certificates from where you left off.- Parameters:
listCertificatesRequest-- Returns:
- Result of the ListCertificates operation returned by the service.
- See Also:
-
listCertificates
default ListCertificatesResponse listCertificates(Consumer<ListCertificatesRequest.Builder> listCertificatesRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException Returns a list of the current certificates that have been imported into Transfer Family. If you want to limit the results to a certain number, supply a value for the
MaxResultsparameter. If you ran the command previously and received a value for theNextTokenparameter, you can supply that value to continue listing certificates from where you left off.
This is a convenience which creates an instance of the
ListCertificatesRequest.Builderavoiding the need to create one manually viaListCertificatesRequest.builder()- Parameters:
listCertificatesRequest- AConsumerthat will call methods onListCertificatesRequest.Builderto create a request.- Returns:
- Result of the ListCertificates operation returned by the service.
- See Also:
-
listCertificatesPaginator
default ListCertificatesIterable listCertificatesPaginator(ListCertificatesRequest listCertificatesRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException This is a variant of
listCertificates(software.amazon.awssdk.services.transfer.model.ListCertificatesRequest)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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListCertificatesIterable responses = client.listCertificatesPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListCertificatesIterable responses = client .listCertificatesPaginator(request); for (software.amazon.awssdk.services.transfer.model.ListCertificatesResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListCertificatesIterable responses = client.listCertificatesPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listCertificates(software.amazon.awssdk.services.transfer.model.ListCertificatesRequest)operation.- Parameters:
listCertificatesRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listCertificatesPaginator
default ListCertificatesIterable listCertificatesPaginator(Consumer<ListCertificatesRequest.Builder> listCertificatesRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException This is a variant of
listCertificates(software.amazon.awssdk.services.transfer.model.ListCertificatesRequest)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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListCertificatesIterable responses = client.listCertificatesPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListCertificatesIterable responses = client .listCertificatesPaginator(request); for (software.amazon.awssdk.services.transfer.model.ListCertificatesResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListCertificatesIterable responses = client.listCertificatesPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listCertificates(software.amazon.awssdk.services.transfer.model.ListCertificatesRequest)operation.
This is a convenience which creates an instance of the
ListCertificatesRequest.Builderavoiding the need to create one manually viaListCertificatesRequest.builder()- Parameters:
listCertificatesRequest- AConsumerthat will call methods onListCertificatesRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listConnectors
default ListConnectorsResponse listConnectors(ListConnectorsRequest listConnectorsRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException Lists the connectors for the specified Region.
- Parameters:
listConnectorsRequest-- Returns:
- Result of the ListConnectors operation returned by the service.
- See Also:
-
listConnectors
default ListConnectorsResponse listConnectors(Consumer<ListConnectorsRequest.Builder> listConnectorsRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException Lists the connectors for the specified Region.
This is a convenience which creates an instance of the
ListConnectorsRequest.Builderavoiding the need to create one manually viaListConnectorsRequest.builder()- Parameters:
listConnectorsRequest- AConsumerthat will call methods onListConnectorsRequest.Builderto create a request.- Returns:
- Result of the ListConnectors operation returned by the service.
- See Also:
-
listConnectorsPaginator
default ListConnectorsIterable listConnectorsPaginator(ListConnectorsRequest listConnectorsRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException This is a variant of
listConnectors(software.amazon.awssdk.services.transfer.model.ListConnectorsRequest)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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListConnectorsIterable responses = client.listConnectorsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListConnectorsIterable responses = client .listConnectorsPaginator(request); for (software.amazon.awssdk.services.transfer.model.ListConnectorsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListConnectorsIterable responses = client.listConnectorsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listConnectors(software.amazon.awssdk.services.transfer.model.ListConnectorsRequest)operation.- Parameters:
listConnectorsRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listConnectorsPaginator
default ListConnectorsIterable listConnectorsPaginator(Consumer<ListConnectorsRequest.Builder> listConnectorsRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException This is a variant of
listConnectors(software.amazon.awssdk.services.transfer.model.ListConnectorsRequest)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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListConnectorsIterable responses = client.listConnectorsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListConnectorsIterable responses = client .listConnectorsPaginator(request); for (software.amazon.awssdk.services.transfer.model.ListConnectorsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListConnectorsIterable responses = client.listConnectorsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listConnectors(software.amazon.awssdk.services.transfer.model.ListConnectorsRequest)operation.
This is a convenience which creates an instance of the
ListConnectorsRequest.Builderavoiding the need to create one manually viaListConnectorsRequest.builder()- Parameters:
listConnectorsRequest- AConsumerthat will call methods onListConnectorsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listExecutions
default ListExecutionsResponse listExecutions(ListExecutionsRequest listExecutionsRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException Lists all in-progress executions for the specified workflow.
If the specified workflow ID cannot be found,
ListExecutionsreturns aResourceNotFoundexception.- Parameters:
listExecutionsRequest-- Returns:
- Result of the ListExecutions operation returned by the service.
- See Also:
-
listExecutions
default ListExecutionsResponse listExecutions(Consumer<ListExecutionsRequest.Builder> listExecutionsRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException Lists all in-progress executions for the specified workflow.
If the specified workflow ID cannot be found,
ListExecutionsreturns aResourceNotFoundexception.
This is a convenience which creates an instance of the
ListExecutionsRequest.Builderavoiding the need to create one manually viaListExecutionsRequest.builder()- Parameters:
listExecutionsRequest- AConsumerthat will call methods onListExecutionsRequest.Builderto create a request.- Returns:
- Result of the ListExecutions operation returned by the service.
- See Also:
-
listExecutionsPaginator
default ListExecutionsIterable listExecutionsPaginator(ListExecutionsRequest listExecutionsRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException This is a variant of
listExecutions(software.amazon.awssdk.services.transfer.model.ListExecutionsRequest)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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListExecutionsIterable responses = client.listExecutionsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListExecutionsIterable responses = client .listExecutionsPaginator(request); for (software.amazon.awssdk.services.transfer.model.ListExecutionsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListExecutionsIterable responses = client.listExecutionsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listExecutions(software.amazon.awssdk.services.transfer.model.ListExecutionsRequest)operation.- Parameters:
listExecutionsRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listExecutionsPaginator
default ListExecutionsIterable listExecutionsPaginator(Consumer<ListExecutionsRequest.Builder> listExecutionsRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException This is a variant of
listExecutions(software.amazon.awssdk.services.transfer.model.ListExecutionsRequest)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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListExecutionsIterable responses = client.listExecutionsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListExecutionsIterable responses = client .listExecutionsPaginator(request); for (software.amazon.awssdk.services.transfer.model.ListExecutionsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListExecutionsIterable responses = client.listExecutionsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listExecutions(software.amazon.awssdk.services.transfer.model.ListExecutionsRequest)operation.
This is a convenience which creates an instance of the
ListExecutionsRequest.Builderavoiding the need to create one manually viaListExecutionsRequest.builder()- Parameters:
listExecutionsRequest- AConsumerthat will call methods onListExecutionsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listFileTransferResults
default ListFileTransferResultsResponse listFileTransferResults(ListFileTransferResultsRequest listFileTransferResultsRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Returns real-time updates and detailed information on the status of each individual file being transferred in a specific file transfer operation. You specify the file transfer by providing its
ConnectorIdand itsTransferId.File transfer results are available up to 7 days after an operation has been requested.
- Parameters:
listFileTransferResultsRequest-- Returns:
- Result of the ListFileTransferResults operation returned by the service.
- See Also:
-
listFileTransferResults
default ListFileTransferResultsResponse listFileTransferResults(Consumer<ListFileTransferResultsRequest.Builder> listFileTransferResultsRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Returns real-time updates and detailed information on the status of each individual file being transferred in a specific file transfer operation. You specify the file transfer by providing its
ConnectorIdand itsTransferId.File transfer results are available up to 7 days after an operation has been requested.
This is a convenience which creates an instance of the
ListFileTransferResultsRequest.Builderavoiding the need to create one manually viaListFileTransferResultsRequest.builder()- Parameters:
listFileTransferResultsRequest- AConsumerthat will call methods onListFileTransferResultsRequest.Builderto create a request.- Returns:
- Result of the ListFileTransferResults operation returned by the service.
- See Also:
-
listFileTransferResultsPaginator
default ListFileTransferResultsIterable listFileTransferResultsPaginator(ListFileTransferResultsRequest listFileTransferResultsRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException This is a variant of
listFileTransferResults(software.amazon.awssdk.services.transfer.model.ListFileTransferResultsRequest)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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListFileTransferResultsIterable responses = client.listFileTransferResultsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListFileTransferResultsIterable responses = client .listFileTransferResultsPaginator(request); for (software.amazon.awssdk.services.transfer.model.ListFileTransferResultsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListFileTransferResultsIterable responses = client.listFileTransferResultsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listFileTransferResults(software.amazon.awssdk.services.transfer.model.ListFileTransferResultsRequest)operation.- Parameters:
listFileTransferResultsRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listFileTransferResultsPaginator
default ListFileTransferResultsIterable listFileTransferResultsPaginator(Consumer<ListFileTransferResultsRequest.Builder> listFileTransferResultsRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException This is a variant of
listFileTransferResults(software.amazon.awssdk.services.transfer.model.ListFileTransferResultsRequest)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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListFileTransferResultsIterable responses = client.listFileTransferResultsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListFileTransferResultsIterable responses = client .listFileTransferResultsPaginator(request); for (software.amazon.awssdk.services.transfer.model.ListFileTransferResultsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListFileTransferResultsIterable responses = client.listFileTransferResultsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listFileTransferResults(software.amazon.awssdk.services.transfer.model.ListFileTransferResultsRequest)operation.
This is a convenience which creates an instance of the
ListFileTransferResultsRequest.Builderavoiding the need to create one manually viaListFileTransferResultsRequest.builder()- Parameters:
listFileTransferResultsRequest- AConsumerthat will call methods onListFileTransferResultsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listHostKeys
default ListHostKeysResponse listHostKeys(ListHostKeysRequest listHostKeysRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException Returns a list of host keys for the server that's specified by the
ServerIdparameter.- Parameters:
listHostKeysRequest-- Returns:
- Result of the ListHostKeys operation returned by the service.
- See Also:
-
listHostKeys
default ListHostKeysResponse listHostKeys(Consumer<ListHostKeysRequest.Builder> listHostKeysRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException Returns a list of host keys for the server that's specified by the
ServerIdparameter.
This is a convenience which creates an instance of the
ListHostKeysRequest.Builderavoiding the need to create one manually viaListHostKeysRequest.builder()- Parameters:
listHostKeysRequest- AConsumerthat will call methods onListHostKeysRequest.Builderto create a request.- Returns:
- Result of the ListHostKeys operation returned by the service.
- See Also:
-
listProfiles
default ListProfilesResponse listProfiles(ListProfilesRequest listProfilesRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException Returns a list of the profiles for your system. If you want to limit the results to a certain number, supply a value for the
MaxResultsparameter. If you ran the command previously and received a value forNextToken, you can supply that value to continue listing profiles from where you left off.- Parameters:
listProfilesRequest-- Returns:
- Result of the ListProfiles operation returned by the service.
- See Also:
-
listProfiles
default ListProfilesResponse listProfiles(Consumer<ListProfilesRequest.Builder> listProfilesRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException Returns a list of the profiles for your system. If you want to limit the results to a certain number, supply a value for the
MaxResultsparameter. If you ran the command previously and received a value forNextToken, you can supply that value to continue listing profiles from where you left off.
This is a convenience which creates an instance of the
ListProfilesRequest.Builderavoiding the need to create one manually viaListProfilesRequest.builder()- Parameters:
listProfilesRequest- AConsumerthat will call methods onListProfilesRequest.Builderto create a request.- Returns:
- Result of the ListProfiles operation returned by the service.
- See Also:
-
listProfilesPaginator
default ListProfilesIterable listProfilesPaginator(ListProfilesRequest listProfilesRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException This is a variant of
listProfiles(software.amazon.awssdk.services.transfer.model.ListProfilesRequest)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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListProfilesIterable responses = client.listProfilesPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListProfilesIterable responses = client.listProfilesPaginator(request); for (software.amazon.awssdk.services.transfer.model.ListProfilesResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListProfilesIterable responses = client.listProfilesPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listProfiles(software.amazon.awssdk.services.transfer.model.ListProfilesRequest)operation.- Parameters:
listProfilesRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listProfilesPaginator
default ListProfilesIterable listProfilesPaginator(Consumer<ListProfilesRequest.Builder> listProfilesRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException This is a variant of
listProfiles(software.amazon.awssdk.services.transfer.model.ListProfilesRequest)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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListProfilesIterable responses = client.listProfilesPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListProfilesIterable responses = client.listProfilesPaginator(request); for (software.amazon.awssdk.services.transfer.model.ListProfilesResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListProfilesIterable responses = client.listProfilesPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listProfiles(software.amazon.awssdk.services.transfer.model.ListProfilesRequest)operation.
This is a convenience which creates an instance of the
ListProfilesRequest.Builderavoiding the need to create one manually viaListProfilesRequest.builder()- Parameters:
listProfilesRequest- AConsumerthat will call methods onListProfilesRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listSecurityPolicies
default ListSecurityPoliciesResponse listSecurityPolicies(ListSecurityPoliciesRequest listSecurityPoliciesRequest) throws InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException Lists the security policies that are attached to your servers and SFTP connectors. For more information about security policies, see Working with security policies for servers or Working with security policies for SFTP connectors.
- Parameters:
listSecurityPoliciesRequest-- Returns:
- Result of the ListSecurityPolicies operation returned by the service.
- See Also:
-
listSecurityPolicies
default ListSecurityPoliciesResponse listSecurityPolicies(Consumer<ListSecurityPoliciesRequest.Builder> listSecurityPoliciesRequest) throws InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException Lists the security policies that are attached to your servers and SFTP connectors. For more information about security policies, see Working with security policies for servers or Working with security policies for SFTP connectors.
This is a convenience which creates an instance of the
ListSecurityPoliciesRequest.Builderavoiding the need to create one manually viaListSecurityPoliciesRequest.builder()- Parameters:
listSecurityPoliciesRequest- AConsumerthat will call methods onListSecurityPoliciesRequest.Builderto create a request.- Returns:
- Result of the ListSecurityPolicies operation returned by the service.
- See Also:
-
listSecurityPoliciesPaginator
default ListSecurityPoliciesIterable listSecurityPoliciesPaginator(ListSecurityPoliciesRequest listSecurityPoliciesRequest) throws InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException This is a variant of
listSecurityPolicies(software.amazon.awssdk.services.transfer.model.ListSecurityPoliciesRequest)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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListSecurityPoliciesIterable responses = client.listSecurityPoliciesPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListSecurityPoliciesIterable responses = client .listSecurityPoliciesPaginator(request); for (software.amazon.awssdk.services.transfer.model.ListSecurityPoliciesResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListSecurityPoliciesIterable responses = client.listSecurityPoliciesPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listSecurityPolicies(software.amazon.awssdk.services.transfer.model.ListSecurityPoliciesRequest)operation.- Parameters:
listSecurityPoliciesRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listSecurityPoliciesPaginator
default ListSecurityPoliciesIterable listSecurityPoliciesPaginator(Consumer<ListSecurityPoliciesRequest.Builder> listSecurityPoliciesRequest) throws InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException This is a variant of
listSecurityPolicies(software.amazon.awssdk.services.transfer.model.ListSecurityPoliciesRequest)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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListSecurityPoliciesIterable responses = client.listSecurityPoliciesPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListSecurityPoliciesIterable responses = client .listSecurityPoliciesPaginator(request); for (software.amazon.awssdk.services.transfer.model.ListSecurityPoliciesResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListSecurityPoliciesIterable responses = client.listSecurityPoliciesPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listSecurityPolicies(software.amazon.awssdk.services.transfer.model.ListSecurityPoliciesRequest)operation.
This is a convenience which creates an instance of the
ListSecurityPoliciesRequest.Builderavoiding the need to create one manually viaListSecurityPoliciesRequest.builder()- Parameters:
listSecurityPoliciesRequest- AConsumerthat will call methods onListSecurityPoliciesRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listServers
default ListServersResponse listServers(ListServersRequest listServersRequest) throws InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException Lists the file transfer protocol-enabled servers that are associated with your Amazon Web Services account.
- Parameters:
listServersRequest-- Returns:
- Result of the ListServers operation returned by the service.
- See Also:
-
listServers
default ListServersResponse listServers(Consumer<ListServersRequest.Builder> listServersRequest) throws InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException Lists the file transfer protocol-enabled servers that are associated with your Amazon Web Services account.
This is a convenience which creates an instance of the
ListServersRequest.Builderavoiding the need to create one manually viaListServersRequest.builder()- Parameters:
listServersRequest- AConsumerthat will call methods onListServersRequest.Builderto create a request.- Returns:
- Result of the ListServers operation returned by the service.
- See Also:
-
listServers
default ListServersResponse listServers() throws InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferExceptionLists the file transfer protocol-enabled servers that are associated with your Amazon Web Services account.
- Returns:
- Result of the ListServers operation returned by the service.
- See Also:
-
listServersPaginator
default ListServersIterable listServersPaginator() throws InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferExceptionThis is a variant of
listServers(software.amazon.awssdk.services.transfer.model.ListServersRequest)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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListServersIterable responses = client.listServersPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListServersIterable responses = client.listServersPaginator(request); for (software.amazon.awssdk.services.transfer.model.ListServersResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListServersIterable responses = client.listServersPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listServers(software.amazon.awssdk.services.transfer.model.ListServersRequest)operation.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listServersPaginator
default ListServersIterable listServersPaginator(ListServersRequest listServersRequest) throws InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException This is a variant of
listServers(software.amazon.awssdk.services.transfer.model.ListServersRequest)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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListServersIterable responses = client.listServersPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListServersIterable responses = client.listServersPaginator(request); for (software.amazon.awssdk.services.transfer.model.ListServersResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListServersIterable responses = client.listServersPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listServers(software.amazon.awssdk.services.transfer.model.ListServersRequest)operation.- Parameters:
listServersRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listServersPaginator
default ListServersIterable listServersPaginator(Consumer<ListServersRequest.Builder> listServersRequest) throws InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException This is a variant of
listServers(software.amazon.awssdk.services.transfer.model.ListServersRequest)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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListServersIterable responses = client.listServersPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListServersIterable responses = client.listServersPaginator(request); for (software.amazon.awssdk.services.transfer.model.ListServersResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListServersIterable responses = client.listServersPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listServers(software.amazon.awssdk.services.transfer.model.ListServersRequest)operation.
This is a convenience which creates an instance of the
ListServersRequest.Builderavoiding the need to create one manually viaListServersRequest.builder()- Parameters:
listServersRequest- AConsumerthat will call methods onListServersRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listTagsForResource
default ListTagsForResourceResponse listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) throws InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException Lists all of the tags associated with the Amazon Resource Name (ARN) that you specify. The resource can be a user, server, or role.
- Parameters:
listTagsForResourceRequest-- Returns:
- Result of the ListTagsForResource operation returned by the service.
- See Also:
-
listTagsForResource
default ListTagsForResourceResponse listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) throws InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException Lists all of the tags associated with the Amazon Resource Name (ARN) that you specify. The resource can be a user, server, or role.
This is a convenience which creates an instance of the
ListTagsForResourceRequest.Builderavoiding the need to create one manually viaListTagsForResourceRequest.builder()- Parameters:
listTagsForResourceRequest- AConsumerthat will call methods onListTagsForResourceRequest.Builderto create a request.- Returns:
- Result of the ListTagsForResource operation returned by the service.
- See Also:
-
listTagsForResourcePaginator
default ListTagsForResourceIterable listTagsForResourcePaginator(ListTagsForResourceRequest listTagsForResourceRequest) throws InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException This is a variant of
listTagsForResource(software.amazon.awssdk.services.transfer.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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListTagsForResourceIterable responses = client.listTagsForResourcePaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListTagsForResourceIterable responses = client .listTagsForResourcePaginator(request); for (software.amazon.awssdk.services.transfer.model.ListTagsForResourceResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListTagsForResourceIterable responses = client.listTagsForResourcePaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listTagsForResource(software.amazon.awssdk.services.transfer.model.ListTagsForResourceRequest)operation.- Parameters:
listTagsForResourceRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listTagsForResourcePaginator
default ListTagsForResourceIterable listTagsForResourcePaginator(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) throws InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException This is a variant of
listTagsForResource(software.amazon.awssdk.services.transfer.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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListTagsForResourceIterable responses = client.listTagsForResourcePaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListTagsForResourceIterable responses = client .listTagsForResourcePaginator(request); for (software.amazon.awssdk.services.transfer.model.ListTagsForResourceResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListTagsForResourceIterable responses = client.listTagsForResourcePaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listTagsForResource(software.amazon.awssdk.services.transfer.model.ListTagsForResourceRequest)operation.
This is a convenience which creates an instance of the
ListTagsForResourceRequest.Builderavoiding the need to create one manually viaListTagsForResourceRequest.builder()- Parameters:
listTagsForResourceRequest- AConsumerthat will call methods onListTagsForResourceRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listUsers
default ListUsersResponse listUsers(ListUsersRequest listUsersRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException Lists the users for a file transfer protocol-enabled server that you specify by passing the
ServerIdparameter.- Parameters:
listUsersRequest-- Returns:
- Result of the ListUsers operation returned by the service.
- See Also:
-
listUsers
default ListUsersResponse listUsers(Consumer<ListUsersRequest.Builder> listUsersRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException Lists the users for a file transfer protocol-enabled server that you specify by passing the
ServerIdparameter.
This is a convenience which creates an instance of the
ListUsersRequest.Builderavoiding the need to create one manually viaListUsersRequest.builder()- Parameters:
listUsersRequest- AConsumerthat will call methods onListUsersRequest.Builderto create a request.- Returns:
- Result of the ListUsers operation returned by the service.
- See Also:
-
listUsersPaginator
default ListUsersIterable listUsersPaginator(ListUsersRequest listUsersRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException This is a variant of
listUsers(software.amazon.awssdk.services.transfer.model.ListUsersRequest)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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListUsersIterable responses = client.listUsersPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListUsersIterable responses = client.listUsersPaginator(request); for (software.amazon.awssdk.services.transfer.model.ListUsersResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListUsersIterable responses = client.listUsersPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listUsers(software.amazon.awssdk.services.transfer.model.ListUsersRequest)operation.- Parameters:
listUsersRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listUsersPaginator
default ListUsersIterable listUsersPaginator(Consumer<ListUsersRequest.Builder> listUsersRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException This is a variant of
listUsers(software.amazon.awssdk.services.transfer.model.ListUsersRequest)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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListUsersIterable responses = client.listUsersPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListUsersIterable responses = client.listUsersPaginator(request); for (software.amazon.awssdk.services.transfer.model.ListUsersResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListUsersIterable responses = client.listUsersPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listUsers(software.amazon.awssdk.services.transfer.model.ListUsersRequest)operation.
This is a convenience which creates an instance of the
ListUsersRequest.Builderavoiding the need to create one manually viaListUsersRequest.builder()- Parameters:
listUsersRequest- AConsumerthat will call methods onListUsersRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listWorkflows
default ListWorkflowsResponse listWorkflows(ListWorkflowsRequest listWorkflowsRequest) throws InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException Lists all workflows associated with your Amazon Web Services account for your current region.
- Parameters:
listWorkflowsRequest-- Returns:
- Result of the ListWorkflows operation returned by the service.
- See Also:
-
listWorkflows
default ListWorkflowsResponse listWorkflows(Consumer<ListWorkflowsRequest.Builder> listWorkflowsRequest) throws InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException Lists all workflows associated with your Amazon Web Services account for your current region.
This is a convenience which creates an instance of the
ListWorkflowsRequest.Builderavoiding the need to create one manually viaListWorkflowsRequest.builder()- Parameters:
listWorkflowsRequest- AConsumerthat will call methods onListWorkflowsRequest.Builderto create a request.- Returns:
- Result of the ListWorkflows operation returned by the service.
- See Also:
-
listWorkflowsPaginator
default ListWorkflowsIterable listWorkflowsPaginator(ListWorkflowsRequest listWorkflowsRequest) throws InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException This is a variant of
listWorkflows(software.amazon.awssdk.services.transfer.model.ListWorkflowsRequest)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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListWorkflowsIterable responses = client.listWorkflowsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListWorkflowsIterable responses = client.listWorkflowsPaginator(request); for (software.amazon.awssdk.services.transfer.model.ListWorkflowsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListWorkflowsIterable responses = client.listWorkflowsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listWorkflows(software.amazon.awssdk.services.transfer.model.ListWorkflowsRequest)operation.- Parameters:
listWorkflowsRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listWorkflowsPaginator
default ListWorkflowsIterable listWorkflowsPaginator(Consumer<ListWorkflowsRequest.Builder> listWorkflowsRequest) throws InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, InvalidNextTokenException, AwsServiceException, SdkClientException, TransferException This is a variant of
listWorkflows(software.amazon.awssdk.services.transfer.model.ListWorkflowsRequest)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
2) Using For loopsoftware.amazon.awssdk.services.transfer.paginators.ListWorkflowsIterable responses = client.listWorkflowsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.transfer.paginators.ListWorkflowsIterable responses = client.listWorkflowsPaginator(request); for (software.amazon.awssdk.services.transfer.model.ListWorkflowsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.transfer.paginators.ListWorkflowsIterable responses = client.listWorkflowsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listWorkflows(software.amazon.awssdk.services.transfer.model.ListWorkflowsRequest)operation.
This is a convenience which creates an instance of the
ListWorkflowsRequest.Builderavoiding the need to create one manually viaListWorkflowsRequest.builder()- Parameters:
listWorkflowsRequest- AConsumerthat will call methods onListWorkflowsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
sendWorkflowStepState
default SendWorkflowStepStateResponse sendWorkflowStepState(SendWorkflowStepStateRequest sendWorkflowStepStateRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, AccessDeniedException, AwsServiceException, SdkClientException, TransferException Sends a callback for asynchronous custom steps.
The
ExecutionId,WorkflowId, andTokenare passed to the target resource during execution of a custom step of a workflow. You must include those with their callback as well as providing a status.- Parameters:
sendWorkflowStepStateRequest-- Returns:
- Result of the SendWorkflowStepState operation returned by the service.
- See Also:
-
sendWorkflowStepState
default SendWorkflowStepStateResponse sendWorkflowStepState(Consumer<SendWorkflowStepStateRequest.Builder> sendWorkflowStepStateRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, AccessDeniedException, AwsServiceException, SdkClientException, TransferException Sends a callback for asynchronous custom steps.
The
ExecutionId,WorkflowId, andTokenare passed to the target resource during execution of a custom step of a workflow. You must include those with their callback as well as providing a status.
This is a convenience which creates an instance of the
SendWorkflowStepStateRequest.Builderavoiding the need to create one manually viaSendWorkflowStepStateRequest.builder()- Parameters:
sendWorkflowStepStateRequest- AConsumerthat will call methods onSendWorkflowStepStateRequest.Builderto create a request.- Returns:
- Result of the SendWorkflowStepState operation returned by the service.
- See Also:
-
startDirectoryListing
default StartDirectoryListingResponse startDirectoryListing(StartDirectoryListingRequest startDirectoryListingRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Retrieves a list of the contents of a directory from a remote SFTP server. You specify the connector ID, the output path, and the remote directory path. You can also specify the optional
MaxItemsvalue to control the maximum number of items that are listed from the remote directory. This API returns a list of all files and directories in the remote directory (up to the maximum value), but does not return files or folders in sub-directories. That is, it only returns a list of files and directories one-level deep.After you receive the listing file, you can provide the files that you want to transfer to the
RetrieveFilePathsparameter of theStartFileTransferAPI call.The naming convention for the output file is
connector-ID-listing-ID.json. The output file contains the following information:-
filePath: the complete path of a remote file, relative to the directory of the listing request for your SFTP connector on the remote server. -
modifiedTimestamp: the last time the file was modified, in UTC time format. This field is optional. If the remote file attributes don't contain a timestamp, it is omitted from the file listing. -
size: the size of the file, in bytes. This field is optional. If the remote file attributes don't contain a file size, it is omitted from the file listing. -
path: the complete path of a remote directory, relative to the directory of the listing request for your SFTP connector on the remote server. -
truncated: a flag indicating whether the list output contains all of the items contained in the remote directory or not. If yourTruncatedoutput value is true, you can increase the value provided in the optionalmax-itemsinput attribute to be able to list more items (up to the maximum allowed list size of 10,000 items).
- Parameters:
startDirectoryListingRequest-- Returns:
- Result of the StartDirectoryListing operation returned by the service.
- See Also:
-
-
startDirectoryListing
default StartDirectoryListingResponse startDirectoryListing(Consumer<StartDirectoryListingRequest.Builder> startDirectoryListingRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Retrieves a list of the contents of a directory from a remote SFTP server. You specify the connector ID, the output path, and the remote directory path. You can also specify the optional
MaxItemsvalue to control the maximum number of items that are listed from the remote directory. This API returns a list of all files and directories in the remote directory (up to the maximum value), but does not return files or folders in sub-directories. That is, it only returns a list of files and directories one-level deep.After you receive the listing file, you can provide the files that you want to transfer to the
RetrieveFilePathsparameter of theStartFileTransferAPI call.The naming convention for the output file is
connector-ID-listing-ID.json. The output file contains the following information:-
filePath: the complete path of a remote file, relative to the directory of the listing request for your SFTP connector on the remote server. -
modifiedTimestamp: the last time the file was modified, in UTC time format. This field is optional. If the remote file attributes don't contain a timestamp, it is omitted from the file listing. -
size: the size of the file, in bytes. This field is optional. If the remote file attributes don't contain a file size, it is omitted from the file listing. -
path: the complete path of a remote directory, relative to the directory of the listing request for your SFTP connector on the remote server. -
truncated: a flag indicating whether the list output contains all of the items contained in the remote directory or not. If yourTruncatedoutput value is true, you can increase the value provided in the optionalmax-itemsinput attribute to be able to list more items (up to the maximum allowed list size of 10,000 items).
This is a convenience which creates an instance of the
StartDirectoryListingRequest.Builderavoiding the need to create one manually viaStartDirectoryListingRequest.builder()- Parameters:
startDirectoryListingRequest- AConsumerthat will call methods onStartDirectoryListingRequest.Builderto create a request.- Returns:
- Result of the StartDirectoryListing operation returned by the service.
- See Also:
-
-
startFileTransfer
default StartFileTransferResponse startFileTransfer(StartFileTransferRequest startFileTransferRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Begins a file transfer between local Amazon Web Services storage and a remote AS2 or SFTP server.
-
For an AS2 connector, you specify the
ConnectorIdand one or moreSendFilePathsto identify the files you want to transfer. -
For an SFTP connector, the file transfer can be either outbound or inbound. In both cases, you specify the
ConnectorId. Depending on the direction of the transfer, you also specify the following items:-
If you are transferring file from a partner's SFTP server to Amazon Web Services storage, you specify one or more
RetrieveFilePathsto identify the files you want to transfer, and aLocalDirectoryPathto specify the destination folder. -
If you are transferring file to a partner's SFTP server from Amazon Web Services storage, you specify one or more
SendFilePathsto identify the files you want to transfer, and aRemoteDirectoryPathto specify the destination folder.
-
- Parameters:
startFileTransferRequest-- Returns:
- Result of the StartFileTransfer operation returned by the service.
- See Also:
-
-
startFileTransfer
default StartFileTransferResponse startFileTransfer(Consumer<StartFileTransferRequest.Builder> startFileTransferRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Begins a file transfer between local Amazon Web Services storage and a remote AS2 or SFTP server.
-
For an AS2 connector, you specify the
ConnectorIdand one or moreSendFilePathsto identify the files you want to transfer. -
For an SFTP connector, the file transfer can be either outbound or inbound. In both cases, you specify the
ConnectorId. Depending on the direction of the transfer, you also specify the following items:-
If you are transferring file from a partner's SFTP server to Amazon Web Services storage, you specify one or more
RetrieveFilePathsto identify the files you want to transfer, and aLocalDirectoryPathto specify the destination folder. -
If you are transferring file to a partner's SFTP server from Amazon Web Services storage, you specify one or more
SendFilePathsto identify the files you want to transfer, and aRemoteDirectoryPathto specify the destination folder.
-
This is a convenience which creates an instance of the
StartFileTransferRequest.Builderavoiding the need to create one manually viaStartFileTransferRequest.builder()- Parameters:
startFileTransferRequest- AConsumerthat will call methods onStartFileTransferRequest.Builderto create a request.- Returns:
- Result of the StartFileTransfer operation returned by the service.
- See Also:
-
-
startServer
default StartServerResponse startServer(StartServerRequest startServerRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Changes the state of a file transfer protocol-enabled server from
OFFLINEtoONLINE. It has no impact on a server that is alreadyONLINE. AnONLINEserver can accept and process file transfer jobs.The state of
STARTINGindicates that the server is in an intermediate state, either not fully able to respond, or not fully online. The values ofSTART_FAILEDcan indicate an error condition.No response is returned from this call.
- Parameters:
startServerRequest-- Returns:
- Result of the StartServer operation returned by the service.
- See Also:
-
startServer
default StartServerResponse startServer(Consumer<StartServerRequest.Builder> startServerRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Changes the state of a file transfer protocol-enabled server from
OFFLINEtoONLINE. It has no impact on a server that is alreadyONLINE. AnONLINEserver can accept and process file transfer jobs.The state of
STARTINGindicates that the server is in an intermediate state, either not fully able to respond, or not fully online. The values ofSTART_FAILEDcan indicate an error condition.No response is returned from this call.
This is a convenience which creates an instance of the
StartServerRequest.Builderavoiding the need to create one manually viaStartServerRequest.builder()- Parameters:
startServerRequest- AConsumerthat will call methods onStartServerRequest.Builderto create a request.- Returns:
- Result of the StartServer operation returned by the service.
- See Also:
-
stopServer
default StopServerResponse stopServer(StopServerRequest stopServerRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Changes the state of a file transfer protocol-enabled server from
ONLINEtoOFFLINE. AnOFFLINEserver cannot accept and process file transfer jobs. Information tied to your server, such as server and user properties, are not affected by stopping your server.Stopping the server does not reduce or impact your file transfer protocol endpoint billing; you must delete the server to stop being billed.
The state of
STOPPINGindicates that the server is in an intermediate state, either not fully able to respond, or not fully offline. The values ofSTOP_FAILEDcan indicate an error condition.No response is returned from this call.
- Parameters:
stopServerRequest-- Returns:
- Result of the StopServer operation returned by the service.
- See Also:
-
stopServer
default StopServerResponse stopServer(Consumer<StopServerRequest.Builder> stopServerRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Changes the state of a file transfer protocol-enabled server from
ONLINEtoOFFLINE. AnOFFLINEserver cannot accept and process file transfer jobs. Information tied to your server, such as server and user properties, are not affected by stopping your server.Stopping the server does not reduce or impact your file transfer protocol endpoint billing; you must delete the server to stop being billed.
The state of
STOPPINGindicates that the server is in an intermediate state, either not fully able to respond, or not fully offline. The values ofSTOP_FAILEDcan indicate an error condition.No response is returned from this call.
This is a convenience which creates an instance of the
StopServerRequest.Builderavoiding the need to create one manually viaStopServerRequest.builder()- Parameters:
stopServerRequest- AConsumerthat will call methods onStopServerRequest.Builderto create a request.- Returns:
- Result of the StopServer operation returned by the service.
- See Also:
-
tagResource
default TagResourceResponse tagResource(TagResourceRequest tagResourceRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Attaches a key-value pair to a resource, as identified by its Amazon Resource Name (ARN). Resources are users, servers, roles, and other entities.
There is no response returned from this call.
- Parameters:
tagResourceRequest-- Returns:
- Result of the TagResource operation returned by the service.
- See Also:
-
tagResource
default TagResourceResponse tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Attaches a key-value pair to a resource, as identified by its Amazon Resource Name (ARN). Resources are users, servers, roles, and other entities.
There is no response returned from this call.
This is a convenience which creates an instance of the
TagResourceRequest.Builderavoiding the need to create one manually viaTagResourceRequest.builder()- Parameters:
tagResourceRequest- AConsumerthat will call methods onTagResourceRequest.Builderto create a request.- Returns:
- Result of the TagResource operation returned by the service.
- See Also:
-
testConnection
default TestConnectionResponse testConnection(TestConnectionRequest testConnectionRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Tests whether your SFTP connector is set up successfully. We highly recommend that you call this operation to test your ability to transfer files between local Amazon Web Services storage and a trading partner's SFTP server.
- Parameters:
testConnectionRequest-- Returns:
- Result of the TestConnection operation returned by the service.
- See Also:
-
testConnection
default TestConnectionResponse testConnection(Consumer<TestConnectionRequest.Builder> testConnectionRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Tests whether your SFTP connector is set up successfully. We highly recommend that you call this operation to test your ability to transfer files between local Amazon Web Services storage and a trading partner's SFTP server.
This is a convenience which creates an instance of the
TestConnectionRequest.Builderavoiding the need to create one manually viaTestConnectionRequest.builder()- Parameters:
testConnectionRequest- AConsumerthat will call methods onTestConnectionRequest.Builderto create a request.- Returns:
- Result of the TestConnection operation returned by the service.
- See Also:
-
testIdentityProvider
default TestIdentityProviderResponse testIdentityProvider(TestIdentityProviderRequest testIdentityProviderRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException If the
IdentityProviderTypeof a file transfer protocol-enabled server isAWS_DIRECTORY_SERVICEorAPI_Gateway, tests whether your identity provider is set up successfully. We highly recommend that you call this operation to test your authentication method as soon as you create your server. By doing so, you can troubleshoot issues with the identity provider integration to ensure that your users can successfully use the service.The
ServerIdandUserNameparameters are required. TheServerProtocol,SourceIp, andUserPasswordare all optional.Note the following:
-
You cannot use
TestIdentityProviderif theIdentityProviderTypeof your server isSERVICE_MANAGED. -
TestIdentityProviderdoes not work with keys: it only accepts passwords. -
TestIdentityProvidercan test the password operation for a custom Identity Provider that handles keys and passwords. -
If you provide any incorrect values for any parameters, the
Responsefield is empty. -
If you provide a server ID for a server that uses service-managed users, you get an error:
An error occurred (InvalidRequestException) when calling the TestIdentityProvider operation: s-server-ID not configured for external auth -
If you enter a Server ID for the
--server-idparameter that does not identify an actual Transfer server, you receive the following error:An error occurred (ResourceNotFoundException) when calling the TestIdentityProvider operation: Unknown server.It is possible your sever is in a different region. You can specify a region by adding the following:
--region region-code, such as--region us-east-2to specify a server in US East (Ohio).
- Parameters:
testIdentityProviderRequest-- Returns:
- Result of the TestIdentityProvider operation returned by the service.
- See Also:
-
-
testIdentityProvider
default TestIdentityProviderResponse testIdentityProvider(Consumer<TestIdentityProviderRequest.Builder> testIdentityProviderRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException If the
IdentityProviderTypeof a file transfer protocol-enabled server isAWS_DIRECTORY_SERVICEorAPI_Gateway, tests whether your identity provider is set up successfully. We highly recommend that you call this operation to test your authentication method as soon as you create your server. By doing so, you can troubleshoot issues with the identity provider integration to ensure that your users can successfully use the service.The
ServerIdandUserNameparameters are required. TheServerProtocol,SourceIp, andUserPasswordare all optional.Note the following:
-
You cannot use
TestIdentityProviderif theIdentityProviderTypeof your server isSERVICE_MANAGED. -
TestIdentityProviderdoes not work with keys: it only accepts passwords. -
TestIdentityProvidercan test the password operation for a custom Identity Provider that handles keys and passwords. -
If you provide any incorrect values for any parameters, the
Responsefield is empty. -
If you provide a server ID for a server that uses service-managed users, you get an error:
An error occurred (InvalidRequestException) when calling the TestIdentityProvider operation: s-server-ID not configured for external auth -
If you enter a Server ID for the
--server-idparameter that does not identify an actual Transfer server, you receive the following error:An error occurred (ResourceNotFoundException) when calling the TestIdentityProvider operation: Unknown server.It is possible your sever is in a different region. You can specify a region by adding the following:
--region region-code, such as--region us-east-2to specify a server in US East (Ohio).
This is a convenience which creates an instance of the
TestIdentityProviderRequest.Builderavoiding the need to create one manually viaTestIdentityProviderRequest.builder()- Parameters:
testIdentityProviderRequest- AConsumerthat will call methods onTestIdentityProviderRequest.Builderto create a request.- Returns:
- Result of the TestIdentityProvider operation returned by the service.
- See Also:
-
-
untagResource
default UntagResourceResponse untagResource(UntagResourceRequest untagResourceRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Detaches a key-value pair from a resource, as identified by its Amazon Resource Name (ARN). Resources are users, servers, roles, and other entities.
No response is returned from this call.
- Parameters:
untagResourceRequest-- Returns:
- Result of the UntagResource operation returned by the service.
- See Also:
-
untagResource
default UntagResourceResponse untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Detaches a key-value pair from a resource, as identified by its Amazon Resource Name (ARN). Resources are users, servers, roles, and other entities.
No response is returned from this call.
This is a convenience which creates an instance of the
UntagResourceRequest.Builderavoiding the need to create one manually viaUntagResourceRequest.builder()- Parameters:
untagResourceRequest- AConsumerthat will call methods onUntagResourceRequest.Builderto create a request.- Returns:
- Result of the UntagResource operation returned by the service.
- See Also:
-
updateAccess
default UpdateAccessResponse updateAccess(UpdateAccessRequest updateAccessRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, ResourceExistsException, AwsServiceException, SdkClientException, TransferException Allows you to update parameters for the access specified in the
ServerIDandExternalIDparameters.- Parameters:
updateAccessRequest-- Returns:
- Result of the UpdateAccess operation returned by the service.
- See Also:
-
updateAccess
default UpdateAccessResponse updateAccess(Consumer<UpdateAccessRequest.Builder> updateAccessRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, ResourceExistsException, AwsServiceException, SdkClientException, TransferException Allows you to update parameters for the access specified in the
ServerIDandExternalIDparameters.
This is a convenience which creates an instance of the
UpdateAccessRequest.Builderavoiding the need to create one manually viaUpdateAccessRequest.builder()- Parameters:
updateAccessRequest- AConsumerthat will call methods onUpdateAccessRequest.Builderto create a request.- Returns:
- Result of the UpdateAccess operation returned by the service.
- See Also:
-
updateAgreement
default UpdateAgreementResponse updateAgreement(UpdateAgreementRequest updateAgreementRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, ResourceExistsException, AwsServiceException, SdkClientException, TransferException Updates some of the parameters for an existing agreement. Provide the
AgreementIdand theServerIdfor the agreement that you want to update, along with the new values for the parameters to update.- Parameters:
updateAgreementRequest-- Returns:
- Result of the UpdateAgreement operation returned by the service.
- See Also:
-
updateAgreement
default UpdateAgreementResponse updateAgreement(Consumer<UpdateAgreementRequest.Builder> updateAgreementRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, ResourceExistsException, AwsServiceException, SdkClientException, TransferException Updates some of the parameters for an existing agreement. Provide the
AgreementIdand theServerIdfor the agreement that you want to update, along with the new values for the parameters to update.
This is a convenience which creates an instance of the
UpdateAgreementRequest.Builderavoiding the need to create one manually viaUpdateAgreementRequest.builder()- Parameters:
updateAgreementRequest- AConsumerthat will call methods onUpdateAgreementRequest.Builderto create a request.- Returns:
- Result of the UpdateAgreement operation returned by the service.
- See Also:
-
updateCertificate
default UpdateCertificateResponse updateCertificate(UpdateCertificateRequest updateCertificateRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Updates the active and inactive dates for a certificate.
- Parameters:
updateCertificateRequest-- Returns:
- Result of the UpdateCertificate operation returned by the service.
- See Also:
-
updateCertificate
default UpdateCertificateResponse updateCertificate(Consumer<UpdateCertificateRequest.Builder> updateCertificateRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Updates the active and inactive dates for a certificate.
This is a convenience which creates an instance of the
UpdateCertificateRequest.Builderavoiding the need to create one manually viaUpdateCertificateRequest.builder()- Parameters:
updateCertificateRequest- AConsumerthat will call methods onUpdateCertificateRequest.Builderto create a request.- Returns:
- Result of the UpdateCertificate operation returned by the service.
- See Also:
-
updateConnector
default UpdateConnectorResponse updateConnector(UpdateConnectorRequest updateConnectorRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, ResourceExistsException, AwsServiceException, SdkClientException, TransferException Updates some of the parameters for an existing connector. Provide the
ConnectorIdfor the connector that you want to update, along with the new values for the parameters to update.- Parameters:
updateConnectorRequest-- Returns:
- Result of the UpdateConnector operation returned by the service.
- See Also:
-
updateConnector
default UpdateConnectorResponse updateConnector(Consumer<UpdateConnectorRequest.Builder> updateConnectorRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, ResourceExistsException, AwsServiceException, SdkClientException, TransferException Updates some of the parameters for an existing connector. Provide the
ConnectorIdfor the connector that you want to update, along with the new values for the parameters to update.
This is a convenience which creates an instance of the
UpdateConnectorRequest.Builderavoiding the need to create one manually viaUpdateConnectorRequest.builder()- Parameters:
updateConnectorRequest- AConsumerthat will call methods onUpdateConnectorRequest.Builderto create a request.- Returns:
- Result of the UpdateConnector operation returned by the service.
- See Also:
-
updateHostKey
default UpdateHostKeyResponse updateHostKey(UpdateHostKeyRequest updateHostKeyRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Updates the description for the host key that's specified by the
ServerIdandHostKeyIdparameters.- Parameters:
updateHostKeyRequest-- Returns:
- Result of the UpdateHostKey operation returned by the service.
- See Also:
-
updateHostKey
default UpdateHostKeyResponse updateHostKey(Consumer<UpdateHostKeyRequest.Builder> updateHostKeyRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Updates the description for the host key that's specified by the
ServerIdandHostKeyIdparameters.
This is a convenience which creates an instance of the
UpdateHostKeyRequest.Builderavoiding the need to create one manually viaUpdateHostKeyRequest.builder()- Parameters:
updateHostKeyRequest- AConsumerthat will call methods onUpdateHostKeyRequest.Builderto create a request.- Returns:
- Result of the UpdateHostKey operation returned by the service.
- See Also:
-
updateProfile
default UpdateProfileResponse updateProfile(UpdateProfileRequest updateProfileRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Updates some of the parameters for an existing profile. Provide the
ProfileIdfor the profile that you want to update, along with the new values for the parameters to update.- Parameters:
updateProfileRequest-- Returns:
- Result of the UpdateProfile operation returned by the service.
- See Also:
-
updateProfile
default UpdateProfileResponse updateProfile(Consumer<UpdateProfileRequest.Builder> updateProfileRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Updates some of the parameters for an existing profile. Provide the
ProfileIdfor the profile that you want to update, along with the new values for the parameters to update.
This is a convenience which creates an instance of the
UpdateProfileRequest.Builderavoiding the need to create one manually viaUpdateProfileRequest.builder()- Parameters:
updateProfileRequest- AConsumerthat will call methods onUpdateProfileRequest.Builderto create a request.- Returns:
- Result of the UpdateProfile operation returned by the service.
- See Also:
-
updateServer
default UpdateServerResponse updateServer(UpdateServerRequest updateServerRequest) throws ConflictException, ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, ResourceExistsException, AccessDeniedException, AwsServiceException, SdkClientException, TransferException Updates the file transfer protocol-enabled server's properties after that server has been created.
The
UpdateServercall returns theServerIdof the server you updated.- Parameters:
updateServerRequest-- Returns:
- Result of the UpdateServer operation returned by the service.
- See Also:
-
updateServer
default UpdateServerResponse updateServer(Consumer<UpdateServerRequest.Builder> updateServerRequest) throws ConflictException, ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, ResourceExistsException, AccessDeniedException, AwsServiceException, SdkClientException, TransferException Updates the file transfer protocol-enabled server's properties after that server has been created.
The
UpdateServercall returns theServerIdof the server you updated.
This is a convenience which creates an instance of the
UpdateServerRequest.Builderavoiding the need to create one manually viaUpdateServerRequest.builder()- Parameters:
updateServerRequest- AConsumerthat will call methods onUpdateServerRequest.Builderto create a request.- Returns:
- Result of the UpdateServer operation returned by the service.
- See Also:
-
updateUser
default UpdateUserResponse updateUser(UpdateUserRequest updateUserRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Assigns new properties to a user. Parameters you pass modify any or all of the following: the home directory, role, and policy for the
UserNameandServerIdyou specify.The response returns the
ServerIdand theUserNamefor the updated user.In the console, you can select Restricted when you create or update a user. This ensures that the user can't access anything outside of their home directory. The programmatic way to configure this behavior is to update the user. Set their
HomeDirectoryTypetoLOGICAL, and specifyHomeDirectoryMappingswithEntryas root (/) andTargetas their home directory.For example, if the user's home directory is
/test/admin-user, the following command updates the user so that their configuration in the console shows the Restricted flag as selected.aws transfer update-user --server-id <server-id> --user-name admin-user --home-directory-type LOGICAL --home-directory-mappings "[{\"Entry\":\"/\", \"Target\":\"/test/admin-user\"}]"- Parameters:
updateUserRequest-- Returns:
- Result of the UpdateUser operation returned by the service.
- See Also:
-
updateUser
default UpdateUserResponse updateUser(Consumer<UpdateUserRequest.Builder> updateUserRequest) throws ResourceNotFoundException, InvalidRequestException, ThrottlingException, InternalServiceErrorException, ServiceUnavailableException, AwsServiceException, SdkClientException, TransferException Assigns new properties to a user. Parameters you pass modify any or all of the following: the home directory, role, and policy for the
UserNameandServerIdyou specify.The response returns the
ServerIdand theUserNamefor the updated user.In the console, you can select Restricted when you create or update a user. This ensures that the user can't access anything outside of their home directory. The programmatic way to configure this behavior is to update the user. Set their
HomeDirectoryTypetoLOGICAL, and specifyHomeDirectoryMappingswithEntryas root (/) andTargetas their home directory.For example, if the user's home directory is
/test/admin-user, the following command updates the user so that their configuration in the console shows the Restricted flag as selected.aws transfer update-user --server-id <server-id> --user-name admin-user --home-directory-type LOGICAL --home-directory-mappings "[{\"Entry\":\"/\", \"Target\":\"/test/admin-user\"}]"
This is a convenience which creates an instance of the
UpdateUserRequest.Builderavoiding the need to create one manually viaUpdateUserRequest.builder()- Parameters:
updateUserRequest- AConsumerthat will call methods onUpdateUserRequest.Builderto create a request.- Returns:
- Result of the UpdateUser operation returned by the service.
- See Also:
-
waiter
Create an instance ofTransferWaiterusing this client.Waiters created via this method are managed by the SDK and resources will be released when the service client is closed.
- Returns:
- an instance of
TransferWaiter
-
create
Create aTransferClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider. -
builder
Create a builder that can be used to configure and create aTransferClient. -
serviceMetadata
-
serviceClientConfiguration
Description copied from interface:SdkClientThe SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration- Specified by:
serviceClientConfigurationin interfaceAwsClient- Specified by:
serviceClientConfigurationin interfaceSdkClient- Returns:
- SdkServiceClientConfiguration
-