List of fields in the default Information for 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.5 Fields in the default Information for the Storage Management Information

Field Name

Key

Value Format

Remarks

Array of records in the Receive Storage Management Information

rcv_info

array

 

Default information

default

boolean

 

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.

Default information (default)

Default information (mandatory)

This field indicates whether it is the default information for the Receive Storage Management Information.

When you import the management information, specify "true".

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, a fixed value (300 seconds) 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, a fixed value (32) 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, a fixed value (5MB) 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 for the environment variable (AWS_DEFAULT_REGION) 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 standard S3 endpoint for AWS is used during transfer.

For standard S3 endpoints, refer to the documents provided by AWS.

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, an ACL is not 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 for the Storage Authentication 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.