Messages and limitations of the Amazon S3 connector
Tutorials
For details about how to create a connection to Amazon S3, refer to the following tutorial:
Message code list of AMAZONS3 category
The following message codes correspond to errors that occur in Amazon S3 Connector.
This message code is output when an undefined error occurs.
|
Cause |
Solution |
|---|---|
|
An undefined error occurred. |
Check the error message or the help of the operation in which the error has occurred. |
Corresponding error
-
None
This message code is output when connection to Amazon S3 fails.
|
Cause |
Solution |
|---|---|
|
Access Key ID specified in the connection resource is incorrect. |
Check the connection resource settings. |
|
Secret Access Key specified in the connection resource is incorrect. |
Check the connection resource settings. |
Corresponding error
-
com.amazonaws.AmazonServiceException
-
com.amazonaws.services.s3.model.AmazonS3Exception
This message code is output when the settings for the Endpoint are incorrect.
|
Cause |
Solution |
|---|---|
|
Endpoint specified in the connection resource is incorrect. |
Check the connection resource settings. |
Corresponding error
-
com.amazonaws.SdkClientException
This message code is output when an attempt to delete the root folder by the Delete File/Folder operation has been made.
|
Cause |
Solution |
|---|---|
|
An attempt to delete the root folder by the Delete File/Folder operation has been made. |
If Delete folder is selected, specify a folder other than the root folder in Folder path. |
Corresponding error
-
java.lang.UnsupportedOperationException
Exception messages of AMAZONS3 category
|
Exception name |
Cause |
Solution |
|---|---|---|
|
com.amazonaws.SdkClientException Unable to execute HTTP request: <endpoint> |
Endpoint of the connection resource specified in Destination is incorrect. |
Check the settings for the connection resource specified in Destination. |
|
IllegalArgumentException Invalid input data: <message> The <message> is one of the following messages.
Bucket name is not specified. Remote path is not specified. File/folder type is not specified. File/folder type<value> is invalid. Element<element name> is incorrect. Storage Class<value> is invalid. |
The contents of the input data is incorrect. |
Check the contents of the input data. Check the schema. |
|
InvalidPropertyConfigurationException <Property name> is not specified. |
<Property name> isn't specified. |
Specify <property name>. |
|
Status Code: 403, AWS Request ID: XXXXXXXXXXXXXXXX, AWS Error Code: InvalidAccessKeyId, AWS Error Message: The AWS Access Key Id you provided does not exist in our records., S3 Extended Request ID: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
Access Key ID of the connection resource specified in Destination is incorrect. |
Check the settings for the connection resource specified in Destination. |
|
Status Code: 403, AWS Request ID: XXXXXXXXXXXXXXXX, AWS Error Code: SignatureDoesNotMatch, AWS Error Message: The request signature we calculated does not match the signature you provided. Check your key and signing method., S3 Extended Request ID: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
Secret Access Key of the connection resource specified in Destination is incorrect. |
Check the settings for the connection resource specified in Destination. |
|
InvalidPropertyConfigurationException Copy source file/folder name contains "/" |
Copy source file/folder name contains "/". |
In Copy source file/folder name, specify a file/folder name which doesn't contain "/". |
|
InvalidPropertyConfigurationException Copy destination file/folder name contains "/" |
Copy destination file/folder name contains "/". |
In Copy destination file/folder name, specify a file/folder name which doesn't contain "/". |
|
InvalidPropertyConfigurationException "/" is included in file/folder name. |
File/folder name contains "/". |
In File/folder name, specify a file/folder name which doesn't contain "/". |
|
InvalidPropertyConfigurationException Local file/directory name includes "/". |
Local file/directory name contains "/". |
In Local file/directory name, specify a file/folder name which doesn't contain "/". |
|
InvalidPropertyConfigurationException Specified public key is directory. |
A directory path is specified for Public Key. |
Specify a file path for Public Key. |
|
InvalidPropertyConfigurationException Public key is not set. |
Public Key isn't specified. |
Specify Public Key, or specify the Client side value to Encryption. |
|
InvalidPropertyConfigurationException Specified public key does not exist. |
The file path specified in Public Key doesn't exist. |
Specify an existing file path to Public Key. |
|
InvalidPropertyConfigurationException Specified secret key is directory. |
A directory path is specified for Secret Key. |
Specify a file path for Secret Key. |
|
InvalidPropertyConfigurationException Specified secret key does not exist. |
The file path specified in Secret Key doesn't exist. |
Specify an existing file path to Secret Key. |
|
java.lang.UnsupportedOperationException Root folder cannot be deleted. |
An attempt to delete the root folder has been made. |
If Delete folder is selected, specify a folder other than the root folder in Folder path. |
|
ResourceNotFoundException Resource definition could not be found. Name: [] |
Destination isn't specified. |
Specify Destination. |
|
ResourceNotFoundException Resource definition could not be found. Name: [<connection resource name>] |
The resource definition selected in Destination isn't found. |
Check the connection resource specified in Destination. |
Limitations of AMAZONS3 category
Notes
-
The behavior described in the help pages is subject to change depending on specification changes in the destination.
Specification limits
None.
Notes
-
HTTPS is used in communication between Amazon S3 and this connector.
-
When the settings of endpoint and the Region where the bucket exists is different, it takes time to propagate the bucket and file/folder state. Hence, the operation may fail to execute without getting the state of latest bucket and file/folder.
Specification limits
None.
Notes
-
HTTPS is used in communication between Amazon S3 and this connector.
-
When the settings of endpoint and the Region where the bucket exists is different, it takes time to propagate the bucket and file/folder state. Hence, the operation may fail to execute without getting the state of latest bucket and file/folder.
-
For Bucket name, if you specify a bucket in which a large number of files exist, it may take time to update the list in Folder path.
-
If an error that is unrelated to the connection (an error which isn't described in "Exception messages of AMAZONS3 category") occurs during execution, "Error" is set for the status attribute of the file element of the file or folder in which the error occurred, the result data is output, and the subsequent processing continues.
Specification limits
None.
Notes
-
HTTPS is used in communication between Amazon S3 and this connector.
-
When the settings of endpoint and the Region where the bucket exists is different, it takes time to propagate the bucket and file/folder state. Hence, the operation may fail to execute without getting the state of latest bucket and file/folder.
-
For Bucket name, if you specify a bucket in which a large number of files exist, it may take time to update the list in Folder path.
-
If an error that is unrelated to the connection (an error which isn't described in "Exception messages of AMAZONS3 category") occurs during execution, "Error" is set for the status attribute of the file element of the file or folder in which the error occurred, the result data is output, and the subsequent processing continues.
Specification limits
None.
Notes
-
HTTPS is used in communication between Amazon S3 and this connector.
-
When the settings of endpoint and the Region where the bucket exists is different, it takes time to propagate the bucket and file/folder state. Hence, the operation may fail to execute without getting the state of latest bucket and file/folder.
-
For Bucket name, if you specify a bucket in which a large number of files exist, it may take time to update the list in Folder path.
-
Region of bucket newly created in this operation changes according to the endpoint settings as follows.
Setting for Endpoint
Region of bucket
Remarks
Not set
US Standard
s3.amazonaws.com
US Standard
s3-us-west-1.amazonaws.com
US-West (Northern California)
s3-ap-southeast-1.amazonaws.com
Asia Pacific (Singapore)
-
If an error that is unrelated to the connection (an error which isn't described in "Exception messages of AMAZONS3 category") occurs during execution, "Error" is set for the status attribute of the file element of the file or folder in which the error occurred, the result data is output, and the subsequent processing continues.
-
Bucket names must follow the rules below.
-
It must begin with an alphanumeric character and can contain only alphabetic characters, numbers, periods (.), and hyphens (-).
-
It must not be in the format of an IP address (Ex: 192.168.5.4).
-
It must not contain an underscore (_).
-
Alphabetic characters must be lowercase.
-
The length must be from 3 through 63 characters.
-
It must not end with a hyphen (-).
-
It must not contain consecutive periods (..).
-
It must not contain an adjacent period and hyphen ("-." or ".-").
-
-
Due to the specifications of Amazon S3, when the length (number of bytes after converting to UTF-8 when it contains Japanese) of the file path (the remotepath attribute of the file element) of the file to be written exceeds 1025, the file can't be written.
-
Content-Type of the written file is automatically determined and set based on the extension.
Specification limits
-
You can't copy when the buckets specified in Copy source bucket name and Copy destination bucket name exist in different Regions.
-
You can't copy files and folders that use server-side encryption with encryption keys (SSE-C).
= Remarks =For details, refer to "Protecting Data Using Server-Side Encryption with Customer-Provided Encryption Keys (SSE-C)"(https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html).
Notes
-
HTTPS is used in communication between Amazon S3 and this connector.
-
When the settings of endpoint and the Region where the bucket exists is different, it takes time to propagate the bucket and file/folder state. Hence, the operation may fail to execute without getting the state of latest bucket and file/folder.
-
For Copy source bucket name and Copy destination bucket name, if you specify a bucket in which a large number of files exist, it may take time to update the list in Copy source folder path and Copy destination folder path.
-
Region of bucket newly created in this operation changes according to the endpoint settings as follows.
Setting for Endpoint
Region of bucket
Remarks
Not set
US Standard
s3.amazonaws.com
US Standard
s3-us-west-1.amazonaws.com
US-West (Northern California)
s3-ap-southeast-1.amazonaws.com
Asia Pacific (Singapore)
-
If an error that is unrelated to the connection (an error which isn't described in "Exception messages of AMAZONS3 category") occurs during execution, "Error" is set for the status attribute of the file element of the file or folder in which the error occurred, the result data is output, and the subsequent processing continues.
-
Bucket names must follow the rules below.
-
It must begin with an alphanumeric character and can contain only alphabetic characters, numbers, periods (.), and hyphens (-).
-
It must not be in the format of an IP address (Ex: 192.168.5.4).
-
It must not contain an underscore (_).
-
Alphabetic characters must be lowercase.
-
The length must be from 3 through 63 characters.
-
It must not end with a hyphen (-).
-
It must not contain consecutive periods (..).
-
It must not contain an adjacent period and hyphen ("-." or ".-").
-
-
Due to the specifications of Amazon S3, when the length (number of bytes after converting to UTF-8 when it contains Japanese) of the copy destination file path (the destination_remotepath attribute of the file element) exceeds 1025, the file can't be copied.
-
The number of folders whose status attribute of file element is "Virtual" is output as the number of virtual folders in the execution log.
Specification limits
None.
Notes
-
HTTPS is used in communication between Amazon S3 and this connector.
-
When the settings of endpoint and the Region where the bucket exists is different, it takes time to propagate the bucket and file/folder state. Hence, the operation may fail to execute without getting the state of latest bucket and file/folder.
-
For Bucket name, if you specify a bucket in which a large number of files exist, it may take time to update the list in Folder path.
-
If an error that is unrelated to the connection (an error which isn't described in "Exception messages of AMAZONS3 category") occurs during execution, "Error" is set for the status attribute of the file element of the file or folder in which the error occurred, the result data is output, and the subsequent processing continues.
Specification limits
None.
Notes
-
HTTPS is used in communication between Amazon S3 and this connector.
-
When the settings of endpoint and the Region where the bucket exists is different, it takes time to propagate the bucket and file/folder state. Hence, the operation may fail to execute without getting the state of latest bucket and file/folder.
-
If an error that is unrelated to the connection (an error which isn't described in "Exception messages of AMAZONS3 category") occurs during execution, "Error" is set for the status column of the file or folder in which the error occurred, the result data is output, and the subsequent processing continues.
Specification limits
None.
Notes
-
HTTPS is used in communication between Amazon S3 and this connector.
-
When the settings of endpoint and the Region where the bucket exists is different, it takes time to propagate the bucket and file/folder state. Hence, the operation may fail to execute without getting the state of latest bucket and file/folder.
-
Region of bucket newly created in this operation changes according to the endpoint settings as follows.
Setting for Endpoint
Region of bucket
Remarks
Not set
US Standard
s3.amazonaws.com
US Standard
s3-us-west-1.amazonaws.com
US-West (Northern California)
s3-ap-southeast-1.amazonaws.com
Asia Pacific (Singapore)
-
If an error that is unrelated to the connection (an error which isn't described in "Exception messages of AMAZONS3 category") occurs during execution, "Error" is set for the status attribute of the file element of the file or folder in which the error occurred, the result data is output, and the subsequent processing continues.
-
Bucket names must follow the rules below.
-
It must begin with an alphanumeric character and can contain only alphabetic characters, numbers, periods (.), and hyphens (-).
-
It must not be in the format of an IP address (Ex: 192.168.5.4).
-
It must not contain an underscore (_).
-
Alphabetic characters must be lowercase.
-
The length must be from 3 through 63 characters.
-
It must not end with a hyphen (-).
-
It must not contain consecutive periods (..).
-
It must not contain an adjacent period and hyphen ("-." or ".-").
-
-
Due to the specifications of Amazon S3, when the length (number of bytes after converting to UTF-8 when it contains Japanese) of the file path (the remotepath attribute of the file element) of the file to be written exceeds 1025, the file can't be written.