List of fields in the Receive Storage Management Information (Amazon S3)

The fields in the input and output files of the Receive Storage Management Information for Amazon S3 are shown below.

Field list

Table 7.4 Fields in the Receive Storage Management Information

Field Name

Key

Value Format

Remarks

Array of records in the Receive Storage Management Information

rcv_info

array

 

ID

id

string

3 to 63 bytes

Bucket Name

bucket

string

3 to 255 bytes

Storage Timeout

timeout

number

Unit: seconds

Maximum number of parallels per transfer

parallels

number

2 to 999

Part Size

partsize

number

5 to 100

Region

default_region

string

1 to 255 bytes

Endpoint URL

endpoint_url

string

4 to 255 bytes

ACL that is applied to upload files acl string 1 to 255 bytes

Storage Authentication Information ID

auth_id

string

3 to 63 bytes

 

Explanation of each field

Array of records in the Receive Storage Management Information (rcv_info)

Array of records in the Receive Storage Management Information (mandatory)

This is the array of records in the Receive Storage Management Information.

In this array, specify the fields in the Receive Storage Management Information with a record for each ID.

ID (id)

ID (mandatory)

This field indicates the Receive Storage Management Information ID.

Specify from 3 to 63 bytes of ASCII printable characters.

If you include single-byte spaces, "/", or "*", an error occurs.

= Remarks =

We recommend that you specify the bucket name for the Receive Storage Management Information ID. The Receive Storage Management Information IDs (bucket names) that you specified for File Name in the Receive Management Information are output in the Receive Log.

Bucket Name (bucket)

Bucket name (optional)

This field indicates the bucket name of the upload destination for the transfer target file.

When you import the management information, we recommend that you specify the bucket name as the Receive Storage Management Information ID by using ID, not by using Bucket Name. Use this field to configure separate transfer settings for the same bucket name.

Specify from 3 to 255 bytes of ASCII printable characters.

When you omit specification of this option, the value "Use the default value." is set. In this case, the Storage Management Information ID that has been specified with ID is used for the bucket name during transfer.

When you use an access point, specify either of the following values:

  • Amazon Resource Name (ARN) of the access point

  • Alias of the access point

When you export the management information, this value is output if it is registered.

If the value is not registered, nothing is output.

Storage Timeout (timeout)

Storage timeout (seconds) (optional)

This field indicates the time until a timeout for an HTTP request occurs.

When you import the management information, specify from "10" to "259200", or "999999". When you specify "999999", waiting time is infinite.

When you omit specification of this option, the value "Use the default value." is set. In this case, the value set in the default information is used during transfer.

When you export the management information, this value is output if it is registered.

If the value is not registered, nothing is output.

Maximum number of parallels per transfer (parallels)

Maximum number of parallels per transfer (optional)

This field indicates the maximum number of parallel uploads per transfer.

When you import the management information, specify from "2" to "999".

When you omit specification of this option, the value "Use the default value." is set. In this case, the value set in the default information is used during transfer.

When you export the management information, this value is output if it is registered.

If the value is not registered, nothing is output.

= Remarks =

For Maximum number of parallels per transfer, even if you set a value larger than the total number of parallel uploads set in Cloud Storage System Environment Settings, this total number of parallel uploads prevails as the limit.

Specify a value smaller than the total number of parallel uploads.

Part Size (partsize)

Part size (MB) (optional)

This field indicates the part size for parallel uploads executed at one time.

When you import the management information, specify from "5" to "100".

When you omit specification of this option, the value "Use the default value." is set. In this case, the value set in the default information is used during transfer.

When you export the management information, this value is output if it is registered.

If the value is not registered, nothing is output.

Note

If you change the Part Size to a larger value than the value of "5" that is used when the field is not specified, the load on the system may be high depending on the operating environment. Be aware of this fact when you change the Part Size.

Region (default_region)

Region (optional)

This field indicates the region to use for AWS connection.

When you import the management information, specify 255 bytes or less of ASCII printable characters.

For available regions, refer to List of regions for which operation has been verified.

When you omit specification of this option, the value "Use the default value." is set. In this case, the value set in the default information is used during transfer.

When you export the management information, this value is output if it is registered.

If the value is not registered, nothing is output.

Endpoint URL (endpoint_url)

Endpoint URL (optional)

This field indicates the URL of an endpoint to which requests are sent for AWS connection.

When you import the management information, specify 255 bytes or less of ASCII printable characters.

Specify a URL starting with "http://" or "https://".

Example) https://bucket.vpce-1a2b3c4d-5e6f.s3.us-east-1.vpce.amazonaws.com

If you specify uppercase characters in the URL, those characters are converted to lowercase characters when connecting to AWS.

If you specify "none", the standard S3 endpoint for AWS is used during transfer.

When you omit specification of this option, the value "Use the default value." is set. In this case, the value set in the default information is used during transfer.

When you export the management information, this value is output if it is registered.

If the value is not registered, nothing is output.

ACL that is applied to upload files (acl)

ACL that is applied to upload files (optional)

This field indicates the Access Control List (ACL) to control access to objects.

When you import the management information, specify from 1 to 255 bytes of ASCII printable characters.

When you omit specification of this option, the value "Use the default value." is set. In this case, the value set in the default information is used during transfer.

When you export the management information, this value is output if it is registered.

If the value is not registered, nothing is output.

Storage Authentication Information ID (auth_id)

Storage Authentication Information ID (optional)

This field indicates the ID of the Storage Authentication Information that you want to associate with the Receive Storage Management Information.

When you import the management information, specify from 3 to 63 bytes of ASCII printable characters.

If you include single-byte spaces, "/", or "*", an error occurs.

When you omit specification of this option, the value "Use the default value." is set. In this case, the value set in the default information is used during transfer.

When you export the management information, this value is output if it is registered.

If the value is not registered, nothing is output.